sv-number

SV Number MCP 服务

将电话号码作为工具。你的 Agent 会在服务要求的国家订购一个私人号码，通过 API 直接读取短信验证码，然后归还号码。 通过 stdio 提供 9 个工具，无需学习 SDK。

覆盖 200 多个国家/地区，是此类别中覆盖范围最广的服务。本页的其他说法也都可以验证，但这一条只需调用一次：运行 list_countries 并统计行数。

order_number(service="tg", country=6)   ->  +62 838 1234 5678
wait_for_code(activationId)             ->  123456
finish_activation(activationId)         ->  done

安装

Claude Code：

claude mcp add sv-number --env SVN_API_KEY=your_key_here -- npx -y sv-number-mcp

适用于任何读取 JSON 配置的工具（Codex、Cursor、Claude Desktop）：

{
  "mcpServers": {
    "sv-number": {
      "command": "npx",
      "args": ["-y", "sv-number-mcp"],
      "env": { "SVN_API_KEY": "your_key_here" }
    }
  }
}

完成注册后，可从个人资料获取密钥。账户余额必须充足：此 API 没有免费套餐。密钥从环境变量中读取，绝不会离开进程；任何工具都不会返回密钥，错误消息也不会引用密钥。

工具

工具	功能
get_balance	查看账户剩余余额
list_countries	列出所有国家/地区及其 ID 和运营商
list_services	查找网站对应的代码：按名称或域名搜索，按匹配度从高到低排序，并显示价格、在线号码数量以及验证码实际送达率
order_number	为某个国家/地区的一项服务订购私人号码
wait_for_code	轮询直到收到验证码，并返回已从短信中解析出的验证码
finish_activation	完成成功的激活
cancel_activation	取消激活并退款
request_another_sms	在同一个号码上请求另一条验证码
totp_code	根据 RFC 6238 在本地计算身份验证器代码

list_services 会返回按匹配度从高到低排序的 matches，以及作为后备选项的 notInList 服务。它接受网站名称或 URL，因此 discord.com 可以找到 Discord；它会优先匹配完整单词而非子字符串，因此搜索 x 时，X.com (Twitter) 会排在 Maxim 前面。代码是任意分配的，绝不能凭记忆填写：uk 对应 Airbnb，re 对应 Coinbase，tn 对应 LinkedIn。如果没有匹配结果，返回内容会说明这一点，并推荐其他国家/地区，因为不同地区的目录并不相同；同时还会推荐 ot（“不在列表中”），它可以接收来自列表中任何发件人的短信。网站若有专属代码，短信就会发送到该代码，因此 ot 是后备选项，并非通配符。

deliveredPercent 表示该服务在该国家/地区的送达率；如果这组数据尚无统计信息（这很常见），则为 null。有送达率数据时，应优先依据送达率而非价格选择；没有数据时，online 会显示在线号码池的规模，这是次好的参考指标。

服务端会为你处理的事项

每次调用都会携带 lang。API 不带该参数也会返回结果，但会使用另一种货币计价，因此服务端绝不会省略该参数。API 返回的文本标记而非 JSON 时，会先检查这些标记，再进行解析，并将其转换为 Agent 可以采取行动的句子：NO_NUMBERS 会转换为“更换国家/地区，或将运营商设为 any”，而不是只返回一个标记。轮询会采用合理的间隔，而不是不断请求 getStatus；wait_for_code 会在号码有效期 20 分钟后停止。

本服务不适用于

本服务只负责接收验证码。这些号码不能发送短信，也不能接听电话，不适用于银行、支付或政府账户。需要长期使用号码进行对话的 Agent 应选择运营商的产品。

配置

变量	默认值
SVN_API_KEY	必填
SVN_API_BASE	https://sms-verification-number.com/stubs/handler_api
SVN_LANG	en，同时设置响应的语言和货币
SVN_POLL_SECONDS	4

相关链接

• 同一产品的 Markdown 技能版本：https://github.com/sv-number/skills
• API 参考：https://sms-verification-number.com/en/api-sms-activate/
• 覆盖范围和价格：https://sms-verification-number.com/en/number-for-ai-agents/

MIT。其背后的服务为商业服务。