# Country Data Resolver MCP for AI Agents AI Agent Connect > Country Data Resolver MCP turns country codes into actual data. It maps alpha-2 codes to full names, alpha-3 codes, and numeric identifiers in English, Portuguese, Spanish, and French. It's built for CRM managers and data teams who need to handle international records without guessing. This tool ensures your AI agent always provides the correct, standardized country information for every lead or record it processes. ## Overview - **Category:** utilities - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_tm37vOwzWjviyFCRb5uxiwytK0JJbLlOHfHcAJmh/ai-agent-connect - **Tags:** country, iso, i18n, crm, localization ## Description When your team handles customers from all over the world, a simple two-letter code like 'TL' shouldn't be a mystery. If you're moving data between systems or cleaning up a CRM, you need a way to ensure 'TL' consistently maps to Timor-Leste. This Connector does the heavy lifting by turning those codes into full country names and standardized identifiers. It supports four major languages, making it a go-to for teams working across the Americas, Europe, and beyond. Instead of having your agent guess what a code means, it pulls from a solid ISO 3166-1 database. It's a small but vital piece of the puzzle when you're trying to keep international records clean. You can find this and thousands of other tools in the Vinkius catalog to keep your data accurate. It's about moving from 'I think this is the right country' to 'I know it is.' It helps you maintain a high standard of data integrity without having to manually look up every single entry. Whether you're dealing with a few dozen leads or a database of thousands, this tool provides the certainty you need for global operations. ## Tools ### resolve_country Pass an alpha-2 code and a language to get the full name, alpha-3 code, and numeric ID. This ensures your agent never guesses a country name. ## Prompt Examples **Prompt:** ``` What's the full name for country code BR in Portuguese? ``` **Response:** ``` Country: Brasil (alpha-3: BRA, numeric: 076) ``` **Prompt:** ``` Resolve the country code MK to its full name. ``` **Response:** ``` Country: North Macedonia (alpha-3: MKD, numeric: 807) ``` **Prompt:** ``` Get all ISO codes for Japan. ``` **Response:** ``` Country: Japan (alpha-2: JP, alpha-3: JPN, numeric: 392) ``` ## Capabilities ### Map alpha-2 codes to full names Turn a two-letter code like 'BR' into 'Brazil' automatically. ### Get alpha-3 codes Retrieve the three-letter ISO standard for any country in the database. ### Retrieve numeric identifiers Get the official numeric country code for consistent database entries. ### Translate country names Get country names in English, Portuguese, Spanish, or French. ### Standardize international data Ensure all your international contact records follow the same ISO standards. ## Use Cases ### Cleaning messy CRM data An agent finds a list of 500 leads with only 2-letter codes and uses resolve_country to fill in the full names and alpha-3 codes. ### Multilingual marketing A user asks the agent to generate a list of countries in Spanish, and the agent pulls the correct names for every code automatically. ### Shipping logistics A logistics coordinator needs the numeric ISO codes for a batch of countries to update a shipping manifest without manual searching. ### Global app localization A developer wants to populate a dropdown menu with every country name in French to ensure the UI is localized correctly. ## Benefits - Stop hallucinations: Your agent won't guess what 'MK' means anymore because it uses the data to get the exact name. - Multi-language support: Get country names in Portuguese, Spanish, French, or English automatically to match your local markets. - Data consistency: Keep your database clean by always using the same alpha-3 and numeric codes for every entry. - Faster lead processing: Agents can process international contacts much faster when they don't have to pause to verify a country code. - ISO compliance: Ensure your records meet official ISO 3166-1 standards every time a new contact is added. ## How It Works The bottom line is you get accurate, multi-language country data instantly without manual lookups. 1. Provide an alpha-2 code like 'BR' and a preferred language. 2. The Connector queries the ISO 3166-1 database. 3. You get the full name, alpha-3 code, and numeric code back. ## Frequently Asked Questions **Can the Country Data Resolver MCP handle different languages?** Yes, it provides country names in English, Portuguese, Spanish, and French. This makes it great for global CRMs. **Does this Connector support all countries?** It covers the full ISO 3166-1 database, which includes 249 countries. **How does this help with CRM data?** It takes short country codes and turns them into full names and alpha-3 codes, ensuring your data stays consistent. **Can I use this to get numeric country codes?** Yes, it provides the numeric identifiers along with the names and alpha-3 codes. **Is it good for localization?** It's perfect for localization because it can return names in four different languages automatically. **What happens if I provide an obscure country code?** The Connector will pull the official ISO 3166-1 data for that code, ensuring you don't have to guess the name. **How many countries are supported?** All 249 countries and territories in the ISO 3166-1 standard, including overseas territories and special regions. **What languages are available for country names?** English (en), Portuguese (pt), Spanish (es), and French (fr). The engine defaults to English if the requested language is not available. **Does it validate country codes?** Yes. If you pass an invalid code like 'XX', the engine returns a clear error instead of guessing. This prevents data corruption in CRM systems.