让 AI 代理拨打电话和发送 SMS

为您的 Spoof Caller ID 账户提供的托管 MCP 服务器。

将 Claude Code、Cursor、VS Code 或其他 MCP 客户端连接到您的账户。您的代理可以使用您的 API 密钥查询价格和余额、发送 SMS、使用您的来电显示号码拨打电话、进行文字转语音通话以及查询号码。

代理能做什么

用日常语言提问,代理会选择合适的工具。

查询价格和余额

询问拨打任意国家的电话或发送 SMS 的费用,以及剩余余额。

发送短信

使用您的发件人 ID 发送 SMS,可走最便宜的路由或您指定的路由。

使用您的来电显示号码拨打电话

拨打显示您所选来电显示号码的电话,设置响铃时长,并查看是否接通。

文字转语音通话

拨打一个号码,用您选择的语音和语言朗读一条消息。

检查号码

先获取免费报价,然后运行实时 HLR 查询,查看哪些号码处于活跃状态。

使用您自己的客户端

Claude Code、Cursor、VS Code、Claude Desktop 或任何支持自定义标头的 MCP 客户端。

工具

共十三个工具。九个免费,四个收费。

免费

  • get_account 密钥所属的账户:用户名、余额和状态。
  • get_balance 您当前的欧元余额。
  • get_prices 某个国家或所有国家的每分钟通话价格和每段短信价格。
  • list_sms_routes 您可用于发送的 SMS 路由及其在某个国家的价格。
  • list_tts_voices 文字转语音通话可用的语音。
  • get_tts_call 文字转语音通话的状态、时长和费用。
  • hlr_quote 检查一组号码并告诉您 HLR 查询的费用,但不实际查询。
  • get_call 单个通话的状态(拨号中、振铃中、已接听、已结束、忙线、无人接听或失败),以及时长、计费时长和费用。
  • list_calls 您的通话记录,最新的在前,含状态、时长和费用。

收费

  • send_sms 使用您的发件人 ID 发送一条 SMS,按路由价格逐段计费。
  • make_spoof_call 拨打显示您所选来电显示号码的电话。只有接通的通话才计费,按目的地的每分钟价格。
  • tts_call 拨打一个号码并用合成语音朗读您的文本,按分钟计费。
  • hlr_lookup 检查号码是否有效、所属网络以及是否携号转网,每个有结果的号码 €0.01。

连接您的客户端

端点 https://app.spoofcallerid.com/mcp,streamable HTTP,在 Authorization 标头中携带您的 API 密钥。无需 OAuth。

在终端中运行以下命令,将 <api_key>:<api_secret> 替换为您自己的密钥。

claude mcp add --transport http spoofcallerid https://app.spoofcallerid.com/mcp --header "Authorization: Bearer <api_key>:<api_secret>"

添加到 Cursor

点击按钮会打开 Cursor,服务器已准备好安装。安装后将 <api_key>:<api_secret> 替换为您的密钥,或将以下内容添加到 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "spoofcallerid": {
      "url": "https://app.spoofcallerid.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>:<api_secret>"
      }
    }
  }
}

添加到 VS Code

点击按钮会打开 VS Code,服务器已准备好安装。将 <api_key>:<api_secret> 替换为您的密钥,或将以下内容添加到 .vscode/mcp.json;VS Code 随后会询问一次密钥并安全地保存:

{
  "servers": {
    "spoofcallerid": {
      "type": "http",
      "url": "https://app.spoofcallerid.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:spoofcallerid-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "spoofcallerid-key",
      "description": "Spoof Caller ID API key as <api_key>:<api_secret>",
      "password": true
    }
  ]
}

Claude Desktop 通过 mcp-remote 连接,需要 Node.js 18 或更高版本。将以下内容添加到 claude_desktop_config.json 并重启 Claude Desktop:

{
  "mcpServers": {
    "spoofcallerid": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://app.spoofcallerid.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <api_key>:<api_secret>"
      }
    }
  }
}

在任何支持带自定义标头的远程服务器的 MCP 客户端中使用以下设置:

URL:    https://app.spoofcallerid.com/mcp
Type:   streamable HTTP
Header: Authorization: Bearer <api_key>:<api_secret>

该服务器已在官方 MCP Registry 中列出,名称为 com.spoofcallerid/spoofcallerid。

在应用中的 Account → API & keys 下获取您的密钥。API 文档

示例提示词

您可以问什么,以及会发生什么。

拨打德国 5 分钟的电话要多少钱?

代理调用 get_prices 查询德国的价格,并根据每分钟价格算出费用。免费。

我还剩多少余额?

代理调用 get_balance。免费。

从 'MyShop' 向 +44 7700 900123 发送一条 SMS,内容为'您的订单已发货'。

代理可以先用 list_sms_routes 查看路由,然后调用 send_sms。费用为路由价格乘以消息段数。在路由允许的情况下会显示发件人名称。该号码仅为示例。

检查这些号码中哪些是有效的:…

代理先调用 hlr_quote 显示费用(免费),然后调用 hlr_lookup,每个有结果的号码 €0.01,每次调用最多 100 个号码。

用我的来电显示号码拨打 +44 7700 900123,响铃 10 秒,然后告诉我对方是否接听。

代理以 ring_timeout 10 调用 make_spoof_call,然后用 get_call 读取状态。如果无人接听,该通话不收费。号码仅为示例。

拨打这个号码,用德语语音说'您的预约在明天 10 点'。

代理通过 list_tts_voices 选择语音,启动 tts_call(按分钟计费),并可通过 get_tts_call 跟进。

安全与费用

  • 只有四个工具收费:send_sms、make_spoof_call、tts_call 和 hlr_lookup。它们的描述中会注明这一点,因此您的客户端可以在运行前显示出来。
  • 在使用付费工具之前,服务器会要求助手与您确认目的地号码、来电显示号码或发件人以及文本内容。是否询问取决于您的客户端及其设置。
  • 为代理单独创建一个 API 密钥,只授予它需要的权限范围。仅有读取权限范围的密钥无法产生任何花费。
  • 在 Account → API & keys 中将密钥锁定到您的 IP 地址。
  • 付费工具的价格与控制台相同。测试期间请保持少量余额。

AI 代理常见问题

哪些 AI 客户端可以使用?

任何能够通过 streamable HTTP 连接远程服务器并发送自定义 Authorization 标头的 MCP 客户端,例如 Claude Code、Cursor 和 VS Code。Claude Desktop 通过 mcp-remote 连接。

我需要 OAuth 吗?

不需要。服务器使用您的 API 密钥:每个请求都发送 Authorization: Bearer <api_key>:<api_secret>。列出工具不需要密钥;每次工具调用都需要。

代理会在不询问我的情况下花钱吗?

只有四个付费工具会产生费用,服务器会要求助手先与您确认,但是否确认取决于您的客户端。如要完全避免花费,请给代理一个仅有读取权限范围的密钥。

费用是多少?

MCP 服务器不单独收费。付费工具按与控制台相同的价格计费,免费工具不产生任何费用。

有本地版本吗?

是的。提供适用于 Node.js 18 或更高版本的单文件本地服务器。它包含六个核心工具:get_account、get_balance、get_prices、send_sms、make_spoof_call 和 get_call。

给您的代理一部电话

创建账户,使用加密货币充值 €50 起,并为您的代理创建 API 密钥。

创建账户