Serveur MCP Fallback
Commit 6 oct. 2026Fournit des utilitaires de décision et de récupération déterministes pour permettre aux agents autonomes de diagnostiquer des échecs, de réparer des requêtes et de trouver des sources de données.
Aussi connu sous baronsigma/fallback-agent-tools, fallback-agent-tools
- Étoiles
- 0
- Outils
- 4
- Téléchargements, 30 jours
- —
- Dernière version
- 0.1.0-beta.1
- Dernier commit
- 6 oct. 2026
- Licence
- MIT
Qu'est-ce que Fallback MCP ?
Fournit des utilitaires de décision et de récupération déterministes pour permettre aux agents autonomes de diagnostiquer des échecs, de réparer des requêtes et de trouver des sources de données. Il expose 4 outils, comme source_route, error_route, request_repair.
Résumé généré à partir du README du projet
À propos du MCP server Fallback
Fallback propose une suite d'utilitaires déterministes conçus pour aider les agents autonomes à naviguer entre les échecs et les points de décision. Au lieu de s'appuyer sur des boucles de raisonnement coûteuses lorsqu'un agent est bloqué, ces outils offrent des fonctions spécialisées et légères pour diagnostiquer des erreurs ou trouver des données. Le service est disponible en tant que point de terminaison MCP hébergé ou via une API HTTP, utilisant un modèle pay-per-call x402 V2 sur le mainnet Base avec de l'USDC canonique. Aucun compte ni clé API n'est requis, car les utilisateurs approuvent les paiements pour chaque appel d'outil spécifique.
Les développeurs peuvent utiliser des outils spécifiques comme source_route pour trouver des formats de données lisibles par machine, error_route pour classifier les requêtes échouées, request_repair pour suggérer des corrections mineures basées sur des preuves, et stop_search pour déterminer si une investigation supplémentaire est rentable. Le système est conçu pour la précision, offrant des actions délimitées telles que la recherche d'une API ou d'un jeu de données provenant d'un domaine spécifique. Chaque appel d'outil possède des limites définies, comme un maximum de 8 requêtes HTTP directes et 12 secondes de temps d'exécution total par appel.
Ce que vous pouvez faire avec
- 1Localiser des sources de données lisibles par machineUn agent peut identifier la meilleure façon d'accéder à un jeu de données spécifique au format JSON ou CSV auprès d'un éditeur connu.
- 2Diagnostiquer et se rétablir des échecs de requêteLorsqu'un appel d'API ou d'outil échoue, l'agent peut classifier l'erreur pour déterminer la prochaine action sécurisée.
- 3Réparer des requêtes malforméesL'agent peut proposer des modifications minimales à une requête en utilisant les preuves disponibles pour la rendre valide.
- 4Optimiser les dépenses de rechercheUn agent peut décider si la poursuite d'une recherche est économiquement justifiée en fonction des preuves actuelles.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Fallback MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Fallback MCP dans Claude Code
$ claude mcp add --transport http fallback-agent-tools https://fallback.factrail.online/mcpInstaller Fallback MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"fallback-agent-tools": {
"url": "https://fallback.factrail.online/mcp"
}
}
}Installer Fallback MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"fallback-agent-tools": {
"type": "http",
"url": "https://fallback.factrail.online/mcp"
}
}
}Installer Fallback MCP dans VS Code CLI
$ code --add-mcp '{"name":"fallback-agent-tools","type":"http","url":"https://fallback.factrail.online/mcp"}'Installer Fallback MCP dans Codex
$ codex mcp add fallback-agent-tools --url https://fallback.factrail.online/mcpInstaller Fallback MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.fallback-agent-tools] url = "https://fallback.factrail.online/mcp"
Installer Fallback MCP dans Gemini CLI
$ gemini mcp add -s user --transport http fallback-agent-tools https://fallback.factrail.online/mcpInstaller Fallback MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"fallback-agent-tools": {
"url": "https://fallback.factrail.online/mcp",
"type": "http"
}
}
}Outils MCP Fallback 4
Détectés depuis le READMEsource_routeerror_routerequest_repairstop_search
| source_route | — | |
| error_route | — | |
| request_repair | — | |
| stop_search | — |
Vérifications automatisées
Exécuté le 15 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblebaronsigma/fallback-agent-tools is public and reachablegithub.com/baronsigma/fallback-agent-tools ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-10-06github.com/baronsigma/fallback-agent-tools ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNo tool named like delete, drop or execRéussi
- Le point de terminaison distant répond à la poignée de main MCPinitialize answered with protocol 2025-06-18 in 490 msRéussi
README
Voir sur GitHubFallback
______ _ _
| ____| | | |
| |__ __ _ | | |__ __ _ ___| | __
| __|/ _` || | '_ \ / _` |/ __| |/ /
| | | (_| || | |_) | (_| | (__| <
|_| \__,_||_|_.__/ \__,_|\___|_|\_\
find the route forward
Fallback
Tiny paid recovery and decision utilities for autonomous agents.
When an agent gets stuck, Fallback helps it find the next safe move without wasting a large reasoning loop.
source_route Where should I look? ($0.02)
error_route Why did this fail? ($0.002)
request_repair Can I safely fix the request? ($0.005)
stop_search Is another search worth it? ($0.003)
Use Fallback
Pay-per-call tools that help AI agents find sources, diagnose failures, repair requests, and decide when to stop searching. Fallback gives autonomous agents small, deterministic utilities for the moments where automation gets stuck: finding the right source, diagnosing a failed request, repairing a request from available evidence, and deciding whether another search or paid retrieval is worth the cost.
Hosted service
MCP endpoint: https://fallback.factrail.online/mcp\
HTTP API base: https://fallback.factrail.online\
Payment: x402 V2 pay-per-call. Check each live challenge for network, asset, amount, and recipient.
Agent skill: skill.md
OpenAPI: openapi.json
Network: Base mainnet, canonical USDC
Release: v0.1.0-beta.1
Tools
source_route($0.02): Where should I look? Find likely authoritative or machine-readable sources.error_route($0.002): Why did my call fail? Classify a failed request and recommend a bounded next action.request_repair($0.005): Can I safely fix the request? Propose the smallest change supported by caller-supplied evidence.stop_search($0.003): Is further searching worth it? Decide whether more bounded search effort is justified by the evidence and remaining cost.
These tools do not replace agent reasoning, and stop_search never proves universal absence.
When an agent should use this
Use source_route when an agent knows what it needs and which publisher (a domain or start URL), but not how to get it in machine-readable form: an API, OpenAPI spec, bulk download, dataset or feed.
- Good fit: "Get the latest population dataset from Eurostat", "Find a JSON/CSV route for this agency's statistics", before the agent starts browsing page by page.
- Not a fit: general web research, answering a factual question, or verifying a fact (for source-backed facts, see FACTRAIL MCP).
How to read the result:
status: routes_found: try routes in order.scoreis a deterministic ranking, not a probability or confidence.status: no_suitable_route_found: nothing suitable within the checked scope (seechecked.direct_probes). This is not evidence that no route exists. The agent should look elsewhere (another host, the publisher's open-data portal), not conclude "there is no API".- Always read
limitations. It says, for example, whether external search was unavailable or candidate inspection was capped.
Limits per call: at most 8 direct HTTP requests, 12 s total, 1 MiB per response, and at most 1 external search request. No LLM inference. The hosted beta currently runs deterministic discovery only (no search provider configured).
Access: hosted MCP https://fallback.factrail.online/mcp (Streamable HTTP) or the HTTP tool routes, x402 pay-per-call (each challenge declares its payment network and amount; no account or API key). To try it without payment, self-host with PAYMENT_MODE=disabled (see Local development). Machine-readable summary: llms.txt. More detail: Using Fallback with agents.
Fallback is publicly launched. See the current launch and distribution status, product rename impact audit, discovery/distribution readiness audit, and telemetry and 30-day KPI definitions.
When to use error_route
Use it after an HTTP, API, MCP, or tool request fails when the safe next action is unclear. It classifies supplied evidence and returns bounded retry guidance. Do not use it when recovery is already obvious or the task needs deeper domain reasoning; it does not execute requests or invent undocumented fixes.
Requirements
- Current Node.js LTS (Node 24 at scaffold creation; supported engine is Node 22+)
- npm
Local development
npm install
cp .env.example .env
npm run generate
npm run dev
The server exposes /, /healthz, /readyz, /catalog.json, /openapi.json, /llms.txt, /llms-full.txt, /skill.md, /.well-known/x402.json, /.well-known/mcp/server-card.json, and the Streamable HTTP MCP endpoint at /mcp. Both HTTP and MCP dispatch through the shared runtime handler registry. PAYMENT_MODE=disabled supports local development; paid deployments must explicitly select test or production and provide complete x402 configuration.
Verification
npm test
npm run typecheck
npm run lint
npm run benchmark:source-route
npm run benchmark:error-route
npm run verify:catalog
npm run release:check
30-second start
Connect an x402-compatible agent to https://fallback.factrail.online/mcp, call the matching tool after a concrete failure or search decision, and approve only the network, token, recipient, and amount shown by its payment challenge. HTTP clients can use POST /v1/tools/{tool_id} on the hosted origin. See skill.md for examples and schemas.
Architecture
src/core/registry.ts is the one canonical tool registry. Every discovery surface and distribution artifact is derived from it. Each tool gets a directory under src/tools/ with a contract and handler; future tool tests and fixtures belong alongside the matching contract test/fixture directories. HTTP and MCP adapters must call the same tool handler. Payment middleware and marketplace integrations stay outside tool logic.
The service supports x402 V2 per-call payment without accounts or API keys. The server only receives payment at X402_PAY_TO; no receiving wallet private key is required. Paid startup fails closed if the required network, receiving address, facilitator URL, or production URL is missing or invalid. See deployment and payment setup.
Example
{
"goal": "Download the latest population dataset",
"start_url": "https://ec.europa.eu/eurostat/",
"preferred_formats": ["csv", "json"]
}
Call POST /v1/tools/source_route with a goal and either start_url or domain. The result is limited to the checked scope; a missing result does not mean that no route exists. Direct site discovery runs without external search credentials. If Tavily or Brave is configured and direct discovery is insufficient, the tool can make at most one search request.
See PRODUCT, ARCHITECTURE, TOOL_ADMISSION, DISTRIBUTION, and RELEASE.
Related: FACTRAIL MCP
Fallback comes from the same author and design rule as FACTRAIL MCP: agent tools should report what they checked, not only what they found. FACTRAIL answers "what is established about this fact, and from which source?" by returning evidence envelopes with support levels, unresolved fields and receipts ("unknown is better than invented"). Fallback answers "where can I get this data?" ("absence is not proof of nonexistence"). The two are independent services with no code dependency, and you can use either one alone.
Questions sur Fallback MCP
Comment ajouter Fallback MCP à Claude Code ?
Exécutez claude mcp add --transport http fallback-agent-tools https://fallback.factrail.online/mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Fallback MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Quels outils Fallback MCP fournit-il ?
Il expose 4 outils, dont source_route, error_route, request_repair, stop_search.
Que peut faire l'outil source_route ?
Il aide les agents à trouver des sources probablement faisant autorité ou lisibles par machine, telles que des API, des spécifications OpenAPI ou des jeux de données, lorsqu'ils connaissent l'éditeur mais pas la route de données spécifique.
Comment l'outil error_route aide-t-il un agent ?
Il classifie la raison de l'échec d'une requête et recommande une action suivante délimitée pour aider l'agent à se rétablir.
L'outil stop_search prouve-t-il que l'information n'existe pas ?
Non, l'outil décide si la poursuite des recherches vaut le coût, mais il ne prouve jamais une absence universelle.
Comment le paiement est-il géré pour ces outils ?
Le service utilise le modèle pay-per-call x402 V2, où l'agent approuve le réseau, l'actif, le montant et le destinataire indiqués dans un défi de paiement.