TG Validator MCP 文档

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

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

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

认证方式

使用 REST API 完全相同的 API Key，并在 MCP 客户端配置中将其作为 Bearer Token 发送。

Authorization: Bearer YOUR_API_KEY

服务器地址

将客户端指向官方 Streamable HTTP 地址即可，不需要在本地运行 MCP 进程。

连接您的客户端

选择客户端支持的配置格式，并将占位符替换为您的 API Key。

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

{
  "mcpServers": {
    "tgvalidator": {
      "url": "https://tgvalidator.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

URL: https://tgvalidator.com/mcp
Authorization: Bearer YOUR_API_KEY

可用工具

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

无需参数

service_type · string · 必填
identifier · string · 必填

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

无需参数

提示词示例

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

• 检查 +17253100591 是否注册了 Telegram。
• 检查这 20 个号码，并汇总结果。
• 运行这批检测前还剩多少余额？

错误处理

工具失败时会返回 isError=true，并继续使用 API 相同的 code、msg、data 响应约定。

{
  "code": 42901,
  "msg": "too many concurrent requests",
  "data": null
}