Opendata.cat MCP Server

Servidor MCP (Model Context Protocol) que connecta els models de llenguatge (Claude, ChatGPT, Gemini...) amb les dades obertes publiques de Catalunya. Cerca datasets, explora metadades i consulta dades reals de la Generalitat, l'Ajuntament de Barcelona i la Diputacio de Barcelona directament des del teu assistent d'IA.

Un projecte d'opendata.cat — associacio sense anim de lucre fundada el 2012 que promou la transparencia, la difusio i l'estandarditzacio de les dades obertes a Catalunya. Inspirat en el projecte datagouv-mcp del govern frances.

Portals disponibles

| Portal | Datasets | Queryables | APIs | |--------|----------|-----------|------| | Generalitat de Catalunya | 1.058 | 1.058 | Socrata (SoQL) | | Ajuntament de Barcelona | 555 | 463 | CKAN datastore | | Diputacio de Barcelona | 90 | 32 | REST + JSON:API (CIDO) | | Consorci AOC | ~893 | ~893 | CKAN datastore |

El Consorci AOC inclou datasets de les diputacions de Tarragona, Girona i Lleida, ajuntaments, consells comarcals i altres organismes publics catalans.

~2.400 datasets queryables amb filtres, cerca i paginacio. La resta ofereix descarrega directa de fitxers.

El cataleg s'actualitza automaticament cada setmana. Cada endpoint es valida per assegurar que funciona.

Tipus d'acces:

Socrata: consulta SoQL amb filtres i cerca (Generalitat)
CKAN: datastore_search amb filtres i cerca (Barcelona, AOC)
Diba REST: API do.diba.cat amb paginacio i filtres (Diputacio BCN)
CIDO JSON:API: api.diba.cat per contractacions, normatives, subvencions, oposicions, convenis (Diputacio BCN)
File download: descarrega directa de CSV, JSON, XLSX o fitxers GIS
Restricted: requereix token d'autenticacio (4 datasets BSM)

Installacio rapida

Claude Desktop

Afegeix al fitxer de configuracio (~/Library/Application Support/Claude/claude_desktop_config.json a macOS o %APPDATA%\Claude\claude_desktop_config.json a Windows):

{
  "mcpServers": {
    "opendata-cat": {
      "command": "npx",
      "args": ["-y", "@opendata.cat/mcp-server"]
    }
  }
}

Claude Code (CLI)

claude mcp add opendata-cat -- npx -y @opendata.cat/mcp-server

VS Code / Cursor

Afegeix al fitxer .vscode/mcp.json del teu projecte:

{
  "servers": {
    "opendata-cat": {
      "command": "npx",
      "args": ["-y", "@opendata.cat/mcp-server"]
    }
  }
}

Tools disponibles

| Tool | Descripcio | |------|-----------| | search_datasets | Cerca datasets per text lliure al cataleg | | get_dataset_info | Retorna metadades completes: camps, tipus, llicencia, endpoint | | list_dataset_fields | Llista els camps d'un dataset amb nom, tipus i descripcio | | query_dataset | Consulta dades reals directament al portal origen | | list_portals | Llista els portals disponibles amb estadistiques | | list_categories | Llista categories i temes disponibles amb comptadors |

search_datasets

Cerca datasets per text lliure.

query: "qualitat aire"
portal: "barcelona"        # opcional: generalitat, barcelona, diba
category: "Medi Ambient"   # opcional
limit: 20                  # opcional (defecte: 20)

get_dataset_info

Retorna totes les metadades d'un dataset.

dataset_id: "generalitat:gn9e-3qhr"

list_dataset_fields

Llista els camps d'un dataset amb nom, tipus i descripcio.

dataset_id: "generalitat:gn9e-3qhr"

query_dataset

Executa una consulta directament contra el portal origen i retorna dades reals.

dataset_id: "generalitat:gn9e-3qhr"
filters: {"estaci": "Sau"}   # opcional
search: "embassament"         # opcional
limit: 20                     # opcional (defecte: 20, max: 100)
offset: 0                     # opcional

list_portals

Llista els portals disponibles amb el nombre de datasets de cadascun. No requereix parametres.

list_categories

Llista totes les categories i temes de datasets disponibles amb comptadors per portal. Ideal per descobrir quins tipus de dades hi ha.

Exemples d'us

Un cop configurat, pots fer preguntes al teu LLM com:

"Quins datasets hi ha sobre mobilitat a Barcelona?"
"Mostra'm les dades de qualitat de l'aire d'ahir"
"Quants equipaments culturals te Girona?"
"Dona'm les ultimes dades de pressupostos municipals"
"Quin es l'estat dels embassaments de Catalunya?"
"Quines dades obertes hi ha sobre educacio a Catalunya?"
"Quins tipus de dades teniu disponibles?"

Com funciona

Usuari → LLM → MCP opendata.cat → API opendata.cat (cataleg)
                                 → Portal origen (dades reals)

L'MCP consulta l'API d'opendata.cat per descobrir datasets rellevants
Quan l'usuari vol dades concretes, l'MCP fa la consulta directament al portal origen (Socrata o CKAN)
Les dades tornen a l'LLM, que les interpreta i presenta a l'usuari

No emmagatzema ni fa de proxy de dades. Cada consulta va directament a la font oficial.

Sobre opendata.cat

opendata.cat es una associacio catalana sense anim de lucre fundada el 2012 (registre 47468) dedicada a promoure la transparencia i l'acces a la informacio publica. Treballa en tres eixos: estandarditzacio de formats i protocols, formacio especialitzada per a professionals i administracions, i collaboracio publico-privada per a l'obertura de dades.

Contribuir

Les contribucions son benvingudes! Per afegir un nou portal de dades obertes:

Obre una issue amb la URL del portal i el tipus d'API
O envia un pull request

Changelog

v0.0.7 (2026-04-13)

Afegeix portal Consorci AOC (~893 datasets de diputacions, ajuntaments, consells comarcals)
Cobertura total: ~2.600 datasets, ~2.400 queryables
Inclou dades de les diputacions de Tarragona, Girona i Lleida

v0.0.6 (2026-04-12)

Afegeix client CIDO (api.diba.cat) per contractacions, normatives, subvencions, oposicions, convenis
Camps filtables reals extrets automaticament per cada endpoint CIDO

v0.0.5 (2026-04-12)

Gestio correcta de datasets no queryables (file_download, restricted)
Retorna URL directa en comptes d'error quan un dataset no te API

v0.0.4 (2026-04-12)

Audit complet Barcelona i Diba: api_types correctes per cada dataset
Barcelona: resource_id real via package_show (463 queryables)
Diba: REST (do.diba.cat) + CIDO (api.diba.cat) + file_download
Validador d'endpoints a /api/validate.php

v0.0.3 (2026-04-12)

Afegeix client Diba (do.diba.cat REST API) amb paginacio i filtres

v0.0.2 (2026-04-12)

Afegeix referencia al projecte datagouv-mcp del govern frances

v0.0.1 (2026-04-12)

Versio inicial: 3 portals (Generalitat, Barcelona, Diba)
6 tools: search_datasets, get_dataset_info, list_dataset_fields, query_dataset, list_portals, list_categories
Publicat a npm com @opendata.cat/mcp-server

Llicencia

MIT

MCP Servers