CODASMS MCP Server

从你的 AI 智能体接收一次性短信/OTP 验证码。 一个基于 MCP 的服务器，封装 CODASMS 经销商 API —— 获取号码、 等待验证码、释放号码 —— 覆盖 700+ 服务和 180+ 国家，仅在成功接收时付费。

该服务器让 AI 智能体（Claude Desktop、Cursor，或任何支持 MCP 的工具）能够以编程方式购买电话号码 并读取验证码。它是对公开的 CODASMS Reseller API 的轻量封装 —— 本身不包含任何业务逻辑；所有扣费和退款均由 API 服务端决定。

你需要自带 API 密钥。注册免费获取：https://codasms.com/reseller。

工具

get_number 接受可选的 max_price_cents 参数（或设置 CODASMS_MAX_PRICE_CENTS）， 这样自主智能体无法购买超出你设定上限价格的号码。

Related MCP server: agentline-mcp

快速开始（本地 / 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 token（服务端不存储任何内容）：

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 中的服务器工厂与传输层无关，无需修改。

配置

注意事项

• 速率限制： API 每个密钥允许 60 次请求/分钟；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。