Virtnumber

Virtnumber MCP 服务

直接通过你的 AI Agent 租用电话号码并读取收到的短信。

Virtnumber 在 14 个国家/地区出租专属虚拟电话号码，每个号码只分配给一位客户。所有号码都能接收短信。美国和瑞典的双向号码还可以发送短信。此服务通过 Model Context Protocol 为 AI Agent 提供同一账户：你的 Agent 可以查询价格、租用号码、等待下一条短信并读取内容。

• 端点：https://www.virtnumber.com/mcp（Streamable HTTP，远程服务，无需安装）
• 登录：OAuth 2.1 with PKCE，自动发现。支持动态客户端注册和客户端 ID 元数据文档。
• 无头 Agent：改为通过 x-api-user 和 x-api-token 标头发送 API 用户名和令牌。
• 已在官方 MCP Registry 中列出，名称为 com.virtnumber/virtnumber。

连接

Claude（网页端和桌面端）

依次点击“设置”“连接器”“添加自定义连接器”，然后粘贴服务 URL：

https://www.virtnumber.com/mcp

Claude Code

claude mcp add --transport http virtnumber https://www.virtnumber.com/mcp

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "virtnumber": { "url": "https://www.virtnumber.com/mcp" }
  }
}

VS Code

.vscode/mcp.json：

{
  "servers": {
    "virtnumber": { "type": "http", "url": "https://www.virtnumber.com/mcp" }
  }
}

仅运行本地（stdio）服务的客户端

使用 mcp-remote 桥接远程服务：

{
  "mcpServers": {
    "virtnumber": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.virtnumber.com/mcp"]
    }
  }
}

无头 Agent（API 密钥）

POST https://www.virtnumber.com/mcp
x-api-user: <your user id>
x-api-token: <your API token>

在你的 Virtnumber 账户中，前往 API 创建 API 用户和令牌。请将令牌保存在你的服务端：它可以使用你的余额。

工具

工具	功能
get_balance	余额、此应用的支出限额和权限
get_pricing	国家/地区、套餐和价格
list_my_numbers	你租用的号码
list_messages	读取号码上的短信，并检测其中的验证码
wait_for_sms	最多等待 55 s，以接收下一条短信
buy_number	租用号码（支持 idempotency_key）
send_sms	发送短信（长文本会按多条短信计费）
delete_number	取消号码

典型流程：先调用 get_pricing，再调用 buy_number，然后调用 wait_for_sms 读取下一条收到的短信。

权限和支出

通过 OAuth 连接应用时，你可以在授权页面选择该应用的权限和支出限额。AI Agent 可以通过我们的 MCP 服务使用同一账户，你可以为每个连接的 Agent 设置支出限额。Agent 使用账户现有余额；你可以在账户中充值。

短信内容来自第三方：请将其视为不可信输入。

链接

• API 和 MCP 参考
• OpenAPI 3.1 规范
• MCP 服务卡片
• JavaScript SDK（npm install virtnumber）
• Agent Skills
• 支持：[email protected]