Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use CountryStateCity with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Access global geographic data. list countries, states, and cities with ISO codes and metadata directly from any AI agent.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 6 capabilities

The complete CountryStateCity capability set.

These are the exact actions your AI can choose when you ask it to work with CountryStateCity.

Capability set01 / 02

01-03

3 capabilities in this set.

Part of 6 available through CountryStateCity.

  1. 01

    List countries

    List all countries

  2. 02

    List states

    List all states/provinces within a specific country

  3. 03

    Get country

    Get details for a specific country

Capability set02 / 02

04-06

3 capabilities in this set.

Part of 6 available through CountryStateCity.

  1. 04

    Get state

    Get details for a specific state

  2. 05

    List cities by country

    Note: Requires Supporter+ tier. List all cities within a specific country

  3. 06

    List cities by state

    List all cities within a specific state

Observed, not estimated

876ms average. Fast in production.

CountryStateCity is checked daily against the live service.

Daily averagePeak 1106ms
Aug 20Today
Fastest day
737ms
Slowest day
1106ms
14-day trend
Stable+4%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 6 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of CountryStateCity, so you can see the experience inside your AI.

It does not authenticate your account with CountryStateCity. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

CountryStateCity Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_84Tzke4E2WhwikYMpRcFHGTsTtK4ZRJ3G2gMigKE/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — CountryStateCity capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "countrystatecity-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_84Tzke4E2WhwikYMpRcFHGTsTtK4ZRJ3G2gMigKE/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions CountryStateCity owners ask.

  • 01

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

    Use the list_cities_by_state capability 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.

  • 02

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

    Yes! The get_country capability 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.

  • 03

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

    The list_cities_by_country capability 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.

Explore

More in Developer Tools

Suggestions