# Country Calling Codes

> Country Calling Codes is a free MCP server for communication. Phone number analysis and international dialing help for agents, keyless and read-only. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://www.countrycalling.codes/developers
- **Repository:** https://github.com/kajdep/v0-countrycallingcodes
- **MCP Registry name:** codes.countrycalling/countrycallingcodes
- **Categories:** communication, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

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

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "countrycallingcodes": {
      "url": "https://www.countrycalling.codes/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/country-calling-codes
