• ISO NAMES
  • NUMERIC
  • CLEANED
  • MANUAL

How to convert country codes with your AI

Connect this MCP to your AI client once. After that, you can pass any list of country codes to your agent to fix them instantly.

Ask AI about this page

Short answer

How do I convert country codes with my AI?

Your AI uses the resolve_country tool to map two-letter alpha-2 codes to full ISO names and numeric IDs. This turns fragmented data into a clean, standardized format. You'll get a structured output ready for your database or spreadsheet.

The results.

Where your data lands.

The AI processes your raw input and organizes the results into these specific formats.

ISO NAMES

Full country names

The AI replaces short codes like US or FR with the full, official country names. This makes your datasets readable for humans.

NUMERIC

ISO numeric IDs

The tool pulls the specific numeric identifiers for every country provided. You get these for precise database indexing.

CLEANED

Standardized lists

The AI takes a messy string of codes and returns a clean, structured list. It removes the guesswork from your data cleaning.

MANUAL

Human review needed

If a code is too broken to recognize, the AI flags it. You'll need to manually check these specific outliers.

The workflow

What your AI does when the codes arrive.

The AI handles the heavy lifting of looking up international standards so you don't have to.

  1. Identify codes

    Your agent scans your text or file to find any alpha-2 country codes.

    resolve_country

  2. Lookup data

    The AI calls the resolver to fetch the official ISO name and numeric ID for every code found.

    resolve_country

  3. Format output

    The agent organizes the new names and numbers into the structure you requested.

    resolve_country

  4. Flag errors

    The AI identifies any codes that don't match known ISO standards.

    resolve_country

Try it

Copy these to start.

Use these prompts to kick off the task in your chat window.

Starting points

These are just ways to start the conversation. Swap out the specific data sources for your own.

Country Data Resolver Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_tm37vOwzWjviyFCRb5uxiwytK0JJbLlOHfHcAJmh/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 — Country Data Resolver capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "country-data-resolver-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_tm37vOwzWjviyFCRb5uxiwytK0JJbLlOHfHcAJmh/mcp"
    }
  }
}
Copy into chat04

  • Convert these codes from my spreadsheet into full ISO names: US, JP, DE, GB.

  • Look at the country codes in this CSV and give me their numeric identifiers.

  • I have a list of alpha-2 codes in this text file. Can you turn them into a clean table with names and IDs?

  • Check the country codes in this contact list and tell me which ones are invalid.

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

Start here

Connect Country Data Resolver once, then ask.

Just click the link to connect the MCP to your client. Your credentials stay encrypted, and you can start using the tools immediately.

Connect Country Data Resolver to your AI

FAQ

How this task behaves.

  • 01

    Can the AI fix typos in country codes?

    No. The AI relies on the resolve_country tool to match valid codes. If a code is misspelled, the tool won't recognize it.

  • 02

    Will the AI change my original files?

    No. The AI only reads the data you provide and generates new, cleaned information in the chat. It does not write back to your local files.

  • 03

    Does it support three-letter country codes?

    No. This specific tool is designed to resolve alpha-2 codes.

  • 04

    Can it generate a downloadable CSV?

    The AI can format the data as a CSV-style text block that you can copy, but it cannot directly save a file to your hard drive.

  • 05

    What happens if a code is invalid?

    The AI will tell you it couldn't resolve that specific code. You will have to handle those errors yourself.

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

Connect Country Data Resolver to Claude, Cursor, ChatGPT & more