CountryCallingCodes

Country Calling Codes MCP

ホスト型 Country Calling Codes MCP サーバー（サービス 1.4.0）のメタデータのみを掲載するリポジトリです。

| エージェントスキル | Kajdep/countrycalling-codes-skill |

公式レジストリ名：io.github.Kajdep/countrycallingcodesmcp。

ホスト型 MCP

• エンドポイント：https://www.countrycalling.codes/api/mcp
• トランスポート：Streamable HTTP
• 認証：なし
• プロトコル：2025-11-25
• ツール：読み取り専用ツール 11 個（以下を参照）
• リソース：countrycalling://capabilities、countrycalling://coverage、およびテンプレート countrycalling://countries/{code}/phone-input
• ウェブサイト：https://www.countrycalling.codes
• 開発者向けドキュメント：https://www.countrycalling.codes/developers#mcp
• LLM ガイド：https://www.countrycalling.codes/llms-full.md
• スキルマニフェスト：https://www.countrycalling.codes/skill.json
• OpenAPI：https://www.countrycalling.codes/api/calling-codes/openapi.json
• ステータス：https://www.countrycalling.codes/api/calling-codes/status
• レジストリマニフェスト（最新）：https://www.countrycalling.codes/server.json

このリポジトリの server.json は、ウェブサイトで提供されているものと同じドキュメントであり、公式 MCP レジストリにも 1.4.0 としてすでに公開されています。 レジストリへの公開は、この掲載リポジトリではなく、実装リポジトリ（v0-countrycallingcodes の .github/workflows/publish-mcp.yml）から行われます。

機能

アプリやエージェント向けの、読み取り専用の国際電話番号ワークフローです。

• 国および地域の国番号検索（ISO コード、E.164 のダイヤルコード、地域、国内プレフィックス、NANP）
• バージョン管理された番号体系メタデータに基づく、電話番号の分析と一時的な書式設定
• 確認済みの国ペアを対象とした、発信元別のダイヤル方法
• 重複をグループ化するバッチ正規化（最大 100 件）
• 番号の比較、地域の特定、フォーム入力のヒント、書式の診断
• 明示的に指定された IANA タイムゾーン間で重複する通話可能時間帯

すべての MCP ツールには、同じ構造化ペイロードを返す REST 版があります。結果には、ソースを示す evidence と limitations 配列が含まれます。 番号が正しい形式であることは、その番号が割り当て済み、利用中、到達可能、所有済み、または連絡への同意取得済みであることの証明にはなりません。

どのツールをいつ呼び出すか、曖昧さをどう扱うか、CRM の列をどう整理するかといった、エージェント向けの使用ルールは、このリポジトリではなくスキルに記載されています。

MCP クライアントの設定

リモートの Streamable HTTP サーバーに対応しているクライアント向けの設定です。スキルとライブのディスカバリードキュメントで使用されている設定と同じです。

{
  "mcpServers": {
    "country-calling-codes": {
      "type": "streamable-http",
      "url": "https://www.countrycalling.codes/api/mcp"
    }
  }
}

ローカルの stdio ブリッジが必要なクライアントでは、mcp-remote を使用してください。

{
  "mcpServers": {
    "country-calling-codes": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.countrycalling.codes/api/mcp"
      ]
    }
  }
}

そのまま貼り付けて使える設定は、mcp-config.json にあります。

ツール

すべてのツールには readOnlyHint が付与されており、非破壊的で、べき等性があり、閉世界です。電話番号文字列は64文字、ツール引数は64 KiB、JSON-RPC エンベロープは128 KiBに制限されています。

