SwitchBord

ウェブサイト · クイックスタート · API · MCP のセットアップ · セルフホスト

---

エージェントは x402 と MPP を使って、自分で API の支払いができるようになりました。有料エンドポイントは数万件ありますが、いつ見ても、その多くがダウンしていたり、遅かったり、割高だったりします。SwitchBord は、エージェントに呼び出すエンドポイントを教えます。「ウェブを検索」や「ETH の価格」のように、タスクを平易な言葉でリクエストすると、回答の直前にリアルタイムで確認した、今まさに稼働中で最も安く、速い販売者と、バックアップが返されます。

無料でオープン	登録もキーも認証も不要です。MIT ライセンスのコードは、自由に読んで、実行して、フォークできます。
資金には一切触れません	エージェントは自身のウォレットで販売者に直接支払います。SwitchBord は呼び出す相手を案内するだけです。
ディレクトリではなく、リアルタイム	回答の直前に上位候補を無料でチェックするため、応答しない販売者は除外されます。
すべてのプロトコルに対応する共通の一覧	Coinbase Bazaar（x402）と mpp.dev（MPP）の全エンドポイントを毎日再構築し、互換性のある販売者をマーケットごとにグループ化します。

クイックスタート

Claude Code

claude mcp add --transport http switchbord https://switchbord.vercel.app/mcp

Cursor、Windsurf、Cline、および mcpServers ブロックを読み込めるすべてのクライアント：

{ "mcpServers": { "switchbord": { "type": "http", "url": "https://switchbord.vercel.app/mcp" } } }

どのエージェントでも、貼り付けるだけ。 これを CLAUDE.md、AGENTS.md、またはシステムプロンプトに追加してください（AGENTS-SNIPPET.md に詳細があります）：

Before you pay any x402 or MPP API, ask SwitchBord who to call (free, no key).
MCP: https://switchbord.vercel.app/mcp  or  GET https://switchbord.vercel.app/route?task=<what you need>&accepts=x402:base:usdc
Call the top result; if it fails, try the next.

独自のエージェントを構築していますか？integrations/switchbord-tool.mjs は、依存関係不要のツールで、OpenAI 形式と Anthropic 形式のスキーマに対応しています。

