How to Use the Country Data Resolver MCP in Windsurf

Q: How do I add the Country Data Resolver to Windsurf?

Open your mcpconfig.json file or use the Cascade settings menu. Add this MCP server under the mcpServers key, then hit the refresh button in your MCP panel to start using it.

Use the Country Data Resolver MCP Server in Windsurf to turn obscure ISO codes into readable country names instantly.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Country Data Resolver MCP to Windsurf

Create your Vinkius account to connect Country Data Resolver to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Country Data Resolver with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Convert ISO codes inside Windsurf

Cascade needs precise location data to build global applications. You trigger `resolve_country` to pull the full name, alpha-3, and numeric codes from a simple two-letter input. Stop guessing what 'BR' or 'DE' represents in your database. This tool gives your agent the exact mapping it needs to populate your UI components without manual lookups.

Automate international data entry

Windsurf handles the heavy lifting when you feed it raw logs. The agent calls `resolve_country` to translate codes into four supported languages, ensuring your records stay clean. Your IDE context stays accurate when your agent handles the conversion logic. It prevents entry errors by relying on the server's definitive source for country metadata.

Chain geography tools in Cascade

Cascade sequences multi-step tasks by chaining this MCP server with other data tools. You set the goal, and it resolves the code before updating your files. Managing international data is no longer a bottleneck. The agent reads the code, fetches the details via `resolve_country`, and writes the result directly into your codebase.

Setup guide

Set up Country Data Resolver 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 Country Data Resolver 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 Country Data Resolver payment history." If connected, Cascade will call the Country Data Resolver tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "country-data-resolver-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 i18n-iso-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 Country Data Resolver 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 Country Data Resolver MCP in Windsurf

Open your mcp_config.json file or use the Cascade settings menu. Add this MCP server under the mcpServers key, then hit the refresh button in your MCP panel to start using it.

Yes, once connected, Cascade discovers the tool and uses it when you ask for country details. You just provide the code, and the agent does the rest.

Absolutely, if you point your agent at your database files, it can use the tool to replace shorthand country codes with full names. It automates the cleanup process in seconds.

It returns the official country name in English, Portuguese, Spanish, or French. It also provides the alpha-3 and numeric ISO codes for every request.

Your privacy is protected because the server only touches ISO country codes. It does not store or process sensitive user records or personal identifiers.

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