Country Calling Codes
Phone number analysis and international dialing help for agents, keyless and read-only
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/mcpAdd to Settings → Connectors → Add custom connector
https://www.countrycalling.codes/api/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"countrycallingcodes": {
"url": "https://www.countrycalling.codes/api/mcp"
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools