REST Countries Connector for AI agents.
12 live capabilities
Get real-time global geography and demographic data for your projects.
Waiting for input…
Why people use REST Countries
REST Countries for Global Demographic Data
With this Connector, your agent just handles it. You ask for a list of currencies in a region, and it pulls the data instantly. You get a clean list of facts without the manual copy-pasting.
What Vinkius changes
You get instant access to global data without any manual research.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Building a travel app
A developer needs to know which currency to show for 50 different countries.
- Real-world use case 02
Analyzing regional trends
A researcher needs to find all countries in South America to analyze economic trends.
- Real-world use case 03
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.
Complete set · 12capabilities
The complete REST Countries capability set.
These are the exact actions your AI can choose when you ask it to work with REST Countries.
01—04
4 capabilities in this set.
Part of 12 available through REST Countries.
- 01 Capability
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.
- 02 Capability
Search by capital
Find a country by its capital city. This is great for quick lookups when you only know the main city.
- 03 Capability
Search by code
Find a country using its international code. It works perfectly for verifying ISO 3166-1 values.
- 04 Capability
Search by codes
Look up multiple countries at once using their codes. This saves time when you have a list of codes to check.
05—08
4 capabilities in this set.
Part of 12 available through REST Countries.
- 05 Capability
Search by currency
Find countries based on their currency name or code. Use this to map out economic zones.
- 06 Capability
Search by demonym
Find a country by what its citizens are called. It's a specific way to filter nations based on identity.
- 07 Capability
Filter by independent
See which nations are independent. This helps filter out territories and colonies.
- 08 Capability
Search by language
Find countries by their official languages. It's useful for linguistic research or localization tasks.
09—12
4 capabilities in this set.
Part of 12 available through REST Countries.
- 09 Capability
Search by name
Look up a country by its common or official name. This is the standard way to get basic country facts.
- 10 Capability
Filter by region
Group countries by continents or major regions. Use this to analyze geographic clusters.
- 11 Capability
Filter by subregion
Narrow down countries by specific subregions like Northern Europe. It provides more granular geographic data.
- 12 Capability
Search by translation
Find countries using translated names. This helps when you're working with non-English data.
Set up in minutes
One URL. Then ask REST Countries to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use REST Countries from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_h2s9sdZxwb6EurasuSmROYaUzGBIX7mmTkFsahoB/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it REST Countries, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable REST Countries for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_h2s9sdZxwb6EurasuSmROYaUzGBIX7mmTkFsahoB/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the REST Countries URL.
- Step 03
Save and start
Save the connection and enable REST Countries in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"rest-countries-alternative": {
"url": "https://edge.vinkius.com/vk_preview_h2s9sdZxwb6EurasuSmROYaUzGBIX7mmTkFsahoB/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using REST Countries
Open Agent mode in chat and ask: "Using REST Countries, help me...". 12 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"rest-countries-alternative": {
"url": "https://edge.vinkius.com/vk_preview_h2s9sdZxwb6EurasuSmROYaUzGBIX7mmTkFsahoB/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using REST Countries
Ask Copilot: "Using REST Countries, help me...". 12 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"rest-countries-alternative": {
"url": "https://edge.vinkius.com/vk_preview_h2s9sdZxwb6EurasuSmROYaUzGBIX7mmTkFsahoB/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using REST Countries
Open Cascade and ask: "Using REST Countries, help me...". 12 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"rest-countries-alternative": {
"url": "https://edge.vinkius.com/vk_preview_h2s9sdZxwb6EurasuSmROYaUzGBIX7mmTkFsahoB/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using REST Countries
Ask Cline: "Using REST Countries, help me...". 12 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add rest-countries-alternative --transport http "https://edge.vinkius.com/vk_preview_h2s9sdZxwb6EurasuSmROYaUzGBIX7mmTkFsahoB/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using REST Countries
Ask Claude: "Using REST Countries, show me...". 12 tools are ready
Where the request belongs
Work REST Countries can move forward.
This is for the data analyst cleaning messy global datasets, the app developer building a travel platform, and the educator who needs accurate geography facts without the manual search.
Data Analyst
You use this to verify ISO codes and currency mappings in a large dataset to ensure everything is consistent.
App Developer
You use this to build features that display regional data or local languages for international users.
Geography Educator
You use this to quickly pull facts about subregions and demographics to create accurate lesson plans.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsREST Countries
Manage your global research. audit country records, currencies, and languages via AI.
World Bank Countries
The definitive geographic metadata API for resolving country ISO codes, geographic regions, and global income/lending classifications.
CountryStateCity
Access global geographic data. list countries, states, and cities with ISO codes and metadata directly from any AI agent.
World Bank Population
Access demographic data, total populations, poverty headcount, and inequality (Gini) statistics instantly from the World Bank.
Country Data Resolver
Resolve ISO country codes to full names, alpha-3, and numeric codes in 4 languages. Essential for CRM and international data.
Nationalize
Predict the nationality of a person based on their name using the Nationalize.io API.
Bring your own AI
Change the model, client or framework. Keep REST Countries 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 REST Countries.
The practical details behind the request, access and result.
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 capability. 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 capability 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 capability with values like 'Europe', 'Americas', 'Asia', 'Africa', or 'Oceania' to get a list of countries in that specific part of the world.
One connection away
Give your agent a direct line to REST Countries.
Connect REST Countries once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available