How to Use the Knoema MCP in Windsurf

Q: How do I install the Knoema MCP Server in Windsurf?

Edit your mcpconfig.json file or use the Cascade MCP Servers UI. Add the server details under the mcpServers key, then click Refresh in the panel.

Q: Can Windsurf and Knoema pull historical GDP data?

Yes. Cascade uses searchdatasets to find the economic data, then runs getdataseries to extract the historical timeline.

Q: How does Cascade handle missing region codes?

It actively queries listdatasetregions to verify country codes before attempting to pull the final series data. This prevents failed requests.

Connect Knoema to Windsurf and let Cascade autonomously query global economic statistics right in your IDE via this MCP integration.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Knoema MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous Data Discovery in Windsurf

Knoema gives your IDE direct access to global statistical databases. You tell Cascade you need inflation rates for Western Europe, and it immediately hits `search_datasets` to find the right economic source. The agent doesn't stop to ask you for the next step. Once it has the dataset ID, Cascade chains `get_dataset_metadata` to map the available variables and `list_dataset_regions` to filter for the exact countries. You watch the agent build a complete data pipeline without writing a single API call yourself.

Time-Series Extraction

Pulling historical data usually requires manually piecing together endpoints. With this MCP server, Cascade runs `get_data_series` using the mnemonics it just found to pull the exact time-series data you asked for. If you just need the current snapshot, the agent switches to `get_latest_dataset_data`. It handles the unit conversions by checking `list_data_units` and `list_data_frequencies`, ensuring your final output is actually usable for your analysis.

Granular Indicator Search

Sometimes you don't know the exact dataset name. Cascade uses `search_data_series` to bypass the high-level dataset search and hunt down specific indicators like agricultural yield or demographic shifts directly. The agent cross-references these findings with `list_data_topics` to ensure the data matches your domain. You get raw, verified statistics piped straight into your workspace while you focus on the actual modeling.

Setup guide

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

mcp_config.json

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

Edit your `mcp_config.json` file or use the Cascade MCP Servers UI. Add the server details under the mcpServers key, then click Refresh in the panel.

Yes. Cascade uses `search_datasets` to find the economic data, then runs `get_data_series` to extract the historical timeline.

It actively queries `list_dataset_regions` to verify country codes before attempting to pull the final series data. This prevents failed requests.

Cascade reads the error response and backs off. You can also restrict how many times it loops through `search_data_series` in a single prompt.

This MCP server only reads external global statistics. Your local source code never leaves your machine. The connection strictly fetches external economic and demographic indicators via the V8 Isolate 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