Numbers Online — Phone Intelligence

Numbers Online — 电话情报 MCP 服务

一个托管的只读模型上下文协议服务，一次调用即可为 AI 语音 Agent 提供电话情报：这个来电者是谁？这个外拨号码是否值得三思后再拨打？——在耗费 Agent 分钟数之前。

• 端点： POST https://numbers.online/api/v1/mcp（Streamable HTTP，JSON-RPC 2.0）
• 传输方式： 远程 / 托管——**无需安装或运行任何内容。**让 Agent 连接到此 URL 即可。
• 身份验证： 调用工具时使用 Authorization: Bearer <api_key>；发现功能公开开放。
• 文档： https://numbers.online/docs/integrations · 网站： https://numbers.online

定位。 所有输出都是建议性、低置信度的补充信号。 发起调用的 Agent 保留所有路由和拨号决策，并继续承担合规责任。此处的任何内容都不表示某次通话「合法」「非法」「安全」或「属于垃圾电话」。

---

工具

四个只读工具（均标注 readOnlyHint、idempotentHint）。通过 tools/list 实时发现，无需身份验证。

工具	返回内容	计费方式
phone_lookup	完整信息包——有效性、格式、线路类型、号段运营商、国家、来电者姓名（如有则包含 CNAM）、STIR/SHAKEN verstat、带标签的垃圾电话信号、第一方 DNC 信号、签名回执	每次调用按捆绑套餐计费
caller_risk	垃圾电话信号 + verstat + 第一方 DNC 信号 + 回执（不查询姓名）	每次调用按捆绑套餐计费
line_type	仅确定性信息——有效性、线路类型（移动 / 固定电话 / VoIP / …）、运营商、国家、格式	免费
dnc_check	第一方禁止联系信号 + 签名回执	免费

关于 DNC 信号

DNC 信号是第一方、以同意为先：它反映号码所有者在 Numbers Online 内登记并验证的禁止联系偏好。它不是任何政府或持牌禁止拨打电话登记库的副本、镜像或复制品。取值如下：

• SUPPRESS——所有者为此渠道登记了禁止联系偏好。
• NO_MATCH——没有禁止联系偏好的记录（没有禁止联系记录不代表已获得同意）。
• UNKNOWN——无法评估该号码。

请将此信号作为你自己的 TCPA 流程的补充输入，绝不可将其视为通话是否合法的判定。（号码重新分配状态本质上依赖运营商 / FCC 数据集，因此不会作为第一方信号提供——这里没有 reassigned_check 工具。）

---

连接

任意 MCP 客户端（Claude Desktop、Claude Code、IDE）

添加一个指向该端点的远程服务。mcp.json 片段示例：

{
  "mcpServers": {
    "numbers-online": {
      "type": "streamable-http",
      "url": "https://numbers.online/api/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

密钥需要具有 mcp 用途。initialize、ping 和 tools/list 无需身份验证即可使用（功能发现）；tools/call 默认拒绝，必须提供密钥。

Vapi

将 Numbers Online 注册为 MCP 工具——传输方式的字面值为**shttp** （参见 integrations/mcp/vapi-mcp-tool.json）。 Vapi 自定义函数工具的替代方案位于 integrations/vapi/numbers-online-tool.json。

Retell

将 Agent 的 call_inbound webhook 指向即插即用配置： integrations/retell/inbound-webhook.json。 它始终会在 Retell 的时限内返回 HTTP 200（故障开放），因此缓慢的查询不会让来电者一直等待接通。

完整指南：docs/ai-voice-agents.md。

---

快速冒烟测试

# discover tools (no auth)
curl -s https://numbers.online/api/v1/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# call a tool (needs an mcp-scoped key)
curl -s https://numbers.online/api/v1/mcp \
  -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"phone_lookup","arguments":{"number":"+14155552671"}}}'

可运行的参考客户端（零依赖）位于 examples/—— Node 和 Python。

---

已签名回执（可验证的“截至 T 时已核查”证据）

每个计费回答都可以携带一个 receipt_id 和一个 Ed25519 response_signature。 稍后获取回执——无需 API 密钥，该 ID 即为访问凭证：

GET https://numbers.online/api/v1/receipts/{id}

不会存储原始电话号码——只存储 number_hash = sha256(E.164)。使用 GET https://numbers.online/api/v1/publickey 中的公钥进行验证。回执是可验证的 证据，证明某项状态曾在某个时间点经过核查——但不能证明拨号行为合法。请将回执 ID 视为敏感信息（电话号码的取值空间较小，因此可以将哈希与候选号码关联起来）。

---

隐私

绝不会记录或存储原始电话号码；号码会经过哈希处理（sha256）。MCP 路径为 只读且无状态。隐私政策：https://numbers.online/privacy

定价

完整套餐按单次捆绑查询计费（在一次调用中完成验证 + 线路类型 + 风险 + 第一方 DNC）。line_type 和 dnc_check 免费。当前费率请参阅 https://numbers.online。

---

开发者： Evergrow · 产品： Numbers Online · 联系邮箱： [email protected] · 许可证： MIT