Skip to content
MCP server

Country Calling Codes

Phone number analysis and international dialing help for agents, keyless and read-only

Status and history

Answered our latest tool-list check 21 hours ago with 11 tools. It will be marked verified after 3 successful checks in 7 days.

Pricing
Free
Platforms
Web, API
Runs
Remotely
Version
1.4.0
Listing updated
3 days ago

About Country Calling Codes

Country Calling Codes is a free MCP server for communication. It runs as a hosted remote server, so there is nothing to install locally.

Analysis rests on libphonenumber-js 1.13.12 metadata for 245 countries and territories, with editorially reviewed guides for 20 of them including the US, UK, Germany, India and Japan. A 200 response only means the request was processed: the result can still come back as needs-context, ambiguous, unsupported or invalid, so the caller is meant to inspect it.

Nine MCP tools cover analysing a number, producing dialing instructions, normalising batches, comparing numbers, resolving a region, input rules, diagnosing dialing problems and finding sensible calling windows. A capabilities tool reports coverage and dataset versions before you rely on a workflow.

There is no API key, OAuth or per-request fee. Responses containing phone numbers are not cached, and the docs advise keeping numbers out of URLs and logs.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://www.countrycalling.codes/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "countrycallingcodes": {
      "url": "https://www.countrycalling.codes/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "countrycallingcodes": {
      "type": "http",
      "url": "https://www.countrycalling.codes/api/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "countrycallingcodes": {
      "serverUrl": "https://www.countrycalling.codes/api/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "countrycallingcodes": {
      "type": "http",
      "url": "https://www.countrycalling.codes/api/mcp"
    }
  }
}

Tools this server provides (11)

Read directly from the server.

get_phone_capabilities
Discover supported countries, per-operation review coverage, evidence, dataset versions and request limits before choosing a phone workflow.
analyze_phone_number
Analyze 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_instructions
Prepare 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_numbers
Normalize 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_numbers
Compare two numbers after analysis. Missing context produces indeterminate. Extensions must match unless extensionPolicy is explicitly ignore; equality does not establish ownership.
resolve_phone_region
Resolve a phone number to metadata-backed country candidates or non-geographic numbering. Results are numbering assignments, not current location or carrier.
get_phone_input_rules
Get reviewed display placeholders and trunk-prefix guidance. Examples are not validation masks. English fallback and unsupported editorial coverage are explicit.
diagnose_dialing_problem
Explain formatting issues and propose reviewed prefix repairs for confirmation. Uses the same analyzer. Cannot determine why a network rejected a call.
find_calling_windows
Find 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_code
Look 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_number
Normalize 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.

What it does

Number analysis
Parses a number and reports country context and ambiguity.
Dialing instructions
Explains how to dial from one country to another.
Batch normalisation
Normalises many numbers at once.
Calling windows
find_calling_windows suggests suitable times.
Capabilities report
Shows coverage and dataset versions.
Versioned evidence
Responses carry version headers.

Good for

  • Normalise a contact list to a standard format
  • Work out how to call abroad from a given country
  • Diagnose why a number will not connect
  • Pick call times for another timezone
  • Check coverage before relying on a country

Pricing

Free

No key or per-request fee

Prices change. Check countrycalling.codes before you buy.

Country Calling Codes FAQ

Does it need an API key?

No key, OAuth or per-request fee.

How many countries are covered?

245 countries and territories in the analysis metadata.

Can it place a call?

No. All operations are read-only.

Why might a valid request return no answer?

Analysis can return needs-context, ambiguous or unsupported.

Is Country Calling Codes free?

Yes. Country Calling Codes is free to use.

How do I add Country Calling Codes to Claude Code?

Run this command in your terminal: claude mcp add --transport http countrycallingcodes https://www.countrycalling.codes/api/mcp

What are the best alternatives to Country Calling Codes?

The closest alternatives to Country Calling Codes are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Country Calling Codes

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools