numberbroom-mcp

NumberBroom MCP サーバー

AI エージェントが NumberBroom API を通じて米国の電話番号を確認できるリモート MCP サーバーです。回線種別、通信事業者名、切断されている可能性を示すフラグ付きのアクティビティスコア、既知の訴訟提起者であるかどうかを確認できます。また、クレジットの追加や、リスト全体の照合作業の支払い用リンクをユーザーに案内できます。

すべてのツール呼び出しは https://numberbroom.com/api/v1 へのリクエストとなり、レート制限、請求、返金、不正利用対策は同 API が担います。このラッパーが利用する REST API については、numberbroom.com/developers をご覧ください。

ツール

ツール	説明	費用
verify_phone_number	米国の電話番号を1件確認し、回線種別、通信事業者、アクティビティスコア、既知の訴訟提起者であるかどうかのフラグを返します。このフラグは、裁判所への提出書類においてTCPA、FDCPA、FCRA、CFPBに関する訴訟と結び付けられた番号を対象とします。該当する法律の種類は示されず、訴訟提起者をすべて網羅するデータベースはありません。	NumberBroom クレジットから1回の呼び出しにつき$0.20。アカウントをAWS Marketplace経由で連携している場合は、AWSの請求に含まれます。解析できない番号と米国外の番号は課金されません。
get_credit_balance	NumberBroom アカウントのプリペイド残高、または照合料金がAWS Marketplace経由で請求されるかどうかを返します。	無料。
buy_credits	アカウントにクレジットを追加するためのStripe Checkoutリンクを返します。	呼び出しは無料です。支払いはStripeで行います。
scrub_list	最大10,000件の番号リストをNumberBroomの有料リスト照合作業に送り、料金とStripe Checkoutリンクを返します。	呼び出しは無料です。リストごとにカードで支払います。
get_list_status	リスト照合作業のステータスと件数を返します。完了後は、1時間有効なダウンロードリンクを利用できます。リンクから、照合済みファイル、削除された行とその理由（Do Not Call Registryとの一致は件数に含まれますが、一覧には表示されません）、既知の訴訟提起者のみを抽出したリスト、および米国外の番号の行をダウンロードできます。米国外の番号は照合も課金もされません。	無料。

クライアントの接続

サーバーのURLは https://numberbroom.com/mcp です。接続方法は2つあります。

• サインイン（OAuth）。 サインインして接続するクライアントは、サーバーからの401チャレンジを通じて認可サーバーを検出します。NumberBroom アカウントにサインインするか、新しいアカウントを作成し、アカウントにクレジットがない場合は追加してから、アクセスを承認します。クライアントにはトークンが渡され、基盤となるAPIキーは接続内に保持されます。接続はNumberBroomの設定からいつでも解除できます。クライアント登録にはClient ID Metadata Documentのみを使用します。

• APIキーのヘッダー。 ヘッダーを送信するクライアントは、numberbroom.com/settings から取得したキーを使用できます。

  Authorization: Bearer nb_live_YOUR_KEY
  

各クライアントの詳しいセットアップ手順は、numberbroom.com/mcp-server にあります。ブラウザーで https://numberbroom.com/mcp を開くと、そこにリダイレクトされます。MCP クライアントには影響しません。

ローカルでの開発

npm install
npm run dev

これにより、wrangler dev を使って http://localhost:8787/mcp でサーバーが起動します。OAuthフローには、OAUTH_KV バインディング（wrangler dev のローカル環境で設定）と MCP_INTERNAL_SECRET シークレットが必要です。

デプロイ

npm run deploy

Cloudflareアカウントに numberbroom-mcp としてデプロイします。デプロイには、wrangler login で認証済みのCloudflareアカウントが必要です。

構築方法

• OAuth には @cloudflare/workers-oauth-provider を使用しています。認証にはNumberBroom独自のサインイン（numberbroom.com/connect）を使用します。承認後、NumberBroomのAPIがサーバー間通信を通じて、このWorkerにアカウント用のキーを渡します。WorkerはそのキーをKV内の暗号化された認可情報にのみ保存します。トークンとコードはハッシュとして保存されます。
• 制限と請求は、NumberBroomのAPIによって一元的に適用されます。キーごとの照合は1日最大5,000件、このサーバー経由の呼び出しは最大500件です（キーに独自の上限が設定されている場合を除きます）。サーキットブレーカーも適用され、照合に失敗した場合は返金されます。
• 上流のエラーページやネットワーク障害は、例外をスローせず、通常のツールエラーとしてエージェントに返されます。
• リクエストごとに独立したMCPサーバーインスタンスを生成し、呼び出し元の間で状態を共有しません。

License

MIT