codasms-mcp

---

此服务允许 AI Agent（Claude Desktop、Cursor 或任何支持 MCP 的客户端）购买电话号码并以编程方式读取验证码。它只是公共 CODASMS Reseller API 的轻量封装——自身不包含任何业务逻辑；所有扣款和退款均由 API 在服务端决定。

请自备 API 密钥。注册即可免费获取：**https://codasms.com/reseller**。

工具

工具	功能
get_balance	查看当前可用余额。
list_services	查看可购买的服务及实时价格和库存（可按 service / country 筛选）。
list_countries	查看提供可购买号码的国家/地区（可选用 service 筛选）。
get_number	为某项服务和国家/地区购买号码。会扣除余额（20 分钟内未收到验证码则自动退款）。
wait_for_otp	轮询订单，直到收到验证码（或超时 / 退款）。
check_order	一次性查询订单状态。
release	取消订单并立即退款（验证码已送达时除外）。

get_number 接受可选参数 max_price_cents（或设置 CODASMS_MAX_PRICE_CENTS），这样自主 Agent 就无法购买价格超过限额的号码。

快速开始（本地 / stdio）

export CODASMS_API_KEY=coda_live_xxxxxxxx   # from https://codasms.com/reseller
npx codasms-mcp

Claude Desktop

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "codasms": {
      "command": "npx",
      "args": ["-y", "codasms-mcp"],
      "env": { "CODASMS_API_KEY": "coda_live_xxxxxxxx" }
    }
  }
}

然后提出请求：“帮我获取一个英国 Telegram 号码并读取验证码。”

远程（HTTP）模式

同一组工具也通过 Streamable HTTP 提供，因此你可以托管一个实例供多位用户使用——每位用户都发送自己的 Bearer 令牌（不会在服务端存储任何内容）：

npm run build && npm run start:http     # listens on :8080, POST /mcp

POST /mcp
Authorization: Bearer coda_live_xxxxxxxx
Content-Type: application/json

src/http.ts 是一个可移植的 Node 服务端（Deno Deploy、Railway、Fly 或任何容器均可）。对于 Cloudflare Workers，可将 Node http 处理器替换为 fetch 处理器——src/server.ts 中的服务工厂与传输方式无关，无需修改。

配置

环境变量	用途	默认值
CODASMS_API_KEY	你的 coda_live_ Reseller 密钥（stdio 模式）。	—（必填）
CODASMS_API_BASE	API 基础 URL。	https://api.codasms.com
CODASMS_MAX_PRICE_CENTS	get_number 的全局限额，单位为美分。	未设置
PORT	HTTP 模式端口。	8080

注意事项

• 速率限制： 每个密钥每分钟最多发送 60 个 API 请求；wait_for_otp 默认每 5 秒轮询一次，以确保远低于限制。
• 资金安全： 调用 get_number 时会立即扣除真实余额。如果未收到验证码，订单会在 20 分钟后自动退款；也可以调用 release 立即退款。
• 代码： 服务和国家/地区使用 API 的代码（例如 tg、wa、国家/地区代码 6）——使用 list_services / list_countries 查询可用代码。

开发

npm install
npm run build      # tsc -> dist/
npm start          # stdio

许可证

MIT——详见 LICENSE。