Gipuzkoa Irekia MCP for AI. Query public open records with conversation.
Works with every AI agent you already use
…and any MCP-compatible client








Connect to your AI in seconds.
Gipuzkoa Irekia connects your AI agent directly to the public open data of the Gipuzkoa region, Spain. You can search for datasets, list publishing organizations, and get deep metadata on specific resources—all using plain conversation.
It turns complex government portals into simple Q&A sessions.
What your AI can do
List groups
Lists every available thematic group used to categorize datasets.
Show group
Retrieves detailed information for a single thematic group.
List organizations
Retrieves a list of all government organizations that contribute open data.
List all available thematic groups or specific organizations that publish open records.
Find packages of public data using keywords, filtering by organization or theme.
Get detailed information about specific downloadable files, including their format and origin.
Retrieve the full metadata package for a known public dataset.
Get information on specific governmental departments or municipalities responsible for the data.
Ask an AI about this
Waiting for input…
Gipuzkoa Irekia: 9 Tools for Open Data Discovery
These tools let your agent systematically browse, search, and retrieve deep technical details about every dataset, resource, organization, or group in the Gipuzkoa open data catalog.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Gipuzkoa Irekia on VinkiusList Groups
Lists every available thematic group used to categorize datasets.
Show Group
Retrieves detailed information for a single thematic group.
List Organizations
Retrieves a list of all government organizations that contribute open data.
Show Organization
Gets comprehensive details about one specific publishing organization.
List Packages
Gets the names of all available datasets (packages) in the catalog.
Search Packages
Searches for specific datasets using keywords or filters.
Show Package
Fetches all the metadata associated with a named dataset package.
Search Resources
Searches through individual data files (resources) by keyword.
Show Resource
Retrieves full details, formats, and links for an individual data resource file.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Gipuzkoa Irekia, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 9 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Dealing with public government data usually means endless clicks.
Today, finding reliable regional data requires jumping between dozens of departmental websites. You click the 'Environment' tab, then maybe the 'Water Quality' subgroup, and finally you have to download a PDF just to see if it has the table you need. It's painstaking manual work that usually ends with a dozen browser tabs open and a headache.
With this MCP, you simply ask your agent: 'Show me all data related to water quality in Gipuzkoa.' The system handles the navigation across departments, listing groups, checking metadata for specific resources, and giving you a clean answer. You get answers immediately; not links to other manuals.
Using the `show_package` tool gives you immediate clarity on data structure.
Instead of having to guess if a dataset is usable, manually checking which files are included and what formats they use (CSV? XML? XLS?), your agent uses `show_package`. It instantly pulls all the resource IDs and metadata into one view.
This means you stop guessing. You start knowing exactly what data fields exist before writing a single line of code or asking a follow-up question.
What your AI can actually do with this
Need to find a dataset about local transport or environmental regulations? Instead of navigating through dozens of departmental websites and clicking through confusing menus, your AI agent handles it all. This MCP lets you talk to the entire public sector catalog for Gipuzkoa directly. You can ask your agent to list every organization that publishes data or pinpoint specific datasets by theme.
The system reads everything—from listing available groups to checking the metadata of a resource file. If you're building an application, this Vinkius catalog integration allows developers to retrieve necessary IDs and structure public APIs instantly through natural language prompts. It’s about turning weeks of manual portal research into seconds of conversation.
019e389e-f22f-716d-91af-9eb0bd8e19f1 Here's how it actually works
The bottom line is you talk naturally; the MCP does the complex database queries in the background.
Subscribe to this MCP and provide your Gipuzkoa Irekia API Key (optional, but recommended).
Ask your AI client a question about open records—for example, 'What datasets exist for waste management?'
The agent uses the tools to search the catalog and returns structured data or metadata directly into your chat.
Who is this actually for?
Anyone dealing with public government information—from data researchers trying to prove a point, to developers building apps that need local metrics. If your job involves finding structured public records across multiple siloed sources, this is for you.
Uses the MCP to search packages and resources quickly, bypassing manual portal navigation to find specific data points for reports.
Retrieves resource IDs and metadata directly in an IDE using this MCP, letting them integrate public APIs into a new application without guesswork.
Asks simple questions about government transparency, like listing all organizations publishing data for the region.
What Changes When You Connect
Find datasets instantly. Instead of clicking through dozens of menus, use search_packages to find specific data sets using natural language prompts.
Know your sources. Use list_organizations and show_organization to see exactly which government body published the record, improving trust in the data.
Deep dive into files. If you know a dataset name, use show_package then inspect resources with show_resource for format details and download links.
Browse by topic. You don't need to guess what's available; you can start broad by listing groups (list_groups) or themes.
Save time on structure. Developers use this MCP to get IDs and metadata directly, eliminating manual API calls needed for integration.
See it in action
Tracking regional environmental trends
A researcher needs data spanning multiple years. They ask their agent to search datasets related to 'environment' using search_packages. The agent returns several options, allowing the researcher to then use show_package on the most promising one to check for specific historical resource IDs.
Building an app dashboard
A developer needs a list of all available data sources. They prompt the agent to execute list_organizations, getting the full names and scope of every contributing department, which they then use to structure their application's API calls.
Verifying budget figures
A citizen wants to check municipal spending. They ask about a specific dataset like 'presupuestos-municipales'. The agent uses show_package to confirm the data exists, and then uses search_resources to find the exact CSV file they need.
The honest tradeoffs
Trying to download directly
Telling your AI agent: 'Get me all Gipuzkoa data.' The agent will fail because it needs more context than just a request.
First, use list_groups or search_packages to narrow the scope. Then, if you need specific file details, run show_resource with the exact resource ID.
Ignoring organizational context
Assuming that all data is available in one place, leading to incomplete or inaccurate reports.
Always start by running list_organizations. This shows you which department published the record, ensuring your research accounts for jurisdictional boundaries.
Overlooking resource types
Searching only by keyword when a dataset might exist but be filed under a different theme or group.
Use list_packages to see all available datasets first. If that fails, use the specific tool search_resources to target file content directly.
When It Fits, When It Doesn't
You should use this MCP if your goal is accessing structured, publicly released government information from Gipuzkoa. The process must involve discovery: you need to list groups or organizations first, then search for the dataset (search_packages), and finally inspect the specific file metadata (show_resource). Don't use it if you need proprietary internal records, private emails, or data that hasn't been formally published on the open portal. If your problem is 'I can't find a database about X,' start by listing groups; don't try to query for X immediately.
Questions you might have
How does `search_packages` help me find datasets? +
It searches the entire catalog for dataset names using keywords. If you're looking for 'transport', this tool finds all packages related to transportation, even if they come from different organizations.
What is the difference between `list_organizations` and `show_organization`? +
list_organizations just gives you a list of names. You run show_organization when you need deep details about one specific body, like its contact info or scope.
Can I use `search_resources` to check for formats? +
Yes. This tool searches individual files by keyword. Running it shows the file's metadata, including its format (CSV, XLS) and whether it has a download link.
Do I need all 9 tools to query data? +
No. You typically start with list_groups or search_packages. The other tools are for drilling down: getting specific details like running show_organization.
Do I need an API key to use the `search_packages` function? +
No, you can start querying public data without an API key. However, we highly recommend obtaining one; it increases your query limits and ensures stable performance when running complex or repeated searches.
How do I find datasets related to a specific topic using `list_groups`? +
The list_groups tool shows every available thematic category. Once you identify the correct group name, you use that context to refine your dataset search or call the show_group function.
What is the difference between searching and using `show_package`? +
Searching finds datasets based on keywords. Using show_package fetches the complete, detailed metadata for a single dataset, including its full history, all contributing organizations, and resource IDs.
When running complex queries with `search_resources`, what helps improve speed? +
The faster your results, the more specific your query. Include known data formats (like 'CSV' or 'XLS') and use precise keywords; vague searches can slow down the process significantly.
How can I search for datasets related to a specific topic like 'transport'? +
You can use the search_packages tool. Simply provide the search term in the q parameter (e.g., 'transport'), and the agent will return a list of matching datasets from the Gipuzkoa Irekia catalog.
Can I see which organizations are publishing data on this portal? +
Yes! Use the list_organizations tool to get a complete list of all departments, municipalities, and entities that contribute to the Gipuzkoa Irekia open data catalog.
How do I get the download links or format details for a specific data file? +
Use the show_resource tool with the specific Resource ID. It will provide detailed metadata, including the file format (CSV, JSON, etc.) and the direct URL to access the data.
We've already built the connector for Gipuzkoa Irekia. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 9 tools are live and waiting.
You're up and running in seconds.
Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.