Claude Code
在终端中添加远程 MCP 服务。
claude mcp add --transport http avatarlookup https://avatarlookup.com/mcp --header "Authorization: Bearer YOUR_API_KEY"Model Context Protocol
AvatarLookup MCP 服务让 AI 助手直接发起手机号检测
连接兼容 MCP 的客户端后，即可进行单号检测、多号检测、查看可用产品和读取余额。不需要创建第二个账号或凭据。异步批量任务不通过 MCP 提供：它的入口是上传手机号文件，请使用网页后台或 REST API。
MCPStreamable HTTP4 个工具
01
什么是 MCP？
Model Context Protocol 让 AI 应用在对话中调用外部工具。你可以直接让助手去查某个账号的头像或过一遍一批标识，不必单独写一套 API 集成。
MCP 只是协议适配层，不是一套独立的检测系统。它与 REST API 使用相同的产品、余额、计费、并发限制、超时和结果语义。
02
认证方式
使用 REST API 完全相同的 API Key，并在 MCP 客户端配置中将其作为 Bearer Token 发送。
Authorization 请求头
Authorization: Bearer YOUR_API_KEY妥善保管 API Key只在你自己信任的客户端配置中添加 API Key，不要暴露在浏览器代码或公开提示词中。
03
服务器地址
将客户端指向官方 Streamable HTTP 地址即可，不需要在本地运行 MCP 进程。
MCP 接口地址Streamable HTTP
https://avatarlookup.com/mcp请求通过 Streamable HTTP 传输 JSON-RPC，并复用 REST 接口使用的 API Key 鉴权中间件。
04
连接你的客户端
选择客户端支持的配置格式，并将占位符替换为你的 API Key。
Cursor / Claude Desktop
将服务配置添加到客户端的 MCP 配置文件中。
{
"mcpServers": {
"avatarlookup": {
"url": "https://avatarlookup.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}其他 MCP 客户端
使用上面的地址和 Bearer 请求头，通过 Streamable HTTP 连接。
URL: https://avatarlookup.com/mcp
Authorization: Bearer YOUR_API_KEY05
可用工具
工具范围由 API Key 所属的应用决定。如果需要发现有效的产品编码，请先调用 list_products。
list_products
列出当前 API Key 可用的产品、价格、计费倍数和返回字段。
无需参数check_number
同步查询一个标识，avatar 与 avatar_url 是主结果。
service_type · string · 必填
identifier · string · 必填check_numbers
使用同一个 service_type 检测 1–100 个手机号，并保持输入顺序。
service_type · string · 必填
identifiers · string[] · 必填 · 最多 100 个get_balance
读取当前账户余额，不会产生扣费。
无需参数06
提示词示例
连接后，可以用自然语言向助手提出请求：
- “查一下 +14155552671 在 WhatsApp 上有没有头像，有的话给我图片地址。”
- “检查这 20 个邮箱地址有没有公开头像，并汇总结果。”
- “运行这批检测前还剩多少余额？”
07
错误处理
工具失败时会返回 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服务维护中
稍后重试。