x402 または MPP で販売していますか？ README にライブバッジを表示できます：![SwitchBord](https://switchbord.vercel.app/badge/your-host.com.svg) (詳細)。

プラグイン、Gemini CLI、その他のクライアント

• Claude Code プラグイン： /plugin marketplace add 6ixtyy/switchbord を実行し、続けて /plugin install switchbord@switchbord を実行します
• Gemini CLI： gemini extensions install https://github.com/6ixtyy/switchbord を実行します
• Claude Desktop、VS Code など： MCP.md を参照してください

または、HTTP API を呼び出すだけです：

curl "https://switchbord.vercel.app/route?task=search%20the%20web&accepts=x402:base:usdc&max_price=0.05"

取得できる内容

「ウェブを検索」に対する実際の回答例です。候補を 2 件に絞っています：

{
  "mode": "market",
  "market": "web-search",
  "sellersMatched": 99,
  "candidates": [
    {
      "rank": 1,
      "service": "StableEnrich",
      "method": "POST",
      "url": "https://stableenrich.dev/api/exa/search",
      "priceUsd": 0.01,
      "pay": ["x402:base:usdc"],
      "charges": "after_success",          // x402: only charged when the seller answers OK
      "input": { "body": { "query": "…", "numResults": 10 } },
      "up": true, "ms": 264                // checked live just now
    },
    {
      "rank": 2,
      "url": "https://win.oneshotagent.com/v1/tools/search",
      "priceUsd": 0.001,
      "up": true, "ms": 217
      // …
    }
  ]
}

各フィールドの説明は API.md にあります。実行可能なスニペットは examples/ にあります。

仕組み

sequenceDiagram
    participant A as Your agent
    participant S as SwitchBord
    participant P as Sellers (x402 / MPP)
    A->>S: "search the web", accepts x402:base:usdc, max $0.05
    S->>P: free, unpaid check of the top matches
    P-->>S: payment terms + response time
    S-->>A: ranked sellers, plus backups
    A->>P: call the best one and pay it directly
    A-->>S: (optional) report how it went

1. インベントリ。 SwitchBord は毎日、Coinbase Bazaar と mpp.dev に掲載されているすべてのエンドポイントを取得し、統合したうえで、相互に代替可能な販売者をマーケットにグループ化します。
2. マッチング。 タスクをマーケットにマッチングします。適合するものがない場合でも、最も近い単一のエンドポイントを提示します。
3. 稼働確認。 上位候補に対して、支払い条件を読み取る未払いリクエストを送信します。停止中または設定に問題のある販売者は候補から除外されます。
4. 順位付け。 候補は稼働状況、速度、価格、実際の結果に基づいて並べられます。ロジックの全容は src/router.ts と src/health.ts にあります。

リファレンス

MCP ツール	用途
find_paid_endpoint	タスクに適した販売者を、代替候補とともに取得します。支払い可能な販売者だけを取得するには、accepts（例：["x402:base:usdc"]）を渡します。
list_markets	マーケットと、それぞれの販売者数を確認します。
report_result	任意：呼び出しの結果を報告します。報告すると、すべてのユーザー向けの順位付けが改善されます。

HTTP エンドポイント	返される内容
GET /route?task=…	稼働確認済みの、タスクに適した順位付き販売者
GET /markets	マーケットと販売者数
GET /endpoints/:id	インベントリから取得した単一のエンドポイント
POST /report	任意：呼び出しの結果
GET /healthz	インベントリのサイズと最終再構築日時
POST /mcp	MCP サーバー（ストリーミング可能な HTTP、ステートレス）

販売者への支払い

SwitchBord は、ユーザーに代わって支払いを行ったり、資金を預かったり、販売者を保証したりしません。有料の販売者を呼び出すには、エージェント自身のウォレットと、Coinbase の @x402/fetch などの x402 または MPP クライアントが必要です。各候補は課金方式を示します。

• after_success（x402）：販売者が OK と応答した場合にのみ課金されるため、失敗後に代替候補を試しても安全です。
• before_handler（MPP）：事前に課金されます。

自分で実行する

switchbord.vercel.app のホステッドサービスでは、このコードが実行されています。Node 22 を使って自分のコピーを実行できます。

git clone https://github.com/6ixtyy/switchbord && cd switchbord
npm ci
npm run inventory   # pull Bazaar + mpp.dev, merge and classify → data/inventory.json
npm start           # API and MCP on http://localhost:8402

設定なしですべて動作します。次の環境変数は任意です。

変数	用途	設定しない場合
PORT	ローカルサーバーのポート	8402
SB_REBUILD_MS	ローカルサーバーがインベントリを再構築する間隔	6 時間ごと
DATABASE_URL または POSTGRES_URL	すべての稼働確認結果を Postgres に保存します	data/checks.jsonl
BLOB_READ_WRITE_TOKEN	サーバーレス実行の間、状態を Vercel Blob に保持します	ローカルファイル
CRON_SECRET	スケジューラーがいつでも再構築ルートとサンプリングルートを実行できるようにします	誰でもアクセス可能、レート制限あり

Vercel にデプロイするには、リポジトリをインポートします。vercel.json がインベントリと関数をビルドし、毎日の再構築を実行します。

コードマップ

パス	内容
src/sources/	Coinbase Bazaar（x402）と mpp.dev（MPP）から掲載情報を取得します
src/inventory.ts, markets.ts, labels.ts	インベントリを統合し、マーケットにグループ化して、支払いオプションにラベルを付けます
src/health.ts	無料の稼働確認：販売者の 402 を読み取る未払いリクエスト
src/router.ts	マッチング、順位付け、代替候補
src/history.ts	確認履歴（Postgres またはローカルファイル）
src/app.ts, mcp-tools.ts	HTTP API とリモート MCP サーバー
src/server.ts, vercel.ts	ローカルサーバーと Vercel のエントリーポイント
site/	switchbord.xyz：ビルド手順が不要な静的ページ 1 枚
scripts/	Vercel のビルドと API 契約のチェック
examples/	curl、Node、MCP のサンプル

## 貢献

Issue やプルリクエストを歓迎します。不適切なランキング、活動を停止した販売者、新しいプロトコル、ドキュメントの修正など、どれも役立ちます。まず CONTRIBUTING.md をお読みください。セキュリティに関する問題については SECURITY.md をご覧ください。変更内容：CHANGELOG.md。言語モデル向け：llms.txt。プライバシー：PRIVACY.md。

ライセンス

MIT