SwitchBord

网站 · 快速开始 · API · MCP 设置 · 自托管

---

Agent 现在可以通过 x402 和 MPP 自行支付 API 费用。付费端点有数万个，其中许多在任何时刻都可能无法使用、速度缓慢或价格过高。**SwitchBord 会告诉你的 Agent 应该调用哪些端点。**只需用日常语言描述任务，例如“搜索网页”或“ETH 价格”，即可获取当前可用、价格最低且速度最快的卖家；系统会在返回结果前即时检查，并提供备用选项。

免费且开源	无需注册、密钥或身份验证。代码采用 MIT 许可证，你可以阅读、运行和分叉。
绝不经手你的资金	你的 Agent 使用自己的钱包直接向卖家付款。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" } } }

**任何 Agent，粘贴一次即可。**将以下内容添加到 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.

正在构建自己的 Agent？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"

返回内容

针对“搜索网页”给出的实际答案，精简为两个候选项：

{
  "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 不会代你付款、持有资金，也不保证卖家可用。要调用付费卖家，你的 Agent 需要自备钱包和 x402 或 MPP 客户端，例如 Coinbase 的 @x402/fetch。每个候选卖家都会说明自己的收费方式：

• after_success（x402）：仅当卖家成功响应时才收费，因此调用失败后尝试备用卖家是安全的。
• 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：一个静态页面，无需构建步骤
scripts/	Vercel 构建和 API 契约检查
examples/	curl、Node 和 MCP 示例片段

## 贡献

欢迎提交问题和拉取请求。错误的排名、失效的卖家、新协议和文档修复都很有帮助。请先阅读 CONTRIBUTING.md；安全问题请参阅 SECURITY.md。变更内容：CHANGELOG.md。语言模型相关：llms.txt。隐私：PRIVACY.md。

许可证

MIT