Country Calling Codes

Connect it to your AI

Claude Code

claude mcp add --transport http countrycallingcodesmcp https://www.countrycalling.codes/api/mcp

Claude, ChatGPT, Cursor and other apps

Add it as a custom connector with this URL (Streamable HTTP):

https://www.countrycalling.codes/api/mcp

Cursor, VS Code and other apps (mcp.json)

{
  "mcpServers": {
    "countrycallingcodesmcp": {
      "url": "https://www.countrycalling.codes/api/mcp"
    }
  }
}

Tools it offers

11 tools, as the server itself reported during our check on Oct 31, 2026.

• get_phone_capabilitiesDiscover supported countries, per-operation review coverage, evidence, dataset versions and request limits before choosing a phone workflow.
• analyze_phone_numberAnalyze a number using versioned numbering metadata. National numbers need numberCountryCode; exit prefixes need originCountryCode. Reports uncertainty and rule evidence, never live subscriber status.
• get_dialing_instructionsPrepare origin-specific dialing guidance for reviewed countries. Provide origin and destination separately; no phone number returns safe placeholder patterns. Network-dependent results remain conditional.
• normalize_phone_numbersNormalize up to 100 records with unique IDs. Invalid records produce individual errors. Optionally identify canonical duplicate candidates; no contacts are changed or stored.
• compare_phone_numbersCompare two numbers after analysis. Missing context produces indeterminate. Extensions must match unless extensionPolicy is explicitly ignore; equality does not establish ownership.
• resolve_phone_regionResolve a phone number to metadata-backed country candidates or non-geographic numbering. Results are numbering assignments, not current location or carrier.
• get_phone_input_rulesGet reviewed display placeholders and trunk-prefix guidance. Examples are not validation masks. English fallback and unsupported editorial coverage are explicit.
• diagnose_dialing_problemExplain formatting issues and propose reviewed prefix repairs for confirmation. Uses the same analyzer. Cannot determine why a network rejected a call.
• find_calling_windowsFind overlapping working hours using explicit IANA time zones and dates. Handles overnight shifts and DST; never infers location from phone numbers or contacts participants.
• lookup_country_calling_codeLook up international country calling codes by free text, ISO code, dial code, or region. Optionally return reviewed, source-linked dialing examples. This tool does not verify live subscriber numbers.
• format_international_phone_numberNormalize a phone number into a plausible international format using reviewed country-specific rules. Processing is ephemeral. This tool does not query carriers, HLR/HSS, MNP databases, or live subscribers.

Questions