How to Use the Gipuzkoa Irekia MCP in Windsurf

Q: Can Windsurf download CSV files directly from Gipuzkoa Irekia?

Yes. Cascade uses showresource to grab the raw download URL of any dataset. Once it has the link, the agent can fetch and parse the file contents in your workspace.

Get Basque public data directly inside Windsurf as Cascade chains multi-step queries to locate and parse regional datasets.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Gipuzkoa Irekia MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Fast Basque dataset discovery in Windsurf

`search_packages` lets your Cascade agent find public records from the Gipuzkoa region instantly. Your agent takes your request, searches the index, and grabs the exact file identifier without making you run manual lookups. No more dealing with slow government web portals. `list_packages` helps the agent map available records, pulling metadata directly into your workspace for immediate analysis.

Map regional publisher hierarchies

`list_organizations` and `show_organization` expose the exact departments publishing public data in Gipuzkoa. Cascade maps these entities to understand which local agency controls the budget or transport records you need. You get the raw structural details without scraping government websites. Calling `show_group` allows the agent to filter these organizations by thematic categories like environment or finance.

Direct resource inspection for your MCP Server

`show_resource` grabs direct download links and formats for specific regional data files. Cascade evaluates the resource types and prepares the code to parse them. No more guessing file structures. Your agent uses `search_resources` to isolate CSV or JSON files, then downloads the exact slice of data required for your current task.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "gipuzkoa-irekia-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 Gipuzkoa Irekia. 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 Gipuzkoa Irekia 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 Gipuzkoa Irekia MCP in Windsurf

Cascade connects directly to the open data portal using this MCP Server. It calls tools like `search_packages` to find files and inputs them straight into your active coding context.

Yes. Cascade uses `show_resource` to grab the raw download URL of any dataset. Once it has the link, the agent can fetch and parse the file contents in your workspace.

No API key is required for public data. The MCP Server handles the connection to the Basque open data portal, letting you run queries instantly.

Use the thematic groups. This MCP Server provides 9 tools, including `list_groups` to see what topics exist, and `show_group` to list every dataset under that specific category.

Your agent processes the public metadata locally within your secure Windsurf session. The server only routes read-only queries to the official Basque government endpoints, keeping your workspace private.

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