• ISO DATA
  • LOCAL INFO
  • STRUCTURED
  • HUMAN

How to retrieve ISO codes and regional metadata with your AI

Connect the CountryStateCity MCP to your agent once. After that, your AI handles all the location data lookups for you.

Ask AI about this page

Short answer

How can I get ISO codes and regional data using AI?

Your AI uses the CountryStateCity MCP to fetch specific location details like ISO codes, phone prefixes, and currencies. It turns plain text names into structured metadata instantly. You'll get precise data for any country or state you name.

Data outcomes

Where your data lands.

The AI processes your location requests and organizes the results into these categories.

ISO DATA

Standardized codes

The AI extracts ISO2 and ISO3 codes for countries and states. This makes your data ready for databases or shipping APIs.

LOCAL INFO

Phone and currency

Your agent pulls the correct phone calling codes and local currency symbols. It maps these directly to the location you provided.

STRUCTURED

Clean metadata

The AI converts messy address strings into clean, structured regional metadata. You get organized objects instead of raw text.

HUMAN

Review required

You decide if the extracted codes match your specific business logic. The AI provides the data, but you confirm the accuracy.

The workflow

What your AI does when a location is mentioned.

The AI acts as a bridge between your text and a structured geographic database.

  1. Identify location

    The AI scans your prompt to find a specific country or state name.

    get_country

  2. Fetch country details

    The agent pulls the ISO codes, currency, and phone prefix for that nation.

    get_country

  3. Drill down to states

    If you need more granularity, the AI looks up the specific state within that country.

    get_state

  4. Format output

    The AI organizes the retrieved metadata into the format you requested.

    get_state

Try it

Copy these to start.

Use these prompts to trigger the data extraction immediately.

Starting points

Swap the bracketed locations for the actual places you are working with.

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"
    }
  }
}
Copy into chat04

  • Get the ISO3 code and currency for [Japan].

  • What is the phone calling code for the state of [California]?

  • Find the ISO2 code for [Germany] and list its currency.

  • Extract the regional metadata for [France] from this spreadsheet.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect CountryStateCity once, then ask.

One click connects the MCP to your client. Your credentials stay encrypted and the setup is handled on our end.

Connect CountryStateCity to your AI

FAQ

How this task behaves.

  • 01

    Can the AI change the actual ISO standards?

    No. The AI only retrieves existing, standardized codes from the database.

  • 02

    Does the AI automatically update my database?

    No. The AI provides the data to you in your chat interface; you must move it to your database yourself.

  • 03

    Can I get coordinates like latitude and longitude?

    No. This MCP is limited to ISO codes, phone prefixes, and currency data.

  • 04

    Will it work with any location name?

    It works with any location recognized by the underlying database tools.

  • 05

    Does the AI handle typos in country names?

    The AI's ability to handle typos depends on your specific AI client's reasoning capabilities.

  • More questions about CountryStateCity? The Connector page answers them. See everything the CountryStateCity Connector can do

Connect CountryStateCity to Claude, Cursor, ChatGPT & more