WA Lookup MCP 文档

Model Context Protocol 是一种开放标准,让 AI 应用可以在对话中调用外部工具。连接后,您可以直接让助手检测一个号码或分析一批号码,而不需要单独编写 API 集成。

MCP 只是协议适配层,不是一套独立的检测系统。它与 REST API 使用相同的产品、余额、计费、并发限制、超时和结果语义。

产品、计费与限制见 API 文档

认证方式

使用 REST API 完全相同的 API Key。请从设置中创建或复制 API Key,并在 MCP 客户端配置中将其作为 Bearer Token 发送。

Authorization 请求头
Authorization: Bearer YOUR_API_KEY

妥善保管 API Key只在您自己信任的客户端配置中添加 API Key。不要粘贴到公开提示词、提交到代码仓库,或暴露在浏览器代码中。

服务器地址

服务器使用官方 Streamable HTTP 传输。将客户端指向这个统一地址即可,不需要在本地运行 MCP 进程。

项目值
MCP 接口地址https://walookup.com/mcp
Streamable HTTP请求通过 Streamable HTTP 传输 JSON-RPC,并复用 REST 接口使用的 API Key 鉴权中间件。

连接您的客户端

本站已适配 Claude Code、Cursor / Claude Desktop,以及其他任何支持 Streamable HTTP 的 MCP 客户端。在下面选择对应的一页,把占位符换成您的 API Key。

claude mcp add --transport http wachecker https://walookup.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

在终端中添加远程 MCP 服务。

可用工具

工具范围由 API Key 所属的应用决定。如果需要发现有效的产品编码,请先调用 list_products。

list_products

列出当前 API Key 可用的产品,包括价格、计费倍数、用途和返回字段。

参数
无需参数

check_number

同步检测一个提交的号码。registered 是主结果;avatar 和 business 是可选的产品字段。

参数
service_type · string · 必填
identifier · string · 必填

check_numbers

使用同一个 service_type 检测 1–100 个号码。结果保持输入顺序;每个号码独立判定,某个号码失败不会中止其他号码。

参数
service_type · string · 必填
identifiers · string[] · 必填 · 最多 100 个

get_balance

读取当前账户余额。该操作只读,不会创建检测或扣费。

参数
无需参数

提示词示例

连接后,可以用自然语言向助手提出请求:

  • 检查 +17253100591 是否注册了 WhatsApp。
  • 检查这 20 个号码,并汇总已注册与未注册的数量。
  • 显示我的 API Key 可用的产品及其价格。
  • 运行这批检测前还剩多少余额?

错误处理

工具失败时会返回 isError=true,让客户端能够解释具体问题,而不是误判为连接断开。业务错误继续使用 API 相同的 code、msg、data 响应约定。

工具错误示例

{
  "code": 42901,
  "msg": "too many concurrent requests",
  "data": null
}
业务码说明
40000产品或字段无效不支持的 service_type 或字段冲突。
40002号码无效提交的号码格式不合法。
40100API Key 缺失或无效检查 Bearer 请求头,并确认 API Key 仍处于启用状态。
40200余额不足整批费用无法覆盖时,请求会在处理前被拒绝。
42200无法判定暂时无法判定该号码,不返回结果,本次不计费。
42901并发名额已满5 个在处理的请求名额已满,或该账号已有一个多号检测在跑,不扣费;等已有请求结束后再重试。
50303服务繁忙平台处理中的检测过多,不扣费;按 Retry-After 的秒数等待后重新提交。
50400检测超时未在时限内完成,不计费;多号超时为整批失败并全额退款。
50300服务维护中稍后重试。