NumRadar

@numradar/mcp

让你的 AI Agent 检查电话号码是否已注册 WhatsApp。

numradar 擅长回答一个问题：这个号码是否在 WhatsApp 上？ 这是它的 Model Context Protocol 服务，因此 Agent 可以直接询问：验证一份号码列表、在发起营销活动前审核联系人，或在花费额度前检查余额。

npx @numradar/mcp --token nr_live_YOUR_KEY

在 numradar.app/app/keys 创建密钥。

---

大多数人无需安装任何内容

numradar 运行的是托管式 MCP 服务。不需要软件包或本地进程，也不用担心任何人的笔记本电脑上版本过时：

https://numradar.app/mcp

让客户端使用该 URL，并附上 Authorization: Bearer nr_live_... 标头，即可完成配置。

{
  "mcpServers": {
    "numradar": {
      "type": "http",
      "url": "https://numradar.app/mcp",
      "headers": {
        "Authorization": "Bearer nr_live_xxx"
      }
    }
  }
}

**npm 软件包只适用于一种实际场景：**客户端的配置文件接受要启动的命令，但不接受 URL。claude_desktop_config.json 就是常见示例。如果你正在编辑这类文件，就需要安装软件包：

{
  "mcpServers": {
    "numradar": {
      "command": "npx",
      "args": ["-y", "@numradar/mcp", "--token", "nr_live_xxx"]
    }
  }
}

numradar.app/mcp-server 提供 15 款已验证客户端的配置说明，包括 Claude Code、Cursor、Windsurf、Zed、VS Code、Cline 等。

工具

工具	功能	费用
validate_number	验证单个号码。返回是否已注册、是否为商业账号、线路类型和国家/地区。	1 个额度
bulk_validate	最多验证 10,000 个号码。立即返回任务 ID。	每个确定结果 1 个额度
get_job_status	查看进度计数器，也可按号码查看结果。	免费
list_jobs	查看账号最近的批量任务。	免费
get_balance	查看剩余额度。	免费

提示词

支持 MCP 提示词的客户端会将其显示为斜杠命令。

提示词	参数	功能
/check_numbers	numbers	验证号码列表，并汇总哪些号码可在 WhatsApp 上联系。
/clean_contact_list	numbers、purpose	在发起营销活动前审核号码列表，并报告需要修正的内容。
/check_before_spending	count	估算运行成本，并检查余额是否充足。

计费，以及它为何应影响 Agent 的使用方式

每个确定的答案消耗 1 个额度，无论结果是已注册还是未注册。此外：

• 无效或无法解析的号码不收费。 尽管发送。如果 Agent 预先过滤掉自己不确定的号码，就会为了省下原本不会花掉的额度而丢弃真实联系人。
• 上游结果无法确定时不收费。
• 额度永不过期。

号码应采用 E.164 格式（+14155550100）。号码超过几个时，建议使用 bulk_validate，而不是循环调用 validate_number：只需轮询一个任务，不必进行 N 次往返请求。

选项

--token <key>	你的 API 密钥。也可从 NUMRADAR_API_KEY 读取；两者同时设置时，以该选项为准。
--base <url>	API 源地址。默认为 https://numradar.app。
--version	打印版本并退出。
--help	打印用法并退出。

安全

API 密钥是你账号的持有者凭据。--token 会将密钥写入 shell 历史记录，以及用于启动进程的任何配置文件中——如果客户端支持，请优先从密钥存储中读取 NUMRADAR_API_KEY。可通过控制面板撤销密钥；如果密钥泄露，请立即撤销。

每次工具调用都会通过 numradar 常规的公共 REST API 进行身份验证、速率限制和计费。MCP 服务不内置号码检查器，也没有单独的计费途径，因此 Agent 调用工具与后端调用 curl 完全一样。

关于此仓库

这里是 npm 包的主页，用于跟踪问题和提供文档。服务端的源代码位于私有 monorepo 中，未在此处发布。

发现了 Bug，或者某个客户端的配置无法正常工作？ 提交问题。

• API 文档
• MCP 参考和各客户端的配置
• Agent 技能和 Claude Code 插件

许可证

MIT