接口参考
WA Lookup MCP 文档
Model Context Protocol 是一种开放标准,让 AI 应用可以在对话中调用外部工具。连接后,您可以直接让助手检测一个号码或分析一批号码,而不需要单独编写 API 集成。
MCP 只是协议适配层,不是一套独立的检测系统。它与 REST API 使用相同的产品、余额、计费、并发限制、超时和结果语义。
认证方式
使用 REST API 完全相同的 API Key。请从设置中创建或复制 API Key,并在 MCP 客户端配置中将其作为 Bearer Token 发送。
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服务维护中 | 稍后重试。 |