How to Use the REST Countries MCP in Windsurf

Q: How does Windsurf use REST Countries to automate localization?

Cascade calls getcountriesbylanguage to find target regions, then writes the translation files directly to your workspace. It handles the API call and the file creation in a single autonomous chain.

Q: Can Windsurf fetch all global records at once via REST Countries?

Yes, Windsurf uses the getallcountries tool to pull the entire global dataset. Cascade then parses this list to seed your local database or generate mock data without manual intervention.

Q: How do I configure this MCP Server in my Windsurf settings?

Open your mcpconfig.json file in Windsurf and paste the server configuration under the mcpServers key. Once saved, Cascade instantly discovers the six country-query tools.

Put Cascade to work mapping global markets by letting Windsurf query live country, currency, and language data on its own.

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 Windsurf

Create your Vinkius account to connect REST Countries to Windsurf — 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Auto-map regional markets with Windsurf and REST Countries

The `get_countries_by_region` tool feeds geographic lists directly to Windsurf so Cascade can map out regional markets without you writing manual API requests. You give Cascade a goal like finding all European territories using the Euro, and it initiates the search, pulls the regional list, and filters the results in one go. It doesn't stop at fetching. Cascade takes those records and immediately updates your local project config files or database seeds. You just watch the terminal as the files write themselves.

Let Cascade audit currencies across territories

The `get_countries_by_currency` tool lets Cascade scan global financial nodes to verify which territories accept specific currencies. Cascade runs this check, spots inconsistencies in your pricing tables, and corrects them on the fly. You don't have to guide it step-by-step. If Cascade notices a currency code changes, it uses `get_country_by_code` to double-check the ISO standards and updates your database schema instantly.

Localize codebases using Cascade and this MCP Server

The `get_countries_by_language` tool lets Windsurf scan language distributions to determine where to deploy localized UI assets. Cascade automatically matches your localization files against the actual spoken languages of target territories. By combining this with `get_all_countries`, Cascade builds a complete localization map for your app. It handles the entire sequence, creating the translation keys and mapping them to the correct ISO codes.

Setup guide

Set up REST Countries MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
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

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my REST Countries payment history." If connected, Cascade will call the REST Countries tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "rest-countries-mcp": {
      "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 Windsurf

Cascade calls `get_countries_by_language` to find target regions, then writes the translation files directly to your workspace. It handles the API call and the file creation in a single autonomous chain.

Yes, Windsurf uses the `get_all_countries` tool to pull the entire global dataset. Cascade then parses this list to seed your local database or generate mock data without manual intervention.

Cascade reads the error output from the failed tool call, adjusts its search parameters, and tries an alternative like `get_country_by_name`. You don't need to manually re-run the prompt.

Open your `mcp_config.json` file in Windsurf and paste the server configuration under the `mcpServers` key. Once saved, Cascade instantly discovers the six country-query tools.

No, the server only sends your query parameters—like currency codes or country names—to the REST Countries endpoint. Your local workspace files and database credentials remain completely private within Windsurf's local sandbox.

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