How to Use the REST Countries MCP in Claude Code

Q: Can I pipe REST Countries output from Claude Code to other CLI tools?

Yes, Claude Code outputs clean JSON from tools like getcountriesbycurrency that you can pipe directly to jq, grep, or local shell scripts. This makes it easy to automate terminal-based workflows.

Q: How do I configure REST Countries as an MCP Server in Claude Code?

Run claude mcp add --transport http rest-countries-mcp -- in your terminal. Claude Code saves this to your local configuration so you can start querying immediately.

Q: Can Claude Code run batch queries across multiple regions?

Yes, you can instruct Claude Code to run getcountriesbyregion for multiple subregions sequentially. It executes the commands headlessly and aggregates the results in your terminal.

Pipe live global geographic data straight into your shell scripts and database migrations using Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect REST Countries MCP to Claude Code

Create your Vinkius account to connect REST Countries to Claude Code — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup REST Countries with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Seed databases from the CLI with Claude Code

The `get_all_countries` tool outputs raw global country records directly into Claude Code, allowing you to pipe geographic data straight into SQL seed scripts. You run a single terminal command, and Claude Code fetches the list and formats it as an INSERT statement. This eliminates manual CSV parsing or hunting down outdated SQL dumps. You get fresh, accurate ISO data directly in your terminal, ready to execute against Postgres or MySQL.

Audit production shipping tables via the terminal

The `get_country_by_code` tool lets Claude Code quickly inspect and verify ISO codes in your production database without leaving the CLI. You pass a suspect alpha-2 code, and Claude Code checks it against the live standard to verify its validity. If you need to check regional shipping zones, Claude Code chains this with `get_countries_by_region` to verify that your shipping rates match the correct regional groupings.

Automate localization checks in CI/CD pipelines

The `get_countries_by_language` tool lets Claude Code run automated checks on your translation files during local pre-commit hooks. Claude Code queries the language, checks that your app supports every matching territory, and flags missing locales. You can run this check headlessly in your CI/CD runner. It ensures your deployment fails if a translation file is missing a required regional variant.

Setup guide

Set up REST Countries MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see rest-countries-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest REST Countries transactions." It will automatically discover and invoke the available REST Countries tools.

Terminal

claude mcp add --transport http rest-countries-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the REST Countries MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "rest-countries-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by REST Countries. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect REST Countries now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about REST Countries MCP in Claude Code

Yes, Claude Code outputs clean JSON from tools like `get_countries_by_currency` that you can pipe directly to `jq`, `grep`, or local shell scripts. This makes it easy to automate terminal-based workflows.

Run `claude mcp add --transport http rest-countries-mcp -- ` in your terminal. Claude Code saves this to your local configuration so you can start querying immediately.

Claude Code queries the live endpoint directly to ensure you always get the latest ISO codes and currency updates. For offline use, you can pipe the output of `get_all_countries` to a local JSON file.

Yes, you can instruct Claude Code to run `get_countries_by_region` for multiple subregions sequentially. It executes the commands headlessly and aggregates the results in your terminal.

Only the specific search terms, language names, and ISO codes you query are sent to the REST Countries API. No environment variables, shell history, or terminal outputs are ever exposed.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript