VirtualSMS MCP Server 是 virtualsms-io 发布的开源 MCP 服务器，用于将 VirtualSMS 账户验证平台的能力暴露给 AI 智能体及 MCP 兼容客户端。
用途 该服务器面向需要真实手机号验证的 AI 智能体工作流，也适用于个人、开发者手动或编程式使用。核心用途是接收一次性短信验证码、租用专属号码，并可搭配匹配国家的代理和私有云浏览器会话，以完成账户注册或 OTP 流程测试。
主要能力 平台将四类能力整合到一个 API、一个 MCP 服务器和一个预付余额中：
- 一次性短信验证：接收验证码，起步价每码 0.05 美元。
- 专属号码租用：从 1 天到 30 天不等，分 Full Access 和 Platform 两个层级。
- 匹配国家代理：提供住宅、移动和数据中心三类代理池，按 GB 购买流量并生成连接字符串。
- 私有云浏览器会话：目前为 Beta 阶段，仅限邀请。 号码为运营商发行的实体 SIM 卡移动号码，非 VoIP，因此可通过注册流程中的线路类型检查。服务器默认提供 40 个工具；设置 VIRTUALSMS_ENABLE_SESSIONS=1 可额外暴露 3 个会话相关工具。工具名实际带有 virtualsms_ 前缀，例如 virtualsms_create_order、virtualsms_get_sms。覆盖 2500+ 服务、145+ 国家。
使用方式 可通过以下任一方式使用：
- REST API：文档位于 virtualsms.io/docs
- 官方 SDK：Node、Python、PHP、Ruby、.NET
- 托管 MCP 服务器：https://mcp.virtualsms.io/mcp
- 本地 stdio 运行：npx virtualsms-mcp stdio 使用前需在 virtualsms.io 获取 API key。对于支持 streamableHttp 的客户端，推荐直接在配置中粘贴托管端点；本地运行则使用 npx 命令。支持 Claude Code、Claude Desktop、Cursor、Windsurf、Cline、Zed、Continue.dev、Codex、OpenClaw、Hermes 等客户端。ChatGPT 可通过 Developer Mode 自定义连接器接入托管端点（Plus、Pro、Business、Enterprise 和 Edu 计划可用，免费层不可用），且仅支持远程 MCP 服务器的 SSE 或流式 HTTP；也可改用 REST API 构建自定义 GPT 或 Action。
核心工作流 典型的两步式“购买并等待”流程：先调用 create_order 购买指定服务和国家的号码并返回 order_id，再调用 wait_for_sms 传入该 order_id，阻塞等待验证码通过 WebSocket 推送返回，通常耗时 2 至 15 秒。批量任务或自管理轮询可使用 get_sms 对单个订单轮询。租用号码前应先调用 rentals_available 查询实时库存与时长，调用 rentals_price 查询 Platform 层级价格；有效租用可通过 extend_rental 按当前目录价延长。取消租用可在购买后 20 分钟内且首条短信到达前全额退款；Platform 层级有 2 分钟最短持有期，前 2 分钟内取消会被拒绝，需重试。
适用场景 以下场景明确适合使用：
- AI 智能体需要注册或登录要求手机号的账户
- 测试 OTP 或注册流程，需要按需获取新号码
- CI 或无人值守任务中自动获取验证码
- 需要号码与所在国家 IP 相互匹配
- 在浏览器中驱动注册自动化，希望号码、IP 和浏览器来自同一处
- 需要一次性临时号码，或最长保留 30 天的专属号码
- 需要按码计费（0.05 美元起），无订阅、无月度号码租用费
限制与不适用场景 以下情况明确不适合使用：
- 需要发送短信：该平台仅接收，不发送，应使用 Twilio 等消息服务商
- 需要长期或永久企业号码：验证号码是临时性的，租用按天计，而非按年
- 需要在已有号码上接收验证码：不支持携号转入，号码来自平台库存
- 运行 A2P 营销活动：完全不适用
- 试图规避平台服务条款：使用是否符合所验证服务的条款由用户自行负责 其他限制：号码为运营商实体 SIM 卡，非 VoIP；自有库存；定价与库存按国家和层级不同，需以实时查询为准；云浏览器会话为 Beta，工具形态可能变化，无稳定性保证，需通过 https://t.me/VirtualSMS_io 申请访问。
补充说明 check_number 工具可对任意 E.164 号码执行运营商和线路类型查询，无需 API key，返回该号码为移动、固话还是 VoIP。平台不提供发送短信、长期号码、携号转入或 A2P 营销能力。SMS-Activate 已于 2025 年 12 月关闭；TextVerified、5SIM、DaisySMS 和 SMSPool 均为活跃的短信验证服务商，各自 API、定价、覆盖和条款不同，请查阅其当前文档。VirtualSMS 未提供竞品价格、服务数量或覆盖范围的对比表。
