查询价格和余额
询问拨打任意国家的电话或发送 SMS 的费用,以及剩余余额。
将 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,服务器已准备好安装。安装后将 <api_key>:<api_secret> 替换为您的密钥,或将以下内容添加到 ~/.cursor/mcp.json:
{
"mcpServers": {
"spoofcallerid": {
"url": "https://app.spoofcallerid.com/mcp",
"headers": {
"Authorization": "Bearer <api_key>:<api_secret>"
}
}
}
}点击按钮会打开 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 跟进。
另有适用于 Node.js 18 或更高版本的本地版本:spoofcallerid-mcp.mjs。它包含六个核心工具。
任何能够通过 streamable HTTP 连接远程服务器并发送自定义 Authorization 标头的 MCP 客户端,例如 Claude Code、Cursor 和 VS Code。Claude Desktop 通过 mcp-remote 连接。
不需要。服务器使用您的 API 密钥:每个请求都发送 Authorization: Bearer <api_key>:<api_secret>。列出工具不需要密钥;每次工具调用都需要。
只有四个付费工具会产生费用,服务器会要求助手先与您确认,但是否确认取决于您的客户端。如要完全避免花费,请给代理一个仅有读取权限范围的密钥。
MCP 服务器不单独收费。付费工具按与控制台相同的价格计费,免费工具不产生任何费用。
是的。提供适用于 Node.js 18 或更高版本的单文件本地服务器。它包含六个核心工具:get_account、get_balance、get_prices、send_sms、make_spoof_call 和 get_call。
在许多国家,出于正当用途(例如保护隐私或代表企业拨打电话)更改主叫号码是合法的,但用于欺诈或骚扰则属违法。您有责任遵守您本人及被叫方所在地的法律。
相关:API · 通话费用计算器 · 电话号码检查器 · HLR 查询
复制
已复制