REST Countries Connector for AI agents.
6 live capabilities
Get accurate global geographic and demographic data for international research.
Waiting for input…
Why people use REST Countries
REST Countries for Geopolitical and Demographic Data Research
With this Connector, you just tell your agent to find the countries. It pulls the metadata, currencies, and regions in seconds. You get a clean, organized list of facts without ever leaving your workspace.
What Vinkius changes
You get instant access to accurate global geography without managing a database.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Localization planning for a new app
A manager asks which countries speak Spanish to decide where to launch first.
- Real-world use case 02
Market research for a fintech startup
An analyst needs to know every country using the Euro.
- Real-world use case 03
Building a travel site
A developer wants to display flags for every country in Europe.
Complete set · 6capabilities
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—03
3 capabilities in this set.
Part of 6 available through REST Countries.
- 01 Capability
Get all countries
Fetch a complete list of all countries globally. This is perfect for building a baseline of all nations for a project.
- 02 Capability
Get countries by currency
See every country that uses a specific currency. Use this to understand the reach of various financial systems.
- 03 Capability
Get countries by language
Identify every nation where a specific language is spoken. This helps with planning localization and translation efforts.
04—06
3 capabilities in this set.
Part of 6 available through REST Countries.
- 04 Capability
Get countries by region
Group countries by their specific region or subregion. It makes it easy to see geographic distributions at a glance.
- 05 Capability
Get country by code
Search for a country using its ISO alpha-2 or alpha-3 code. This is the most precise way to look up specific country metadata.
- 06 Capability
Get country by name
Find a country by its common or official name. This lets you pull data using the names people actually use in conversation.
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_Eh0MtHpoi0C2NRJdGdbmp9PlmI50p31GguSlRlkN/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_Eh0MtHpoi0C2NRJdGdbmp9PlmI50p31GguSlRlkN/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": {
"url": "https://edge.vinkius.com/vk_preview_Eh0MtHpoi0C2NRJdGdbmp9PlmI50p31GguSlRlkN/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...". 6 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"rest-countries": {
"url": "https://edge.vinkius.com/vk_preview_Eh0MtHpoi0C2NRJdGdbmp9PlmI50p31GguSlRlkN/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...". 6 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"rest-countries": {
"url": "https://edge.vinkius.com/vk_preview_Eh0MtHpoi0C2NRJdGdbmp9PlmI50p31GguSlRlkN/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...". 6 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"rest-countries": {
"url": "https://edge.vinkius.com/vk_preview_Eh0MtHpoi0C2NRJdGdbmp9PlmI50p31GguSlRlkN/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...". 6 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add rest-countries --transport http "https://edge.vinkius.com/vk_preview_Eh0MtHpoi0C2NRJdGdbmp9PlmI50p31GguSlRlkN/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...". 6 tools are ready
Where the request belongs
Work REST Countries can move forward.
This is for the localization manager tired of manual audits, the international researcher needing facts fast, and the analyst mapping out global markets.
Localization Manager
Verifies language support across different regions to plan app rollouts on a Tuesday afternoon.
International Researcher
Pulls demographic markers and geopolitical data for global reports without opening a browser.
Data Analyst
Maps out currency zones and regional clusters for market research projects.
Operations Lead
Automates data gathering for cross-functional international teams to keep everyone on the same page.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsREST Countries
Access comprehensive global data including country names, capitals, currencies, and languages via the REST Countries API.
World Bank Countries
The definitive geographic metadata API for resolving country ISO codes, geographic regions, and global income/lending classifications.
World Bank Population
Access demographic data, total populations, poverty headcount, and inequality (Gini) statistics instantly from the World Bank.
Knoema
Access global statistics. search datasets, retrieve time-series data, and audit economic indicators.
Nationalize
Predict the nationality of a person based on their name using the Nationalize.io API.
Eurostat Demographics — EU Population & Labor
EU demographics and labor market: population by age and sex, monthly unemployment rates, employment data, immigration by citizenship, life expectancy, and minimum wages for all 27 EU member states.
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 REST Countries MCP to find which countries speak French?
Yes, it can identify all countries where a specific language is an official tongue. This helps you quickly map out translation requirements for your projects.
Does REST Countries MCP provide population data?
It retrieves population counts and capitals for countries you search for. This is great for getting a quick demographic snapshot of a region.
Can I use this to find countries by their currency?
Yes, you can ask your agent to list all nations using a specific currency. This is useful for understanding global financial reach.
Is REST Countries MCP good for localization projects?
It's great for identifying language regions and country clusters for app rollouts. It helps you see which markets need specific support.
Can I get the official flags for countries?
Yes, it provides the official flag and geographic coordinates for any country ID. This is perfect for building visual maps or travel apps.
Does REST Countries MCP require an API key?
No, it connects directly to a free and open service through Vinkius, making it easy to set up and start using immediately.
Is an API Key required for REST Countries?
No. REST Countries is a free and open service. This server works out of the box without any static credentials required.
Can the agent search for countries by currency?
Yes. Use the get_countries_by_currency capability providing the currency code (e.g., 'EUR'). Your agent will return all countries using that specific currency instantly.
Is population data included?
Yes. Every country record retrieved by your agent includes the most recent official population count available in the database.
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