# Gipuzkoa Irekia MCP for AI Agents AI Agent Connect

> Gipuzkoa Irekia lets your AI agent browse and query the official open data portal for the Gipuzkoa region in Spain. You can search for specific datasets, explore public records from various municipalities, and grab metadata for files on topics like the environment, transport, and the economy. It turns a manual, multi-tab portal search into a direct conversation.

## Overview
- **Category:** knowledge-management
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_86RncpAm0YOcynyXsoAR3xWt4qz4AULJNNB4AlX7/ai-agent-connect
- **Tags:** open-data, public-sector, dataset-discovery, metadata-management, regional-data, transparency

## Description

Imagine you need to find specific public records or environmental data from various municipalities in the Gipuzkoa region. Usually, this involves navigating a complex government portal, filtering through nested menus, and hoping the right keyword search actually works. This Connector changes that by letting your AI agent do the heavy lifting for you. Instead of clicking through dozens of pages, you just ask your agent to find the latest waste management stats or list all the departments publishing transport data. It pulls the actual metadata, download links, and organizational details directly into your chat or IDE. Whether you're a developer looking for a specific resource ID to plug into an app or a researcher trying to map out regional economic trends, you get the data you need without the friction of a manual search. It's part of the Vinkius catalog, making it easy to plug into your existing workflow so you can stay focused on the analysis rather than the hunt.

## Tools

### list_organizations
Shows all the public departments and municipalities publishing data. This is great for seeing who owns the records.

### show_group
Retrieves specific details for a selected thematic group. Use this to see what a category actually covers.

### show_organization
Gets the specific details for a single government organization. It provides context on the data publisher.

### list_packages
Lists all available dataset packages in the portal. Use this to see the full scope of available data.

### search_packages
Searches the catalog for specific datasets based on your keywords. It helps you find the right data quickly.

### show_package
Retrieves the metadata and details for a specific dataset. This shows you what's inside a package before you download it.

### search_resources
Searches for specific data files or resources within the portal. This is useful for finding specific file types.

### show_resource
Provides the metadata and download links for a specific data resource. It gives you the exact link you need.

### list_groups
Lists all thematic group names like transport or environment. This helps you see how the data is categorized.

## Prompt Examples

**Prompt:** 
```
Who publishes open data in the Gipuzkoa region?
```

**Response:** 
```
I've pulled the list of organizations that publish open data in Gipuzkoa. Here are the main entities:

* **Diputación Foral de Gipuzkoa**
* **Ayuntamiento de Donostia**
* **Regional Agencies**

Would you like me to look into the specific details for any of these?
```

**Prompt:** 
```
Find me some datasets about waste management.
```

**Response:** 
```
I found several datasets related to waste management in the Gipuzkoa Irekia catalog:

| Dataset Name | Category |
| :--- | :--- |
| **Waste Management Statistics** | Environment |
| **Regional Waste Processing** | Economy |

Which one would you like to see the download links for?
```

**Prompt:** 
```
What's in the 'presupuestos-municipales' dataset?
```

**Response:** 
```
The **presupuestos-municipales** dataset contains the following information:

* **Content**: Municipal budget information
* **Formats**: CSV, XLS
* **Latest Update**: Recently updated by the Finance Department

I can provide the specific resource IDs if you need to download the files.
```

## Capabilities

### Search for specific datasets
Find specific packages in the portal using keywords or metadata filters.

### Get metadata and download links
Retrieve detailed information and direct links for specific data resources.

### Browse public departments
List and inspect the various municipalities and agencies that publish data.

### Explore thematic groups
Navigate the catalog by categories like transport, environment, or economy.

### Perform advanced catalog queries
Execute precise searches across the entire public data catalog.

## Use Cases

### Finding environmental stats
A researcher asks for air quality data and the agent uses search_packages to find the right files from the environment group.

### Mapping government agencies
A journalist wants to see every municipality publishing data and uses list_organizations to get a full list of entities.

### Developer API integration
A dev needs the specific resource ID for a budget CSV and uses show_package to get it without leaving their editor.

### Thematic data exploration
A city planner wants to see all transport related data and uses list_groups to browse categories and find relevant links.

## Benefits

- Stop manual portal navigation by using search_packages to find datasets instantly.
- Get direct download links and formats for files using show_resource without hunting through pages.
- Quickly identify which agencies publish what data by using list_organizations.
- Organize your research by exploring thematic categories with list_groups.
- Save time on API integration by pulling resource IDs directly into your IDE using show_package.

## How It Works

The bottom line is you get instant access to regional public data without leaving your AI interface.

1. Subscribe to the Gipuzkoa Irekia MCP in your client.
2. Enter your Gipuzkoa Irekia API Key in the settings.
3. Ask your agent to find specific regional datasets or organizational info.

## Frequently Asked Questions

**Can I use Gipuzkoa Irekia to find environmental data?**
Yes. You can ask your agent to search for specific environmental topics like air quality or waste management, and it will pull the relevant datasets from the regional catalog.

**Does Gipuzkoa Irekia work for researchers?**
It is perfect for researchers. It allows you to quickly browse and inspect public records and metadata for regional data without manual portal navigation.

**How do I get download links for public records?**
When you ask your agent to find a specific dataset or resource, it can retrieve the metadata which includes the direct download links for you.

**Can my agent search for specific municipalities?**
Yes. You can ask your agent to list all organizations or find specific details for a municipality publishing data in the Gipuzkoa region.

**Is Gipuzkoa Irekia good for finding budget data?**
Yes, it includes various financial records. You can search for specific budget datasets like municipal budgets and get their metadata immediately.

**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.