A free MCP server for country & geo data

Hosted MCP server for country, city, postal-code, distance and IP-geolocation data. Point Claude, Cursor, ChatGPT or any MCP client at it — live data, no API key.

HTTPhttps://countries.dev/api/mcp
Setup guideAPI reference

Why

The whole REST API, over MCP

One endpoint

Point your client at one HTTPS URL. No key, no account, no local process.

Live data, not guesses

Tools query the real dataset, so the model returns current facts instead of hallucinating.

Read-only and lean

Every tool is a GET. Responses are trimmed by default to keep context small.

Tools

11 tools the model can call

Each is a thin wrapper over a REST endpoint — same data, same shape.

get_country

Full record for one country by ISO code or name.

list_countries

Filter by region, currency, language, calling code or timezone.

search_cities

Cities by name or country, ranked by population.

reverse_geocode

Nearest cities to a lat/lng.

distance

Great-circle distance between two points.

lookup_postal_code

Postal/ZIP code → place and coordinates.

geolocate_ip

Country for an IPv4 or IPv6 address.

get_borders

A country’s neighbours, as full records.

search_places

The full GeoNames gazetteer — peaks, lakes, landmarks.

random_country

A random country.

list_reference_data

All regions, currencies, languages or timezones.

Connect

Add it to your client

Paste the URL or drop it in your config. That's the whole setup.

Claude Code

claude mcp add --transport http countries https://countries.dev/api/mcp

Cursor & other clients

{
  "mcpServers": {
    "countries": { "url": "https://countries.dev/api/mcp" }
  }
}

Wire it into your AI client

Drop countries.dev/api/mcp into Claude, Cursor or ChatGPT. The docs cover per-client setup, all 11 tools and a curl test.

Read the setup guide