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（1 つのプロジェクト）に追加します。

VS Code（エージェントモード）：.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 のいずれか（少なくとも 1 つ）；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 への公開は、prooftell/integrations のルートにある .github/workflows/release-mcp.yml を使い、GitHub Actions が provenance 付きで行います。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」にチェックを入れる）に切り替え、シークレットとトークンを削除します。新しく設定した信頼された公開者が2日以内に一度も公開に成功しないと、npm によって期限切れになります（その場合は削除して再作成し、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 の apex にある v=MCPv1; k=ed25519; p=… という TXT レコードによって証明されています。package.json の mcpName によって、npm パッケージとこの名前が結び付けられています。一度公開したバージョンは変更も削除もできません。修正する場合は新しいバージョンを公開してください。

リソース

• ProofTell：https://prooftell.com/integrations?utm_source=mcp&utm_medium=integration
• API リファレンス：https://prooftell.com/docs
• サポート：[email protected]

ライセンス

MIT。