MCP ツール	REST 対応エンドポイント	目的
lookup_country_calling_code	GET /api/calling-codes	233の国と地域を対象に、フリーテキスト／ISO／ダイヤルコード／地域で検索します。レビュー済みのパターンを含めるには、includeExamples を設定してください。
format_international_phone_number	POST /api/phone/format	軽量な一時的フォーマッターです。ステータス、チェック項目、候補、根拠が必要な場合は、analyze_phone_number を優先してください。
get_phone_capabilities	GET /api/capabilities	国ごとのレビュー状況、対応操作、根拠、データセットのバージョン、リクエスト制限を取得します。なじみのない国については、最初に呼び出してください。
analyze_phone_number	POST /api/phone/analyze	バージョン管理された番号計画メタデータに照らして厳密に解析します。国内番号には numberCountryCode が、国際発信プレフィックスには originCountryCode が必要です。
get_dialing_instructions	POST /api/dialing/instructions	レビュー済みの国のペアについて、発信元に応じたダイヤル文字列、手順、パターンを取得します。
normalize_phone_numbers	POST /api/phone/batch	一意に識別された最大100件のレコードを処理します。順序は保持され、レコードごとのエラーを返します。オプションで正規形式による重複グループ化もできます。
compare_phone_numbers	POST /api/phone/compare	解析後の電話番号を比較します。extensionPolicy の既定値は exact です。末尾のみの一致は、同一とは判定されません。
resolve_phone_region	POST /api/phone/region	メタデータに基づく国の候補、または非地理的な番号の分類を返します。位置情報の特定やキャリア検索ではありません。
get_phone_input_rules	GET /api/countries/{code}/phone-input	表示用のプレースホルダーと国内プレフィックスのガイダンスを取得します。入力検証用マスクではありません。
diagnose_dialing_problem	POST /api/phone/diagnose	書式設定の失敗理由を説明し、確認用に範囲を限定したレビュー済みプレフィックス修正案を提示します。
find_calling_windows	POST /api/calling-windows	明示的な IANA タイムゾーンを指定した最大8名の参加者について、重複する営業時間を検索します。期間は1～31日で、夏時間にも対応します。

例（lookup_country_calling_code）：

{
  "code": "GB",
  "includeExamples": true
}

期待される結果には、ダイヤルコードが +44 の英国のレコードが含まれます。

パラメーターとレスポンスの完全な形式については、 スキル API リファレンス およびホストされた OpenAPIを参照してください。 このリポジトリで、これらの仕様の3つ目のコピーをフォークしないでください。

リソース

URI	内容
countrycalling://capabilities	完全な機能ドキュメント（GET /api/capabilities と同じペイロード）
countrycalling://coverage	同じドキュメントの対応範囲ビュー
countrycalling://countries/{code}/phone-input	ISO 3166-1 alpha-2 の1か国について、レビュー済みの入力規則

対応範囲と制限

• 番号計画メタデータ：libphonenumber-js 1.13.12、max metadata、245の国と地域、および対応する非地理的な番号。
• レビュー済みのダイヤルガイドと入力例：AE、AU、BR、CN、DE、FR、GB、IN、IT、JP、SG、US、ZA。ダイヤル手順には、発信元と宛先の両方がレビュー済みである必要があります。
• ディレクトリのデータセット：233の国と地域。
• SMS、通話、HLR/HSS、MNP、キャリア検索、連絡先の変更、外部へのデータ送信には対応していません。
• 電話番号を含むレスポンスと MCP トランスポートのレスポンスには no-store が設定されています。アプリケーションレベルでクライアントごとのクォータはありません。ホスティング側で制限が適用される場合は、429 と Retry-After を尊重してください。

ディレクトリ登録用メタデータ

Name: Country Calling Codes
Description: Calling codes, phone analysis, dialing guidance, batch normalization and calling windows.
Category: Data / Search / Reference / API
Website: https://www.countrycalling.codes
MCP URL: https://www.countrycalling.codes/api/mcp
Registry: io.github.Kajdep/countrycallingcodesmcp
Version: 1.4.0
OpenAPI URL: https://www.countrycalling.codes/api/calling-codes/openapi.json
Skill: https://github.com/Kajdep/countrycalling-codes-skill
Skill manifest: https://www.countrycalling.codes/skill.json
LLM guide: https://www.countrycalling.codes/llms-full.md
Implementation: https://github.com/Kajdep/v0-countrycallingcodes
GitHub listing: https://github.com/Kajdep/countrycallingcodesmcp
Tools: 11 (see table above)
Auth: None
Cost to user: Free/public read-only lookup and analysis

データとプライバシー

このリポジトリには、個人データもデータセットのエクスポートも含まれていません。ホストされている MCP サーバーは読み取り専用です。電話番号の値は一時的に処理され、サービスに保存されることはありません。MCP クライアントやサードパーティのゲートウェイは、それぞれの会話履歴を保持する場合があります。