How to Use the World Bank Countries MCP in Windsurf

Q: Does this World Bank Countries MCP Server handle multiple regions?

Yes. You can use the searchregions tool to list all available geographic areas first. Then, you feed that regional data into other tools in Windsurf to narrow down your scope.

Map out global data flows: World Bank Countries for Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect World Bank Countries MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Resolve Country Metadata with MCP Server

The `list_countries` tool gives you a definitive list of all World Bank countries. Cascade uses this to resolve ISO codes and get basic geographic data, meaning you don't have to look up country lists anywhere else. You can set a goal—say, 'Get the initial list for my analysis.' Cascade runs `list_countries` automatically, providing the clean dataset you need immediately.

Search Income Levels with Windsurf

Need to filter by economic status? The `search_income_levels` tool lets you specify if a country is HIC, LIC, or another grouping. Cascade can take that input and cross-reference it against the full list of World Bank countries. If your goal is 'Find all low-income nations in Asia,' Windsurf chains these two tools together to give you a precise, filtered output.

Discover Regions via MCP Server

The `search_regions` tool lists every World Bank geographic region. This is crucial for macro-level planning when you need to group countries by continent or economic zone. When working with large datasets, Cascade handles the region lookup first, letting your agent focus only on the relevant subset of world data.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "world-bank-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 World Bank Open Data. 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 World Bank 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 World Bank Countries MCP in Windsurf

You set a goal for Cascade—for example, 'Get all countries classified as HIC.' The MCP Server handles the rest. It runs `search_income_levels` and returns only those filtered results to your context.

Yes. You can use the `search_regions` tool to list all available geographic areas first. Then, you feed that regional data into other tools in Windsurf to narrow down your scope.

It provides the necessary ISO codes needed for global metadata resolution. You don't have to worry about manually mapping these identifiers when building components in Windsurf.

Absolutely. Once connected via the Settings UI, Cascade auto-discovers all available tools on the server. You just set your goal; we handle the plumbing.

This server handles metadata like country names, ISO codes, and generalized income classifications (HIC, LIC). It touches no personal or sensitive user data.

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