NumRadar

@numradar/mcp

AI エージェントから、電話番号が WhatsApp に登録されているか確認できます。

numradarは、ひとつの質問に的確に答えます。この番号は WhatsApp に登録されていますか？ これはnumradarのModel Context Protocolサーバーなので、エージェントから直接この質問ができます。リストの検証、キャンペーン前の連絡先の監査、クレジットを使う前の残高確認などに利用できます。

npx @numradar/mcp --token nr_live_YOUR_KEY

numradar.app/app/keysでキーを作成してください。

---

ほとんどの方は何もインストールする必要はありません

numradar はホスト型MCP サーバーを実行しています。パッケージも、ローカルプロセスも、誰かのノート PC で古くなるバージョンも必要ありません。

https://numradar.app/mcp

その URL をクライアントに設定し、Authorization: Bearer nr_live_... ヘッダーを指定すれば完了です。

{
  "mcpServers": {
    "numradar": {
      "type": "http",
      "url": "https://numradar.app/mcp",
      "headers": {
        "Authorization": "Bearer nr_live_xxx"
      }
    }
  }
}

npm パッケージが必要になるのは、実際にはひとつのケースだけです。 設定ファイルで URL ではなく、起動するコマンドを指定するクライアントの場合です。よくある例は claude_desktop_config.json です。このようなファイルを編集している場合は、パッケージが必要です。

{
  "mcpServers": {
    "numradar": {
      "command": "npx",
      "args": ["-y", "@numradar/mcp", "--token", "nr_live_xxx"]
    }
  }
}

Claude Code、Cursor、Windsurf、Zed、VS Code、Cline など、検証済みの 15 クライアントの設定はnumradar.app/mcp-serverにあります。

ツール

ツール	内容	コスト
validate_number	1 件の番号を確認します。登録の有無、ビジネスアカウントかどうか、回線種別、国を返します。	1 クレジット
bulk_validate	最大 10,000 件の番号を確認します。ジョブ ID をすぐに返します。	確定結果 1 件につき 1 クレジット
get_job_status	進捗カウンターを返します。番号ごとの結果も指定できます。	無料
list_jobs	アカウントの最近の一括処理ジョブを返します。	無料
get_balance	残りのクレジットを返します。	無料

プロンプト

MCP プロンプトに対応しているクライアントでは、これらをスラッシュコマンドとして表示します。

プロンプト	引数	内容
/check_numbers	numbers	リストを検証し、WhatsApp で連絡可能な番号を要約します。
/clean_contact_list	numbers, purpose	キャンペーン前にリストを監査し、修正が必要な項目を報告します。
/check_before_spending	count	実行コストを見積もり、残高が足りるか確認します。

課金について、そしてエージェントの使い方に影響する理由

確定した結果 1 件につき 1 クレジットです。登録済みの場合も、未登録の場合も同じです。それ以外については、次のとおりです。

• 無効な番号や解析できない番号は課金されません。 そのまま送信してください。確信が持てない番号を事前に除外するエージェントは、結局使わないクレジットを節約するために、実際の連絡先を取りこぼしてしまいます。
• 上流で判定できなかった場合も課金されません。
• クレジットの有効期限はありません。

番号は E.164 形式にしてください（+14155550100）。数件を超える場合は、validate_number を繰り返し呼び出すより bulk_validate を使うのがおすすめです。N 回の往復ではなく、ひとつのジョブをポーリングすれば済みます。

オプション

--token <key>	API キーです。NUMRADAR_API_KEY からも読み込まれます。両方が設定されている場合は、このフラグが優先されます。
--base <url>	API のオリジンです。既定値は https://numradar.app です。
--version	バージョンを表示して終了します。
--help	使用方法を表示して終了します。

セキュリティ

API キーは、アカウントへのベアラー認証情報です。--token を指定すると、キーがシェルの履歴とプロセスを起動する設定ファイルに記録されます。クライアントが対応している場合は、シークレットストアの NUMRADAR_API_KEY を使うことをおすすめします。キーはダッシュボードから無効化できます。キーが漏えいした場合は、ただちに無効化してください。

すべてのツール呼び出しは認証され、レート制限が適用され、numradar の通常の公開 REST API 経由で課金されます。MCP サーバーにチェッカーは組み込まれておらず、別の課金経路もありません。そのため、ツールを呼び出すエージェントは curl を呼び出すバックエンドとまったく同じ扱いになります。

このリポジトリについて

ここはnpm パッケージのホームです。課題トラッカーとドキュメントを掲載しています。サーバーのソースコードは非公開のモノレポにあり、ここでは公開されていません。

バグを見つけた場合や、設定がうまく機能しないクライアントがある場合は、 課題を報告してください。

• API ドキュメント
• MCP リファレンスとクライアントごとの設定
• エージェントスキルと Claude Code プラグイン

ライセンス

MIT