Numbers Online — Phone Intelligence

Numbers Online — 電話インテリジェンス MCP サーバー

ホスト型の読み取り専用 Model Context Protocol サーバーです。AI 音声エージェントに、1 回の呼び出しで電話番号の情報を提供します。着信した発信者は誰か、また発信する番号にはダイヤルする前に注意すべき点があるかを、エージェントの通話時間を消費する前に確認できます。

• エンドポイント： POST https://numbers.online/api/v1/mcp（Streamable HTTP、JSON-RPC 2.0）
• トランスポート： リモート／ホスト型 — インストールも実行も不要です。 エージェントから URL を指定してください。
• 認証： ツールの呼び出しには Authorization: Bearer <api_key> を使用します。検出は公開されています。
• ドキュメント： https://numbers.online/docs/integrations · サイト： https://numbers.online

位置付け。 すべての出力は、信頼度の低い補助的な参考情報です。 ルーティングと発信に関するすべての判断は呼び出し元のエージェントが行い、コンプライアンスに対する責任も負います。ここでの情報は、通話が適法、違法、「安全」、または「スパム」であると断定するものではありません。

---

ツール

読み取り専用のツールが 4 つあります（すべて readOnlyHint、idempotentHint の注釈付き）。tools/list を使ってリアルタイムに検出できます（認証不要）。

ツール	戻り値	課金
phone_lookup	完全な情報一式 — 有効性、書式、回線種別、番号帯の通信事業者、国、発信者名（利用可能な場合は CNAM）、STIR/SHAKEN verstat、ラベル付きスパムシグナル、ファーストパーティの DNC シグナル、署名済みレシート	1 回あたりの一括料金
caller_risk	スパムシグナル + verstat + ファーストパーティの DNC シグナル + レシート（名前照会なし）	1 回あたりの一括料金
line_type	決定論的な情報のみ — 有効性、回線種別（携帯電話／固定電話／VoIP／…）、通信事業者、国、書式	無料
dnc_check	ファーストパーティの連絡拒否シグナル + 署名済みレシート	無料

DNC シグナルについて

DNC シグナルはファーストパーティによる、同意を優先したものです。Numbers Online 内で番号の所有者自身が登録し、確認した連絡拒否の設定を示します。政府または認可機関の Do Not Call 登録簿をコピー、ミラー、複製したものではありません。値の意味は次のとおりです。

• SUPPRESS — 所有者がこのチャネルでの連絡拒否を登録しています。
• NO_MATCH — 記録上、連絡拒否の設定はありません（連絡拒否の設定がないことは、同意を意味しません）。
• UNKNOWN — 番号を評価できませんでした。

この情報は独自の TCPA 対応プロセスにおける補助情報として扱い、通話が適法であるとの判定には決して使わないでください。（番号の再割り当て状況は本質的に通信事業者／FCC のデータセットに基づくものであり、意図的にファーストパーティのシグナルとして提供していません。そのため、reassigned_check ツールはありません。）

---

接続

任意の MCP クライアント（Claude Desktop、Claude Code、IDE）

エンドポイントを指定するリモートサーバーを追加します。mcp.json の記述例：

{
  "mcpServers": {
    "numbers-online": {
      "type": "streamable-http",
      "url": "https://numbers.online/api/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

キーには mcp のユースケースが必要です。initialize、ping、tools/list は認証なしで使用できます（機能検出）。tools/call はフェイルクローズ方式で、キーが必要です。

Vapi

Numbers Online を MCP ツールとして登録します。トランスポートの値は shttp です （integrations/mcp/vapi-mcp-tool.json を参照）。 Vapi のカスタム関数ツールを使用する場合は、 integrations/vapi/numbers-online-tool.json を参照してください。

Retell

エージェントの call_inbound webhook に、すぐに使える設定ファイル integrations/retell/inbound-webhook.json を指定してください。 Retell の制限時間内に必ず HTTP 200 を返すため（フェイルオープン）、照会が遅くても発信者を待たせ続けることはありません。

詳しい手順については、docs/ai-voice-agents.md をご覧ください。

---

簡単なスモークテスト

# discover tools (no auth)
curl -s https://numbers.online/api/v1/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# call a tool (needs an mcp-scoped key)
curl -s https://numbers.online/api/v1/mcp \
  -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"phone_lookup","arguments":{"number":"+14155552671"}}}'

実行可能な参照クライアント（依存関係ゼロ）は examples/ にあります — Node と Python をご利用ください。

---

署名付きレシート（「時点 T で確認済み」であることを検証可能な証拠）

課金対象のすべての回答には、receipt_id と Ed25519 の response_signature を付与できます。 レシートは後から取得できます。API キーは不要で、ID がアクセス権限となります。

GET https://numbers.online/api/v1/receipts/{id}

電話番号の生データは保存されません。保存されるのは number_hash = sha256(E.164) のみです。公開鍵は GET https://numbers.online/api/v1/publickey から取得して検証できます。レシートは、ステータスが「ある時点で 確認された」ことを検証可能な証拠です。ダイヤルが合法だったことの証明ではありません。レシート ID は慎重に扱ってください（電話番号の候補は限られているため、ハッシュから候補の電話番号を特定できる可能性があります）。

---

プライバシー

電話番号の生データがログに記録されたり保存されたりすることはありません。ハッシュ化されます（sha256）。MCP の経路は 読み取り専用で、ステートレスです。プライバシーポリシー：https://numbers.online/privacy

料金

完全バンドルは、1 回の呼び出しでまとめて実行される従量制の照会として課金されます（検証＋回線種別＋リスク＋ファーストパーティ DNC を 1 回の呼び出しで実行）。line_type と dnc_check は無料です。現在の料金については https://numbers.online をご覧ください。

---

開発者： Evergrow · 製品： Numbers Online · お問い合わせ先： [email protected] · ライセンス： MIT