Skip to content
Vinkius

CountryStateCity Connector for AI agents.

6 live capabilities

Get accurate global geographic data and ISO codes for your apps.

Live agent request CountryStateCity / Connector

Waiting for input…

AI Agent

Why people use CountryStateCity

CountryStateCity for Accurate Geographic Data Validation

With this Connector, you just ask. Your agent pulls the data directly from a verified source, putting the right codes and coordinates in your project instantly.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • Visual Studio Code
  • Windsurf

What Vinkius changes

You get accurate geographic data for your app without the manual research.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

  1. Real-world use case 01

    Populating a multi-region signup form

    A developer needs a list of countries for a signup form.

  2. Real-world use case 02

    Validating shipping zones for a state

    A logistics lead needs to see all cities in New York.

  3. Real-world use case 03

    Cleaning up messy address data

    An analyst has a list of California and needs to know it's a state in the US.

Complete set · 6capabilities

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 Capability

    Get state

    Get detailed information for a specific state or province. This provides the necessary context for regional data points.

  2. 02 Capability

    List cities by state

    Pull a complete list of cities for a given state. It's great for populating local search results or delivery zones.

  3. 03 Capability

    List countries

    Get a full list of all countries with their ISO codes, phone codes, and emojis. This helps you build accurate country selection menus.

Capability set02 / 02

04—06

3 capabilities in this set.

Part of 6 available through CountryStateCity.

  1. 04 Capability

    List states

    Retrieve every state or province within a specific country. Use this to map out regional divisions for any nation.

  2. 05 Capability

    List cities by country

    List every city in a country. This capability is perfect for high-level geographic mapping on the Supporter+ tier.

  3. 06 Capability

    Get country

    Fetch specific details like coordinates and currency for a single country. Use it to get precise location metadata for your database.

Set up in minutes

One URL. Then ask CountryStateCity to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use CountryStateCity from the conversation.

Choose your client

Live preview
Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP
https://edge.vinkius.com/vk_preview_84Tzke4E2WhwikYMpRcFHGTsTtK4ZRJ3G2gMigKE/mcp
  1. Step 01

    Open Connectors

    In Claude Web or Claude Desktop, open Settings and choose Connectors.

  2. Step 02

    Add the URL

    Choose Add custom connector, name it CountryStateCity, and paste the URL above.

  3. Step 03

    Turn it on in chat

    Select +, open Connectors, and enable CountryStateCity for the conversation.

Where the request belongs

Work CountryStateCity can move forward.

Built around the request

This is for the developer who's tired of manually mapping ISO codes or the logistics manager trying to validate shipping zones without a headache.

01

Backend Developer

Building a multi-region app and needing to populate dropdowns with real country and state data.

02

Data Analyst

Cleaning up a messy CSV of addresses and needing to verify which city belongs to which province.

03

E-commerce Manager

Setting up shipping zones and needing to map out every city in a specific country for delivery.

Build the capability set

Add more capabilities.

Each Connector adds new actions and data without changing how you work.

Browse Connectors
Zippopotam.us logo
01 2 capabilities

Zippopotam.us

Free geocoding and postal code lookup. retrieve city, state, and coordinates for any zip code or find postal codes by city.

View Connector
Smarty logo
02 7 capabilities

Smarty

Equip your AI with enterprise-grade location intelligence to validate, autocomplete, and extract US or International addresses instantly.

View Connector
OpenCage logo
03 10 capabilities

OpenCage

Geocode addresses and reverse-geocode coordinates via OpenCage. convert locations to lat/lng and back with country, language, and privacy filters from any AI agent.

View Connector
Geocodio logo
04 10 capabilities

Geocodio

Empower geocoding via Geocodio. perform batch geocoding and reverse geocoding for US/Canada, and retrieve Census and legislative data directly from any AI agent.

View Connector
ZIP Codes API logo
05 6 capabilities

ZIP Codes API

Manage ZIP code data. audit locations, distances, and regions via AI.

View Connector
REST Countries logo
06 6 capabilities

REST Countries

Manage your global research. audit country records, currencies, and languages via AI.

View Connector

Bring your own AI

Change the model, client or framework. Keep CountryStateCity connected.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • VS Code
  • Windsurf
  • ZCode
  • Cline
  • Zed
  • Continue
  • Kiro
  • Roo Code
  • Zencoder
  • Goose
  • Void
  • Augment Code
  • Amp
  • Qodo
  • Tabnine
  • Pieces
  • Sourcegraph Cody
  • JetBrains
  • Warp
  • Amazon Q
  • Antigravity
  • BoltAI
  • Raycast
  • Jan
  • LM Studio
  • AnythingLLM
  • Open WebUI
  • Msty
  • Cherry Studio
  • LibreChat
  • TypingMind
  • Chorus
  • 5ire
  • n8n
  • LangChain
  • LlamaIndex
  • CrewAI
  • Vercel AI SDK

Before you connect

Questions about CountryStateCity.

The practical details behind the request, access and result.

Does CountryStateCity MCP provide ISO codes?

Yes, it provides ISO2 and ISO3 codes for countries. This helps you build accurate database entries without manual research.

Can I use CountryStateCity MCP to get coordinates?

Yes, it provides latitude and longitude. You can use this to plot locations on a map or store them in your database.

Does CountryStateCity MCP work for all countries?

Yes, it is a global database. It covers countries, states, and cities worldwide for your projects.

Can CountryStateCity MCP list cities by state?

Yes, it has a specific capability for that. This makes it easy to build regional navigation or shipping lists.

Is CountryStateCity MCP good for shipping apps?

Yes, it helps map regions. You can verify which cities belong to which states to define your delivery zones.

How do I get city data with CountryStateCity MCP?

You can use the city listing capabilities to pull data for a specific state or country. This ensures your app has the correct regional details.

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.

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.

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.

One connection away

Give your agent a direct line to CountryStateCity.

Connect CountryStateCity once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available