# REST Countries MCP for AI Agents AI Agent Connect > REST Countries. Give your AI agent instant access to global country data like capitals, currencies, and languages. It replaces manual lookups with a direct line to accurate geographic and economic facts for any nation or territory. Use it to pull ISO codes, region filters, and demographic details without leaving your workspace. ## Overview - **Category:** data-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_h2s9sdZxwb6EurasuSmROYaUzGBIX7mmTkFsahoB/ai-agent-connect - **Tags:** geography, country-data, demographics, international-codes, currency-data, rest-api ## Description This Connector gives your AI agent the ability to pull real-world country data on the fly. Instead of your agent guessing which country uses which currency or trying to remember specific ISO codes, it can just ask for the facts. It's built for anyone who needs accurate geographic, economic, or linguistic facts without digging through multiple tabs. Whether you're building a travel app or just need to know which subregion a specific nation falls into, the data is there. It's one of the many tools you can find in the Vinkius catalog to make your agent more capable. You get things like official names, capital cities, and even demonyms for specific nations. It handles the heavy lifting of data retrieval so you can focus on the logic of your project. You don't have to worry about outdated information or inconsistent naming conventions. The data is pulled directly from a reliable source, ensuring that your agent stays grounded in reality. This makes it a go-to for researchers, developers, and anyone who needs to handle international data at scale. You can quickly gather information on independence status, regional clusters, and language mappings. It's about getting the right facts the first time without the friction of manual searching. ## Tools ### get_all_countries Get a full list of countries from around the world. You can specify up to 10 fields to ensure you only get the data points you actually need. ### search_by_capital Find a country by its capital city. This is great for quick lookups when you only know the main city. ### search_by_code Find a country using its international code. It works perfectly for verifying ISO 3166-1 values. ### search_by_codes Look up multiple countries at once using their codes. This saves time when you have a list of codes to check. ### search_by_currency Find countries based on their currency name or code. Use this to map out economic zones. ### search_by_demonym Find a country by what its citizens are called. It's a specific way to filter nations based on identity. ### filter_by_independent See which nations are independent. This helps filter out territories and colonies. ### search_by_language Find countries by their official languages. It's useful for linguistic research or localization tasks. ### search_by_name Look up a country by its common or official name. This is the standard way to get basic country facts. ### filter_by_region Group countries by continents or major regions. Use this to analyze geographic clusters. ### filter_by_subregion Narrow down countries by specific subregions like Northern Europe. It provides more granular geographic data. ### search_by_translation Find countries using translated names. This helps when you're working with non-English data. ## Prompt Examples **Prompt:** ``` What's the currency in Vietnam? ``` **Response:** ``` The official currency of Vietnam is the **Vietnamese Dong (VND)**. Would you like to see more economic details for this country? ``` **Prompt:** ``` List countries in the Middle East. ``` **Response:** ``` Here are the countries located in the Middle East region: * Egypt * Iran * Iraq * Jordan * Kuwait * Lebanon * Oman * Qatar * Saudi Arabia * Syria * Turkey * United Arab Emirates Would you like details on any of these specifically? ``` **Prompt:** ``` What is the ISO code for Canada? ``` **Response:** ``` The official ISO 3166-1 code for **Canada** is **CA**. ``` ## Capabilities ### Fetch country names and capitals Get the official names and primary cities for any nation in the world. ### Verify ISO 3166-1 codes Look up the correct international standard codes for countries and territories. ### Identify languages and currencies Find out which official languages are spoken and what currency is used in a specific country. ### Filter by geographic regions Group nations by continents or specific subregions like Northern Europe or South America. ### Find countries by translation Locate countries using translated names for non-English data sets. ### Check independence status Distinguish between independent nations and various territories. ## Use Cases ### Building a travel app A developer needs to know which currency to show for 50 different countries. They ask the agent to list them all using search_by_currency. ### Analyzing regional trends A researcher needs to find all countries in South America to analyze economic trends. The agent pulls the full list using filter_by_subregion. ### Cleaning messy datasets A data analyst is cleaning a spreadsheet and needs to verify the correct ISO codes for a list of nations using search_by_code. ### Language localization A student wants to know which countries speak Portuguese. The agent identifies them instantly using search_by_language. ## Benefits - Get accurate ISO 3166-1 codes using search_by_code to avoid errors in your database. - Filter nations by continent or subregion using filter_by_region to group your data geographically. - Identify official currencies with search_by_currency to provide correct financial info to your users. - Support multiple languages with search_by_translation for internationalized applications. - Quickly find nations by their capital city using search_by_capital for faster lookups. - Check independence status with filter_by_independent to distinguish between countries and territories. ## How It Works The bottom line is you get instant access to global data without any manual research. 1. Subscribe to the REST Countries MCP on Vinkius. 2. Connect it to your AI client and enter 'public' if it asks for an API token. 3. Ask your agent for specific country facts like currencies, codes, or regional data. ## Frequently Asked Questions **Can I use the REST Countries MCP to find capital cities?** Yes. Your agent can instantly identify the capital city for any nation in the world. This is great for quickly populating database fields or creating travel guides. **How does the REST Countries MCP help with international shipping?** It helps by providing accurate ISO codes and regional data. This ensures your agent provides the correct information for shipping and logistics across different borders. **Does the REST Countries MCP provide population data?** This Connector focuses on geographic, economic, and linguistic facts. While it provides a wealth of metadata, it is best used for structural data like currencies and regions. **Can my agent find countries by their official languages?** Yes. Your agent can filter and identify nations based on their official languages, which is helpful for localization tasks and linguistic research. **Is the REST Countries MCP good for research?** It is excellent for factual research. It gives you a reliable source of truth for country names, codes, and regional clusters without you having to search manually. **Can I get specific data fields using the REST Countries MCP?** Yes. You can request specific fields like currencies or demonyms to keep the data you get clean and relevant to your specific project. **How do I retrieve a list of all countries with specific data points?** Use the `get_all_countries` tool. You must provide a comma-separated list in the `fields` parameter (e.g., 'name,capital,population') to specify exactly which information you want to receive. **Can I find countries based on the currency they use?** Yes! Use the `search_by_currency` tool and provide the currency name or code (like 'euro' or 'USD'). The agent will return all countries where that currency is legal tender. **Is it possible to filter countries by their geographic region?** Absolutely. Use the `filter_by_region` tool with values like 'Europe', 'Americas', 'Asia', 'Africa', or 'Oceania' to get a list of countries in that specific part of the world.