Do I need an API key for this MCP?

No. This uses a public API, so you can simply enter 'public' if your client asks for a token.

Which AI clients can use this MCP?

You can use this with any MCP-compatible client, including Claude, Cursor, and Windsurf.

Can I search for countries by their currency?

Yes. The MCP includes a capability specifically to search for countries by their currency name or code.

How do I get specific fields like population?

When using the capability to get all countries, you must specify the fields you need to ensure the request is successful.

Can I filter by region?

Yes. You can filter by large regions like Africa or Asia, or more specific subregions.

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.

An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect REST Countries (Alternative) to ChatGPT and Claude

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Get instant access to country names, currencies, and geographic details.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 12 capabilities

We ship only the actions that matter.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 12 available through REST Countries.

01
Get all countries
This capability pulls data for every country in the database. You must specify which fields you want to retrieve to keep the response clean.
02
Search by capital
Use this to find a country based on its capital city name.
03
Search by code
This capability finds country details using specific country codes.
04
Filter by subregion
This capability narrows down your results to a specific subregion like Northern Europe or South America.

Capability set02 / 03

05-08

4 capabilities in this set.

Part of 12 available through REST Countries.

05
Search by currency
Find countries that use a specific currency name or code.
06
Search by demonym
This capability searches for countries based on what their citizens are called.
07
Search by language
Find countries where a specific language is spoken using the name or code.
08
Filter by independent
This capability filters the list to show only independent nations.

Capability set03 / 03

09-12

4 capabilities in this set.

Part of 12 available through REST Countries.

09
Filter by region
Use this to group countries by large geographic regions like Africa or Asia.
10
Search by codes
This capability allows you to look up multiple countries at once using their codes.
11
Search by name
Find specific country details by entering the country name.
12
Search by translation
This capability finds countries using their names in different languages.

Real work

What teams actually run

Software Development

Verify country codes and currency formats while writing code in your IDE.

Market Research

Identify all countries that use a specific currency to analyze economic clusters.

Educational Research

Quickly pull demographic and regional data for geography projects.

Data Cleaning

Use official names and codes to standardize datasets for analysis.

Automate a task

Put REST Countries to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

REST Countries works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

Building your own app? The connector is yours to use.

You don't need a client to put REST Countries to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

1013ms average. Fast in production.

REST Countries is checked daily against the live service.

Daily averagePeak 1267ms

Oct 3Today

Fastest day: 737ms
Slowest day: 1267ms
14-day trend: Slowing+12%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 12 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of REST Countries, so you can see the experience inside your AI.

It does not authenticate your account with REST Countries. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

REST Countries Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_h2s9sdZxwb6EurasuSmROYaUzGBIX7mmTkFsahoB/mcp

Claude Desktop

Follow the steps below to connect in seconds.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3Click Add and start a new chat — REST Countries capabilities are ready to use.

Configuration · claude_desktop_config.jsonCopy

{
  "mcpServers": {
    "rest-countries-alternative-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_h2s9sdZxwb6EurasuSmROYaUzGBIX7mmTkFsahoB/mcp"
    }
  }
}

Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up REST Countries in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work REST Countries owners hand off.

This MCP is built for professionals who need to pull accurate, real-world geographic and economic data into their AI-driven workflows.

01
Data Analysts
They use the MCP to gather country-level metadata for research and reporting.
02
Developers
They use it to verify ISO codes and currency formats directly within their IDE.
03
Educators
They use the capability to explore global facts and regional statistics with students.

FAQ

Questions REST Countries owners ask.

01
Do I need an API key for this MCP?
No. This uses a public API, so you can simply enter 'public' if your client asks for a token.
02
Which AI clients can use this MCP?
You can use this with any MCP-compatible client, including Claude, Cursor, and Windsurf.
03
Can I search for countries by their currency?
Yes. The MCP includes a capability specifically to search for countries by their currency name or code.
04
How do I get specific fields like population?
When using the capability to get all countries, you must specify the fields you need to ensure the request is successful.
05
Can I filter by region?
Yes. You can filter by large regions like Africa or Asia, or more specific subregions.
06
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.
07
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.
08
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.

Explore

More in Data Management

Connect REST Countries to Claude, Cursor, ChatGPT & more

Your AI does the work. We keep it safe and sound.

Each Connector runs inside its own sealed environment.

One switch stops every agent. Instantly.

Spending limits that pause instead of surprise.

We ship only the actions that matter.

01-04

Get all countries

Search by capital

Search by code

Filter by subregion

05-08

Search by currency

Search by demonym

Search by language

Filter by independent

09-12

Filter by region

Search by codes

Search by name

Search by translation

What teams actually run

Software Development

Market Research

Educational Research

Data Cleaning

Building your own app? The connector is yours to use.

REST Countries Connector

Claude Desktop

Data Analysts

Developers

Educators

Do I need an API key for this MCP?

Which AI clients can use this MCP?

Can I search for countries by their currency?

How do I get specific fields like population?

Can I filter by region?

How do I retrieve a list of all countries with specific data points?

Can I find countries based on the currency they use?

Is it possible to filter countries by their geographic region?

REST Countries AI Connector

Hevo Data (ETL & Data Pipeline) AI Connector

Data.gov Catalog AI Connector

data.world AI Connector

Suggestions

Data Pipeline Prover AI Connector

Integrate.io (ETL & Data Integration) AI Connector

USITC DataWeb (International Trade Commission) AI Connector

Alation AI Connector