Fallback MCPサーバー
コミット 2026年10月6日自律型エージェントが失敗を診断し、リクエストを修正し、データソースを見つけるための、決定論的なリカバリおよび意思決定ユーティリティを提供します。
別名 baronsigma/fallback-agent-tools, fallback-agent-tools
- スター
- 0
- ツール
- 4
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.1.0-beta.1
- 最終コミット
- 2026年10月6日
- ライセンス
- MIT
Fallback MCPとは
自律型エージェントが失敗を診断し、リクエストを修正し、データソースを見つけるための、決定論的なリカバリおよび意思決定ユーティリティを提供します。 4個のツールを提供しており、source_route, error_route, request_repairなどがあります。
プロジェクトのREADMEから生成された概要
Fallback MCP server について
Fallback は、自律型エージェントが失敗や意思決定の局面を乗り切るために設計された、決定論的なユーティリティスイートを提供します。エージェントが行き詰まった際に、高コストな推論ループに頼るのではなく、これらのツールはエラーの診断やデータの検索を行うための、小さく特化した機能を提供します。本サービスは、Hosted MCP エンドポイントまたは HTTP API 経由で利用可能であり、Base mainnet 上で canonical USDC を使用した x402 V2 pay-per-call モデルを採用しています。ユーザーは各ツール呼び出しに対して支払いを承認するため、アカウント作成や API キーは不要です。
開発者は、マシンリーダブルなデータ形式を見つける source_route、失敗したリクエストを分類する error_route、証拠に基づいて軽微な修正を提案する request_repair、さらなる調査がコストに見合うかを判断する stop_search といった特定のツールを利用できます。このシステムは精度を重視して構築されており、特定のドメインから API やデータセットを見つけるといった、範囲の限定されたアクションを提供します。各ツール呼び出しには、1回につき最大 8 回の直接的な HTTP リクエスト、および合計実行時間 12 秒といった定義された制限があります。
できること
- 1マシンリーダブルなデータソースの特定エージェントは、既知の発行元から JSON または CSV 形式の特定のデータセットにアクセスするための最適な方法を特定できます。
- 2リクエスト失敗の診断と復旧API またはツール呼び出しが失敗した際、エージェントはエラーを分類して、次に取るべき安全なアクションを決定できます。
- 3不正なリクエストの修正エージェントは、利用可能な証拠を用いて、リクエストを有効にするための最小限の変更を提案できます。
- 4検索コストの最適化エージェントは、現在の証拠に基づいて、検索を継続することが経済的に正当であるかどうかを判断できます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Fallback MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにFallback MCPをインストール
$ claude mcp add --transport http fallback-agent-tools https://fallback.factrail.online/mcpCursorにFallback MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"fallback-agent-tools": {
"url": "https://fallback.factrail.online/mcp"
}
}
}VS CodeにFallback MCPをインストール
.vscode/mcp.json
{
"servers": {
"fallback-agent-tools": {
"type": "http",
"url": "https://fallback.factrail.online/mcp"
}
}
}VS Code CLIにFallback MCPをインストール
$ code --add-mcp '{"name":"fallback-agent-tools","type":"http","url":"https://fallback.factrail.online/mcp"}'CodexにFallback MCPをインストール
$ codex mcp add fallback-agent-tools --url https://fallback.factrail.online/mcpCodex config.tomlにFallback MCPをインストール
~/.codex/config.toml
[mcp_servers.fallback-agent-tools] url = "https://fallback.factrail.online/mcp"
Gemini CLIにFallback MCPをインストール
$ gemini mcp add -s user --transport http fallback-agent-tools https://fallback.factrail.online/mcpGemini settings.jsonにFallback MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"fallback-agent-tools": {
"url": "https://fallback.factrail.online/mcp",
"type": "http"
}
}
}Fallback MCPツール 4
READMEから検出source_routeerror_routerequest_repairstop_search
| source_route | — | |
| error_route | — | |
| request_repair | — | |
| stop_search | — |
自動チェック
実行日 2026年11月15日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能baronsigma/fallback-agent-tools is public and reachablegithub.com/baronsigma/fallback-agent-tools ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-10-06github.com/baronsigma/fallback-agent-tools ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない4 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされているNo tool named like delete, drop or exec合格
- リモートエンドポイントが MCP ハンドシェイクに応答initialize answered with protocol 2025-06-18 in 490 ms合格
README
GitHubで見るFallback
______ _ _
| ____| | | |
| |__ __ _ | | |__ __ _ ___| | __
| __|/ _` || | '_ \ / _` |/ __| |/ /
| | | (_| || | |_) | (_| | (__| <
|_| \__,_||_|_.__/ \__,_|\___|_|\_\
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のよくある質問
Fallback MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --transport http fallback-agent-tools https://fallback.factrail.online/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Fallback MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Fallback MCPが提供するツールは
4個のツールを提供しており、source_route, error_route, request_repair, stop_searchなどがあります。
source_route ツールで何ができますか?
発行元は分かっているものの、具体的なデータルートが不明な場合に、API、OpenAPI仕様、データセットなどの信頼できる、またはマシンリーダブルなソースをエージェントが見つけるのに役立ちます。
error_route ツールはエージェントをどのように支援しますか?
リクエストが失敗した理由を分類し、エージェントが復旧できるように、範囲の限定された次のアクションを推奨します。
stop_search ツールは、情報が存在しないことを証明しますか?
いいえ。このツールは、さらなる検索がコストに見合うかどうかを判断するものであり、情報の完全な不在を証明するものではありません。
これらのツールの支払いはどのように処理されますか?
このサービスは x402 V2 pay-per-call を使用しています。エージェントは、支払いチャレンジに表示されるネットワーク、アセット、金額、および受取人を承認します。