x402 Router

x402 Router：適切な x402 エンドポイントを見つけて支払うための MCP サーバー＋無料 API

3,100 以上のサービスにまたがる 20,700 以上の稼働中の x402 従量課金エンドポイントを 3 時間ごとにプローブし、信頼性を 0～100 で評価します。 エージェントは、どの x402 API が稼働しているかを把握する必要はありません。ルーターに尋ねてください。

キーワード： x402、MCP、MCP サーバー、AI エージェント、エージェント決済、従量課金 API、USDC、Base、Solana、x402 ディスカバリー、x402 ルーター、x402 レジストリ、HTTP 402。

• 稼働中のルーター： https://router-production-ab89.up.railway.app（OpenAPI：[/openapi.json](https://router-production-ab89.up.railway.app/openapi.json) · x402 ディスカバリー：/.well-known/x402 · ヘルスチェック：/health）
• ダッシュボード／レジストリ： https://dashboard-production-4344.up.railway.app
• LLM 向け： https://dashboard-production-4344.up.railway.app/llms.txt

クイックスタート（MCP、30 秒）

サーバーは読み取り専用です。キーを保持せず、支払いも行いません。次の 4 つのツールを提供します： search_x402_endpoints、route_x402_request、get_registry_stats、get_paid_route_requirements

オプション A：uvx（クローン不要、PyPI も不要）

Claude Desktop（claude_desktop_config.json）または Cursor（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "x402-router": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/camerxnduff/x402-router-mcp#subdirectory=mcp-server", "x402-router-mcp"]
    }
  }
}

オプション B：Docker

{
  "mcpServers": {
    "x402-router": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/camerxnduff/x402-router-mcp:latest"]
    }
  }
}

または、自分でビルドするには、docker build -t x402-router-mcp . を実行し、イメージ名として x402-router-mcp を使用してください。

オプション C：ソースから

git clone https://github.com/camerxnduff/x402-router-mcp
cd x402-router-mcp/mcp-server
python3 -m venv .venv && . .venv/bin/activate
pip install -r requirements.txt
python test_client.py   # calls the live router, read-only

{"mcpServers":{"x402-router":{"command":"/abs/path/x402-router-mcp/mcp-server/.venv/bin/python","args":["/abs/path/x402-router-mcp/mcp-server/server.py"]}}}

Streamable HTTP：python server.py --http 8000 を実行すると、http://localhost:8000/mcp が提供されます。 環境変数による上書き：X402_ROUTER_URL、X402_DASHBOARD_URL。

インストールせずに試す（curl）

# best live Base endpoint for a category (free preview)
curl -s -X POST https://router-production-ab89.up.railway.app/route \
  -H 'content-type: application/json' -d '{"category":"Finance","chain":"Base"}'

# search the registry
curl -s 'https://dashboard-production-4344.up.railway.app/api/endpoints?q=weather&chain=Base&limit=5'

理由

何千もの x402 エンドポイントが存在しますが、その多くは停止していたり、設定に誤りがあったり、応答が遅かったりします。ルーターはすべてのエンドポイントをプローブし、402 の本文が有効か（バージョン、スキーム、ネットワーク、payTo、アセット、金額）を確認したうえで、稼働時間とレイテンシーに基づいて順位付けします。これにより、エージェントは価格が明確な、動作するエンドポイントを利用できます。

HTTP API

エンドポイント	説明
GET /api/endpoints?q=&chain=&category=&max_price=&min_score=&sort=&limit=（ダッシュボード）	稼働中のエンドポイントを検索し、最適なものから表示
GET /api/summary（ダッシュボード）	チェーン、カテゴリ、ソース別の件数
GET /api/registry（ダッシュボード）	レジストリ全体（gzip）
POST /route（ルーター）	最適な単一の候補を返す無料プレビュー
POST /route/paid（ルーター）	同じ結果を返す x402 有料版：Base で $0.01 USDC（Solana も利用可能）

使用例：examples/（curl、Python、TypeScript）。

支払い

/route/paid は x402 v2 に対応しています。まず Base USDC を使用し、フォールバックとして Solana USDC を使用します。決済は PayAI ファシリテーターを通じて行われます。ルーターはルーティングした呼び出しに 1% の手数料を加算します。MCP サーバー自体は支払いを行いません。支払いを行うのはエージェントの x402 クライアントです。

ライセンス

MIT