How can I list all cities within a specific state or province?

Use the `list_cities_by_state` tool by providing the Country ISO2 code (e.g., 'US') and the State ISO2 code (e.g., 'NY'). The agent will return a list of all cities registered in that region.

Can I get detailed metadata like emojis and phone codes for a country?

Yes! The `get_country` tool allows you to fetch full details for a specific country using its ISO2 code. You can also use `list_countries` with the `fields` parameter to include 'emoji' or 'phonecode' in the results.

Is there a limit when listing all cities in a country?

The `list_cities_by_country` tool requires a Supporter+ tier API key from CountryStateCity. For standard users, it is recommended to use `list_cities_by_state` to query cities in smaller administrative batches.

CountryStateCity MCP Connector for Claude

A+

Access global geographic data — list countries, states, and cities with ISO codes and metadata directly from any AI agent.

6 tools Official Updated Jun 28, 2026 Official Vinkius Partner

More Details Connect to Claude

Connect the CountryStateCity database to your AI agent and instantly retrieve accurate geographic data through natural conversation.

What you can do

Global Country List — Retrieve all countries with their ISO2/ISO3 codes, phone codes, and emojis
State & Province Discovery — List all administrative divisions (states, provinces, regions) for any specific country
City Level Granularity — Drill down into specific cities within a state or fetch all cities in a country (Supporter+ tier)
Detailed Metadata — Access specific fields like latitude, longitude, and currency for precise location context

How it works

Subscribe to this server
Enter your CountryStateCity API Key
Start querying global locations from Claude, Cursor, or any MCP-compatible client

Who is this for?

Developers — quickly find ISO codes and regional IDs without leaving the code editor
Data Analysts — validate geographic hierarchies and clean location data via chat
Logistics & E-commerce — verify shipping regions and city-state relationships instantly

geographic-dataiso-codeslocation-servicesglobal-databaseaddress-validation