Fallback MCP server
Commit 6. Okt. 2026Bietet deterministische Recovery- und Decision-Utilities für autonome Agenten, um Fehler zu diagnostizieren, Requests zu reparieren und Datenquellen zu finden.
Auch bekannt als baronsigma/fallback-agent-tools, fallback-agent-tools
- Stars
- 0
- Tools
- 4
- Downloads, 30 Tage
- —
- Neueste Version
- 0.1.0-beta.1
- Letzter Commit
- 6. Okt. 2026
- Lizenz
- MIT
Was ist Fallback MCP?
Bietet deterministische Recovery- und Decision-Utilities für autonome Agenten, um Fehler zu diagnostizieren, Requests zu reparieren und Datenquellen zu finden. Er stellt 4 Tools bereit, etwa source_route, error_route, request_repair.
Zusammenfassung generiert aus dem README des Projekts
Über Fallback MCP server
Fallback bietet eine Suite deterministischer Utilities, die darauf ausgelegt sind, autonomen Agenten bei Fehlern und Entscheidungspunkten zu helfen. Anstatt auf teure Reasoning-Loops zu setzen, wenn ein Agent feststeckt, bieten diese Tools kleine, spezialisierte Funktionen, um Fehler zu diagnostizieren oder Daten zu finden. Der Service ist als hosted MCP endpoint oder via HTTP API verfügbar und nutzt ein x402 V2 pay-per-call Modell auf der Base mainnet mit canonical USDC. Es sind keine Accounts oder API Keys erforderlich, da Nutzer die Zahlungen für jeden spezifischen Tool-Call freigeben.
Entwickler können spezifische Tools wie source_route nutzen, um maschinenlesbare Datenformate zu finden, error_route um fehlgeschlagene Requests zu klassifizieren, request_repair um basierend auf vorliegenden Informationen kleine Fixes vorzuschlagen, und stop_search um zu bestimmen, ob weitere Untersuchungen die Kosten wert sind. Das System ist auf Präzision ausgelegt und bietet begrenzte Aktionen, wie das Finden einer API oder eines Datasets aus einer bestimmten Domain. Jeder Tool-Call hat definierte Limits, wie zum Beispiel maximal 8 direkte HTTP Requests und eine Gesamtausführungszeit von 12 Sekunden pro Call.
Was du damit machen kannst
- 1Maschinenlesbare Datenquellen lokalisierenEin Agent kann den besten Weg identifizieren, um auf ein spezifisches Dataset im JSON- oder CSV-Format eines bekannten Publishers zuzugreifen.
- 2Request-Fehler diagnostizieren und recovernWenn ein API- oder Tool-Call fehlschlägt, kann der Agent den Fehler klassifizieren, um die nächste sichere Aktion zu bestimmen.
- 3Malformed Requests reparierenDer Agent kann minimale Änderungen an einem Request vorschlagen, um diesen mithilfe verfügbarer Informationen valide zu machen.
- 4Suchkosten optimierenEin Agent kann entscheiden, ob die Fortsetzung einer Suche basierend auf den aktuellen Erkenntnissen wirtschaftlich gerechtfertigt ist.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Fallback MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenFallback MCP in Claude Code installieren
$ claude mcp add --transport http fallback-agent-tools https://fallback.factrail.online/mcpFallback MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"fallback-agent-tools": {
"url": "https://fallback.factrail.online/mcp"
}
}
}Fallback MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"fallback-agent-tools": {
"type": "http",
"url": "https://fallback.factrail.online/mcp"
}
}
}Fallback MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"fallback-agent-tools","type":"http","url":"https://fallback.factrail.online/mcp"}'Fallback MCP in Codex installieren
$ codex mcp add fallback-agent-tools --url https://fallback.factrail.online/mcpFallback MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.fallback-agent-tools] url = "https://fallback.factrail.online/mcp"
Fallback MCP in Gemini CLI installieren
$ gemini mcp add -s user --transport http fallback-agent-tools https://fallback.factrail.online/mcpFallback MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"fallback-agent-tools": {
"url": "https://fallback.factrail.online/mcp",
"type": "http"
}
}
}Fallback MCP tools 4
Erkannt aus dem READMEsource_routeerror_routerequest_repairstop_search
| source_route | — | |
| error_route | — | |
| request_repair | — | |
| stop_search | — |
Automatisierte Checks
Geluften am 15. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarbaronsigma/fallback-agent-tools is public and reachablegithub.com/baronsigma/fallback-agent-tools ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-06github.com/baronsigma/fallback-agent-tools ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-Handshakeinitialize answered with protocol 2025-06-18 in 490 msBestanden
README
Auf GitHub ansehenFallback
______ _ _
| ____| | | |
| |__ __ _ | | |__ __ _ ___| | __
| __|/ _` || | '_ \ / _` |/ __| |/ /
| | | (_| || | |_) | (_| | (__| <
|_| \__,_||_|_.__/ \__,_|\___|_|\_\
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.
Fallback MCP Fragen
Wie füge ich Fallback MCP zu Claude Code hinzu?
Führe claude mcp add --transport http fallback-agent-tools https://fallback.factrail.online/mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Fallback MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet Fallback MCP?
Er stellt 4 Tools bereit, darunter source_route, error_route, request_repair, stop_search.
Was kann das source_route Tool?
Es hilft Agenten, wahrscheinliche autoritative oder maschinenlesbare Quellen wie APIs, OpenAPI-Specs oder Datasets zu finden, wenn der Publisher bekannt ist, aber der spezifische Datenpfad nicht.
Wie hilft das error_route Tool einem Agenten?
Es klassifiziert, warum ein Request fehlgeschlagen ist, und empfiehlt eine begrenzte nächste Aktion, um dem Agenten bei der Recovery zu helfen.
Beweist das stop_search Tool, dass Informationen nicht existieren?
Nein, das Tool entscheidet nur, ob weiteres Suchen die Kosten wert ist, aber es beweist niemals die universelle Abwesenheit von Informationen.
Wie wird die Bezahlung für diese Tools gehandhabt?
Der Service nutzt x402 V2 pay-per-call, wobei der Agent das Netzwerk, das Asset, den Betrag und den Empfänger freigibt, die in einem Payment Challenge angezeigt werden.