PacketExchange

将 AI Agent 和 MCP 客户端连接到 PacketExchange 语音与短信交易市场。

PacketExchange 运行着一个托管的 Model Context Protocol 服务。客户端连接后，Agent 可以通过按名称调用工具来搜索交易市场、比较路由、进行电话验证、发送短信、拨打电话并跟踪通话，以及查看账户余额。

此代码库包含文档和可直接使用的客户端配置。无需构建或托管任何内容：服务由 PacketExchange 运行。

服务

端点	https://packetexchange.io/mcp/http
传输方式	Streamable HTTP，无状态（每个请求独立处理，无需维持会话）
旧版端点	https://packetexchange.io/mcp/sse，适用于仅支持旧版 HTTP+SSE 传输方式的客户端
工具	33 个：15 个交易市场和账户工具，18 个 Switch 工具
身份验证	Authorization: Bearer <API key> 标头，在客户端配置中设置。三个公共工具无需身份验证。

安装

选择你的客户端并复制其配置：

客户端	指南	配置
Claude Code	docs/setup/claude-code.md	configs/claude-code.json
Claude Desktop	docs/setup/claude-desktop.md	configs/claude-desktop.json
Cursor	docs/setup/cursor.md	configs/cursor.json
VS Code	docs/setup/vscode.md	configs/vscode.json
Codex	docs/setup/codex.md	configs/codex.toml
其他任何 MCP 客户端	docs/setup/other-clients.md	configs/generic-stdio.json

直接连接远程服务的客户端只需 URL 和标头。例如，读取支持环境变量展开的 mcpServers 文件的客户端：

{
  "mcpServers": {
    "packetexchange": {
      "type": "http",
      "url": "https://packetexchange.io/mcp/http",
      "headers": {
        "Authorization": "Bearer ${PACKETEXCHANGE_API_KEY}"
      }
    }
  }
}

只能启动本地命令的客户端可通过 mcp-remote 桥接程序连接到服务，该程序需要当前的 Node.js LTS 版本。

快速开始

连接到服务后，试试公共工具。这些工具无需密钥且不收费：

• “PacketExchange 上通往肯尼亚的五条最便宜语音路由是什么？请注明卖家所述的 ASR。”
• “总结一下 PacketExchange 当前的交易市场情况。”

更多示例请参阅 docs/example-prompts.md。

工具

分组	工具
发现（公开、免费）	wmmn_list_routes、wmmn_route_details、wmmn_market_summary
路由	wmmn_resolve_route、wmmn_purchase_route、wmmn_list_purchases
发送（计费）	wmmn_send_sms、wmmn_make_call、wmmn_get_call（免费）
验证	wmmn_send_voice_otp、wmmn_verify_start、wmmn_verify_check
账户	wmmn_get_balance、wmmn_list_transactions、wmmn_topup_x402
Switch（Switch 计划）	18 个 switch_* 工具，用于路由、客户、供应商、费率、开票和欺诈设置

wmmn_make_call 会异步拨打电话；接通后，可以播报文本、播放音频并收集按键数字。它会等待片刻以获取结果；如果通话仍在进行，之后可通过 wmmn_get_call 查看其状态、费用和收集到的数字。

完整参考（含参数、所需权限范围和费用说明）请见 docs/tools.md。

身份验证

使用账户工具需要拥有预付余额的 PacketExchange 账户：在 packetexchange.io 注册、充值，并在控制面板的 API keys 下创建 API 密钥。

• 密钥通过 Authorization: Bearer <key> 标头发送，并在 MCP 客户端中配置一次即可。服务器只接受通过此方式传递的密钥：没有工具会将密钥作为参数，因此密钥不会经过模型，也不会进入对话。
• 公开工具（wmmn_list_routes、wmmn_route_details、wmmn_market_summary）无需密钥即可使用。在未配置密钥的连接上调用其他任何工具，都会返回错误并提示你添加标头。
• 请使用专用密钥，并仅授予 Agent 所需的权限范围。使用账户工具前，请阅读 docs/security.md。

费用

会产生费用的工具会在说明中注明，让 Agent 在调用前知晓。通话和消息费用从预付余额中扣除，按路由价格加平台费计费（路由费率的 2%，每次通话或消息最高 $0.001）。详情请见定价。

须知

• 列表中的 ASR 和 ACD 数值由卖家提供，并非 PacketExchange 测量所得。
• wmmn_send_sms 会返回发送时的结果（已接受、已发送或失败）。如果路由返回运营商回执，可通过 REST API（GET /comms/sms/{messageId}）以及 sms.delivered 和 sms.failed Webhook 获取送达结果。
• 语音验证码和语音通话操作支持英语、西班牙语、法语、德语、葡萄牙语和印地语。
• 测试密钥（wmmn_test_sk_...）会使用测试余额模拟通话和消息。它们可以读取 Switch 数据，但不能修改数据，也不能进行 x402 充值：此类请求会被拒绝，并返回 TEST_KEY_NOT_ALLOWED。
• 请将 PacketExchange 用于面向预期接收者的事务性消息和通话，例如验证码、提醒和预约通知。

链接

• MCP 服务概览：packetexchange.io/mcp
• 开发者：packetexchange.io/developers
• API 参考：packetexchange.io/api-docs
• OpenAPI 规范：packetexchange-openapi
• 支持：[email protected]

许可证

此代码库中的文档和配置依据 MIT License 发布。