How to Use the Nationalize MCP in Windsurf

Windsurf analyzes names and predicts regional origins directly in your editor using Cascade.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Nationalize MCP to Windsurf

Create your Vinkius account to connect Nationalize 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 Nationalize with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Connect the Nationalize MCP Server

The `predict_nationality` tool takes a name string and returns a probabilistic breakdown of its country of origin. You pass a last name to Cascade, and the agent hits the Nationalize.io API to fetch the demographic distribution. Windsurf uses this data to chain multiple actions together without asking you for permission. If you tell Cascade to build a localized greeting component, it reads the name array, pulls the region codes, and generates the switch statements automatically.

Build region-aware features

Cascade handles the entire data flow when you feed it user lists. It queries the `predict_nationality` tool for each entry, sorts the results by the highest probability score, and maps the output to your database schema. The MCP integration skips the manual API setup entirely. The agent writes the fetch logic, handles the JSON response, and injects the localized strings right into your active file.

Automate demographic testing

Testing localization logic usually requires mocking massive datasets by hand. Windsurf bypasses that by calling the tool directly during test generation, pulling real-world country codes for specific test names. You just ask Cascade to write a test suite for your routing logic. It figures out which names trigger which regional fallbacks, generates the assertions, and runs the tests in your terminal.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "nationalize-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 Nationalize. 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 Nationalize 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 Nationalize MCP in Windsurf

Open your Windsurf settings and navigate to the Cascade MCP Servers UI. Add the server configuration there and hit refresh, or grab it straight from the built-in marketplace.

Yes. Cascade can loop through a JSON array of users and hit the API for each one. Just make sure you provide last names for the highest accuracy.

It accepts any name string. However, you get much better probabilistic matches when you feed it surnames.

The tool returns an array of country IDs paired with probability scores. Cascade parses this JSON automatically so you don't have to write the type definitions.

The MCP Server only transmits the specific text strings you provide to the API. Your raw database records stay local, and the endpoint only sees isolated last names during the request cycle.

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