Areacode.fyi Mcp Server

areacode-mcp

AI エージェント向けの北米番号計画（NANP）の市外局番・電話番号インテリジェンス。

Claude、Cursor、その他のエージェントに、米国とカナダの電話番号体系に関する信頼できる簡潔な情報源を提供する MCP サーバーです。市外局番、NANP の検証、現地時刻、市区町村・州の対象範囲、オーバーレイ、詐欺・なりすましに関する情報を提供します。areacode.fyi を基盤としており、公式の NANPA 番号データベースから直接情報を公開しています。すべての結果に、正式な areacode.fyi URL と情報源の日付が含まれます。

対象範囲。 このサービスが提供するのは、市外局番レベルの参照情報と解説であり、通信事業者・本人確認 API ではありません。発信者の身元、正確な位置情報、または現在の通信事業者（番号移行後を含む）は返しません。また、発信者番号は偽装できるため、電話番号の市外局番から発信者を特定することはできません。発信者の身元確認には、通信事業者向けの高精度なプロバイダー（LRN/HLR）が必要です。

インストール

npx で実行します（インストール不要）。クライアントの MCP 設定に追加してください。

Claude Desktop（claude_desktop_config.json）／Cursor（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "areacode": {
      "command": "npx",
      "args": ["-y", "@riv-lc/areacode-mcp"]
    }
  }
}

これで完了です。クライアントを再起動すると、以下のツールを利用できます。

公式 MCP Registry に io.github.riv-lc/areacode-mcp として、また npm に公開されています。

リモート（ホスト型）— ChatGPT、Claude.ai、ウェブクライアント向け

インストールは不要です。ホスト型サーバーをコネクター URL として追加してください。8 つのツールを同じように利用でき、キーも不要です。

https://mcp.areacode.fyi/mcp

（従来の SSE クライアント向け：https://mcp.areacode.fyi/sse）

ツール

ツール	機能
lookup_area_code	国、州・州相当の地域、市区町村、タイムゾーン、現在の現地時刻、オーバーレイ、近隣の市外局番
lookup_phone_number	NANP 電話番号を解析・検証し、市外局番、地域、現地時刻、E.164 形式を返します
lookup_carrier	電話番号の NPA-NXX ブロックに割り当てられた通信事業者、回線種別（携帯電話／固定電話）、料金センター（ブロック割り当てデータ。現在の通信事業者や番号移行後の情報ではありません。米国・カナダのほぼすべての市外局番を対象としています）
area_codes_for_city	市区町村を対象とする市外局番（必要に応じて州を指定して絞り込み可能）
area_codes_for_state	米国の州またはカナダの州にあるすべての市外局番
is_scam_area_code	市外局番に関する詐欺・なりすましの情報と、その市外局番を使用する番号について FTC の Do Not Call に寄せられた苦情の集計
check_number_reputation	未検証のコミュニティシグナル（低／中／高）に加えて、電話番号に関する公開 FTC Do Not Call 苦情データ（件数、ロボコールの割合、主な苦情の対象）
explain_area_code_topic	情報源に基づく解説：近隣番号のなりすまし、オーバーレイと分割、フリーダイヤル、市外局番と国番号の違い、一時的な電話番号

プロンプト例

• 「見込み客が電話番号 +1 702-555-0199 を入力しました。どのあたりにいる可能性が高く、現地時刻は何時ですか？」
• 「469 から電話がありました。この市外局番は怪しいですか？」
• 「ラスベガスを対象とする市外局番を教えてください。」
• 「米国・カナダの電話番号リストを正規化し、無効な番号やフリーダイヤルをすべて指摘してください。」
• 「ヘルプセンターの記事向けに、近隣番号のなりすましについて説明してください。」

設定

環境変数	デフォルト	用途
AREACODE_API_BASE	https://areacode.fyi	接続先を別のホストに変更します（例：セルフホスト版またはステージング API）

データと情報源

ツールは公開されている https://areacode.fyi/api/v1 JSON API を呼び出します。この API は、サイト上で表示されるものと同じデータセットを読み込みます。データは公式の North American Numbering Plan Administrator（NANPA） データベースから取得され、毎月更新されます。各レスポンスには source、canonical_url、data_date が含まれるため、回答でデータの出典を明記できます。

check_number_reputation のシグナルは未検証のクラウドソーシング情報です（low = その電話番号を検索した人がいる、mid／high = ユーザーから報告が寄せられている）。特定の番号が不正なものであることを示す証拠にはなりません。

License

MIT © Reindex Ventures. Built for areacode.fyi.