ProofTell

@prooftell/mcp

ProofTell 的 MCP 服务：将 ProofTell 公共 API（https://prooftell.com/docs）的检查功能作为工具，供 Claude、Cursor、VS Code 和任何 Model Context Protocol 客户端使用。让助手检查电话号码、电子邮件地址或 IP 地址，或评估注册风险；它会使用你的密钥调用 ProofTell 并读取结果。服务在你的机器上运行 （stdio），不会存储任何内容。

密钥

在 ProofTell 控制面板（Developers → Integrations）中创建密钥，并以此平台命名。pt_test_ 密钥是免费的沙盒：返回模拟且确定的结果。pt_live_ 密钥会扣除账户余额。服务从环境变量 PROOFTELL_API_KEY 中读取密钥，并在下方客户端配置中设置。

添加到客户端

需要 Node.js 18 或更高版本；首次使用时，npx 会获取该服务。

Claude Code：

claude mcp add prooftell --env PROOFTELL_API_KEY=pt_test_… -- npx -y @prooftell/mcp

**Claude Desktop：**进入 Settings → Developer → Edit config，然后在 claude_desktop_config.json 中：

{
  "mcpServers": {
    "prooftell": {
      "command": "npx",
      "args": ["-y", "@prooftell/mcp"],
      "env": { "PROOFTELL_API_KEY": "pt_test_…" }
    }
  }
}

**Cursor：**在 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）中使用相同的配置块。

VS Code（Agent 模式）：在 .vscode/mcp.json 中；VS Code 会提示输入密钥一次，并确保密钥不会写入文件。

{
  "inputs": [
    { "type": "promptString", "id": "prooftell-key", "description": "ProofTell API key", "password": true }
  ],
  "servers": {
    "prooftell": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@prooftell/mcp"],
      "env": { "PROOFTELL_API_KEY": "${input:prooftell-key}" }
    }
  }
}

工具

每次检查都会从你的余额中扣费；沙盒免费。返回结果为 API 的 JSON，未经更改。

工具	标题	调用	参数
look_up_phone_number	查询电话号码	POST /v1/phone	phone（必填）；country，用于国家格式的号码；level：basic、line_type（默认值）、current_carrier、line_status、fraud_score，每项都包含之前各项的检查内容
verify_email_address	验证电子邮件地址	POST /v1/email	email（必填）；timeout，1000 至 45000 ms
look_up_ip_address	查询 IP 地址	POST /v1/ip	ip（必填）
assess_identity_risk	评估身份风险	POST /v1/assess	phone、email、ip 中任意一项（至少一项）；country；reference
get_balance	获取账户余额	GET /v1/balance	—（免费）

风险评估会返回 0 到 100 的 score、一个 verdict（allow、review、deny），以及计入分数的 reasons；每个信号自身的结果位于 signals 下。调用失败时会返回工具错误，其中包含 API 的消息和代码——insufficient_balance 会说明检查所需的余额以及需要充值的金额，rate_limited 表示请求突发频率超过密钥的速率限制，invalid_api_key 表示密钥错误或已撤销——这样助手就能说明该怎么做。

沙盒

使用 pt_test_ 密钥时，每次调用都会进行模拟，结果确定且免费：+447700900123 是 GB 手机号码，+15005550003 无效；[email protected] 可投递，[email protected] 是一次性邮箱；203.0.113.1 是干净的 US 地址，203.0.113.66 是 Tor 地址；使用 +447700900123 和 203.0.113.1 进行评估会得到 geo_mismatch，结果为允许，分数为 15。完整列表请参阅 API 参考：https://prooftell.com/docs。

开发

纯 JavaScript（ES 模块），无需构建步骤：src/index.js（服务）、src/tools.js（工具及其架构）、src/api.js（请求）。

npm install
npm test     # the SDK's client spawns the server: the tools' list, the requests against a local stand-in for the
             # API, the errors; with PROOFTELL_TEST_KEY set to a sandbox key (read into the command, never written
             # down), every tool against staging as well

PROOFTELL_BASE_URL 用于将服务指向另一个 API（https://api.prooftell.dev，预发布环境）；该变量仅从环境中读取。

发布

1. npm，通过带有来源证明的 GitHub Actions（位于 prooftell/integrations 根目录的 .github/workflows/release-mcp.yml）：更新 package.json 和 server.json（两处）中的 version，提交，然后创建标签 mcp-v<version> 并推送该标签。首次发布使用仓库机密 NPM_TOKEN（具有所有软件包读取和写入权限，并可绕过双重身份验证的细粒度令牌）；此后使用 npm 的可信发布（软件包设置中的 Publish access → Trusted Publishers → GitHub Actions，所有者 prooftell、仓库 integrations、工作流 release-mcp.yml，勾选“Allow npm publish”），并删除机密和令牌。npm 会在新可信发布者 2 天内未成功发布的情况下使其过期（之后：删除它，重新创建，并在 2 天内发布）；无令牌的发布流程首次通过 1.0.1 验证。
2. 版本发布到 npm 后，在此文件夹中使用 mcp-publisher 发布到官方 MCP Registry：执行 mcp-publisher login dns --domain prooftell.com --private-key <the key's hex>，然后执行 mcp-publisher publish。名称 com.prooftell/mcp 已通过 prooftell.com 顶级域名上的 TXT 记录 v=MCPv1; k=ed25519; p=… 验证；package.json 中的 mcpName 将 npm 软件包与其关联。发布到该注册表的版本无法更改或删除：修复时需发布新版本。

资源

• ProofTell：https://prooftell.com/integrations?utm_source=mcp&utm_medium=integration
• API 参考：https://prooftell.com/docs
• 支持：[email protected]

许可证

MIT。