Servers Playground How we check Add a server Log in

Country Calling Codes

Working · 1.3 s

io.github.Kajdep/countrycallingcodesmcpv1.4.0

Calling codes, phone analysis, dialing guidance, batch normalization and calling windows.

Utilities

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

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

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

analyze_phone_number Read-only

Analyze a number using versioned numbering metadata. National numbers need numberCountryCode; exit prefixes need originCountryCode. Reports uncertainty and rule evidence, never live subscriber status.

phoneNumberstring, required

detailstring

numberCountryCodestring

originCountryCodestring

Country Calling Codes MCP server | mcptry

Tools (11)

analyze_phone_number

read-only

Argument	Type	Description
detail	string
phoneNumber*	string
numberCountryCode	string
originCountryCode	any

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "phoneNumber"
  ],
  "properties": {
    "detail": {
      "enum": [
        "compact",
        "full"
      ],
      "type": "string",
      "default": "compact"
    },
    "phoneNumber": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1
    },
    "numberCountryCode": {
      "type": "string",
      "pattern": "^[a-zA-Z]{2}$"
    },
    "originCountryCode": {
      "$ref": "#/properties/numberCountryCode"
    }
  },
  "additionalProperties": false
}

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.

read-only

Argument	Type	Description
left*	object
right*	any
extensionPolicy	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "left",
    "right"
  ],
  "properties": {
    "left": {
      "type": "object",
      "required": [
        "phoneNumber"
      ],
      "properties": {
        "detail": {
          "enum": [
            "compact",
            "full"
          ],
          "type": "string",
          "default": "compact"
        },
        "phoneNumber": {
          "type": "string",
          "maxLength": 64,
          "minLength": 1
        },
        "numberCountryCode": {
          "type": "string",
          "pattern": "^[a-zA-Z]{2}$"
        },
        "originCountryCode": {
          "$ref": "#/properties/left/properties/numberCountryCode"
        }
      },
      "additionalProperties": false
    },
    "right": {
      "$ref": "#/properties/left"
    },
    "extensionPolicy": {
      "enum": [
        "exact",
        "ignore"
      ],
      "type": "string",
      "default": "exact"
    }
  },
  "additionalProperties": false
}

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.

read-only

Argument	Type	Description
detail	string
device	string
symptom	string
phoneNumber*	string
numberCountryCode	string
originCountryCode	any
destinationCountryCode	any

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "phoneNumber"
  ],
  "properties": {
    "detail": {
      "enum": [
        "compact",
        "full"
      ],
      "type": "string",
      "default": "compact"
    },
    "device": {
      "enum": [
        "mobile",
        "landline",
        "unknown"
      ],
      "type": "string",
      "default": "unknown"
    },
    "symptom": {
      "enum": [
        "format-rejected",
        "call-failed",
        "uncertain-format"
      ],
      "type": "string",
      "default": "uncertain-format"
    },
    "phoneNumber": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1
    },
    "numberCountryCode": {
      "type": "string",
      "pattern": "^[a-zA-Z]{2}$"
    },
    "originCountryCode": {
      "$ref": "#/properties/numberCountryCode"
    },
    "destinationCountryCode": {
      "$ref": "#/properties/numberCountryCode"
    }
  },
  "additionalProperties": false
}

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

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.

read-only

Argument	Type	Description
countryCode	string	Optional ISO 3166-1 alpha-2 country context, such as GB.
phoneNumber*	string	Phone number to format. It is processed ephemerally and is not stored.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "phoneNumber"
  ],
  "properties": {
    "countryCode": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2,
      "description": "Optional ISO 3166-1 alpha-2 country context, such as GB."
    },
    "phoneNumber": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Phone number to format. It is processed ephemerally and is not stored."
    }
  },
  "additionalProperties": false
}

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.

read-only

Argument	Type	Description
detail	string
device	string
phoneNumber	string
originCountryCode*	string
carrierSelectionCode	string
destinationCountryCode*	any

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "originCountryCode",
    "destinationCountryCode"
  ],
  "properties": {
    "detail": {
      "enum": [
        "compact",
        "full"
      ],
      "type": "string",
      "default": "compact"
    },
    "device": {
      "enum": [
        "mobile",
        "landline",
        "unknown"
      ],
      "type": "string",
      "default": "unknown"
    },
    "phoneNumber": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1
    },
    "originCountryCode": {
      "type": "string",
      "pattern": "^[a-zA-Z]{2}$"
    },
    "carrierSelectionCode": {
      "type": "string",
      "pattern": "^[0-9]{2}$"
    },
    "destinationCountryCode": {
      "$ref": "#/properties/originCountryCode"
    }
  },
  "additionalProperties": false
}

get_phone_capabilities

Discover supported countries, per-operation review coverage, evidence, dataset versions and request limits before choosing a phone workflow.

read-only

Argument	Type	Description
operation	string
countryCode	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "operation": {
      "enum": [
        "get_phone_capabilities",
        "analyze_phone_number",
        "get_dialing_instructions",
        "normalize_phone_numbers",
        "compare_phone_numbers",
        "resolve_phone_region",
        "get_phone_input_rules",
        "diagnose_dialing_problem",
        "find_calling_windows"
      ],
      "type": "string"
    },
    "countryCode": {
      "type": "string",
      "pattern": "^[a-zA-Z]{2}$"
    }
  },
  "additionalProperties": false
}

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.

read-only

Argument	Type	Description
locale	string
countryCode*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "countryCode"
  ],
  "properties": {
    "locale": {
      "type": "string",
      "default": "en",
      "maxLength": 35,
      "minLength": 2
    },
    "countryCode": {
      "type": "string",
      "pattern": "^[a-zA-Z]{2}$"
    }
  },
  "additionalProperties": false
}

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.

read-only

Argument	Type	Description
q	string	Free-text search, such as "United Kingdom", "London", or "AUS".
code	string	ISO 3166-1 alpha-2 or alpha-3 code, such as GB or GBR.
limit	integer	Maximum number of countries to return.
region	string	Optional region filter.
dialCode	string	Calling code with or without plus sign, such as +44 or 44.
includeExamples	boolean	When true, include reviewed safe mobile/landline patterns, transformation rules, source URLs, and lastVerified metadata.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free-text search, such as \"United Kingdom\", \"London\", or \"AUS\"."
    },
    "code": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 or alpha-3 code, such as GB or GBR."
    },
    "limit": {
      "type": "integer",
      "maximum": 250,
      "minimum": 1,
      "description": "Maximum number of countries to return."
    },
    "region": {
      "enum": [
        "Africa",
        "Americas",
        "Asia",
        "Europe",
        "Oceania"
      ],
      "type": "string",
      "description": "Optional region filter."
    },
    "dialCode": {
      "type": "string",
      "description": "Calling code with or without plus sign, such as +44 or 44."
    },
    "includeExamples": {
      "type": "boolean",
      "description": "When true, include reviewed safe mobile/landline patterns, transformation rules, source URLs, and lastVerified metadata."
    }
  },
  "additionalProperties": false
}

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

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.

read-only

Argument	Type	Description
detail	string
phoneNumber*	string
numberCountryCode	string
originCountryCode	any

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "phoneNumber"
  ],
  "properties": {
    "detail": {
      "enum": [
        "compact",
        "full"
      ],
      "type": "string",
      "default": "compact"
    },
    "phoneNumber": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1
    },
    "numberCountryCode": {
      "type": "string",
      "pattern": "^[a-zA-Z]{2}$"
    },
    "originCountryCode": {
      "$ref": "#/properties/numberCountryCode"
    }
  },
  "additionalProperties": false
}