@opendata.cat/mcp-server 0.0.19 → 0.1.1

package/README.md

@@ -27,10 +27,11 @@ Un projecte d'**[opendata.cat](https://opendata.cat)** — associacio sense anim
 | [Ajuntament de Reus](https://opendata.reus.cat) | 119 | CKAN datastore |
 | [Ajuntament de Girona](https://www.girona.cat/opendata/) | 53 | CKAN datastore |
 | [FGC (Ferrocarrils)](https://dadesobertes.fgc.cat) | 50 | Opendatasoft |
+| [Idescat](https://www.idescat.cat) | 138 | Idescat API |
 
-El Consorci AOC inclou datasets de les **diputacions de Tarragona, Girona i Lleida**, ajuntaments, consells comarcals i altres organismes publics catalans.
+El Consorci AOC inclou datasets de les **diputacions de Tarragona, Girona i Lleida**, ajuntaments, consells comarcals i altres organismes publics catalans. Idescat proporciona indicadors estadistics de Catalunya (poblacio, economia, treball, salut...) amb series temporals.
 
-**+2.800 datasets** de 7 portals. La majoria queryables amb filtres, cerca i paginacio.
+**+2.800 datasets** de 8 portals. La majoria queryables amb filtres, cerca i paginacio.
 
 El cataleg s'actualitza automaticament cada setmana. Cada endpoint es valida per assegurar que funciona.
 
@@ -40,6 +41,7 @@ El cataleg s'actualitza automaticament cada setmana. Cada endpoint es valida per
 - **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)
 - **Opendatasoft**: API records amb filtres i cerca (FGC — horaris GTFS, trens temps real, estacions esqui)
+- **Idescat**: indicadors estadistics amb series temporals (poblacio, economia, treball, salut, educacio)
 - **File download**: descarrega directa de CSV, JSON, XLSX o fitxers GIS
 - **Restricted**: requereix token d'autenticacio (4 datasets BSM)
 
@@ -140,45 +142,18 @@ Llista els portals disponibles amb el nombre de datasets de cadascun. No requere
 
 Llista totes les categories i temes de datasets disponibles amb comptadors per portal. Ideal per descobrir quins tipus de dades hi ha.
 
-## Prompts disponibles
-
-Prompts predefinits que guien l'LLM pas a pas per fer analisis completes:
-
-| Prompt | Descripcio | Arguments |
-|--------|-----------|-----------|
-| `estat_embassaments` | Estat actual dels embassaments amb grafiques d'evolucio | — |
-| `trens_fgc_temps_real` | Retards, alertes i posicions dels trens FGC en temps real | — |
-| `qualitat_aire` | Analisi de la qualitat de l'aire amb comparativa OMS/UE | `lloc` (opcional) |
-| `accidents_transit` | Analisi d'accidents de transit amb punts negres i tendencies | `municipi` (opcional) |
-| `pressupostos_municipals` | Pressupostos municipals amb desglossament per partides | `municipi` (opcional) |
-| `compara_municipis` | Compara dos municipis en totes les dades disponibles | `municipi_a`, `municipi_b` |
-| `descobreix_dades` | Mapa complet de dades obertes sobre un tema | `tema` |
-| `analisi_bombers` | Actuacions dels Bombers: emergencies, distribucio, tendencies | `comarca` (opcional) |
-| `novetats` | Datasets actualitzats mes recentment | `portal` (opcional) |
-| `datasets_populars` | Datasets mes consultats pels usuaris | — |
-| `explorar_portal` | Guia completa d'un portal: categories, exemples, destacats | `portal` |
-| `dades_municipi` | Fitxa completa d'un municipi amb totes les dades disponibles | `municipi` |
-| `datasets_temps_real` | Datasets amb dades en temps real o actualitzacio frequent | — |
-| `resum_portals` | Visio panoramica de tots els portals de dades obertes | — |
-
 ## Exemples d'us
 
 Un cop configurat, pots fer preguntes al teu LLM com:
 
-- *"Quin es l'estat dels embassaments de Catalunya?"* → prompt `estat_embassaments`
-- *"Hi ha algun tren de FGC amb retard ara mateix?"* → prompt `trens_fgc_temps_real`
-- *"Analitza la qualitat de l'aire a Terrassa"* → prompt `qualitat_aire`
-- *"Fes unes grafiques amb l'evolucio dels accidents de transit a Barcelona"* → prompt `accidents_transit`
-- *"Compara Girona i Tarragona en dades obertes"* → prompt `compara_municipis`
-- *"Quines dades obertes hi ha sobre educacio a Catalunya?"* → prompt `descobreix_dades`
-- *"Dona'm les ultimes dades de pressupostos de Reus"* → prompt `pressupostos_municipals`
-- *"Analitza les actuacions dels Bombers al Valles"* → prompt `analisi_bombers`
-- *"Quines novetats hi ha en dades obertes?"* → prompt `novetats`
-- *"Quins son els datasets mes consultats?"* → prompt `datasets_populars`
-- *"Explora'm el portal de la Generalitat"* → prompt `explorar_portal`
-- *"Quines dades obertes te Sabadell?"* → prompt `dades_municipi`
-- *"Quines dades en temps real hi ha?"* → prompt `datasets_temps_real`
-- *"Dona'm un resum de tots els portals"* → prompt `resum_portals`
+- *"Quin es l'estat dels embassaments de Catalunya?"*
+- *"Hi ha algun tren de FGC amb retard ara mateix?"*
+- *"Quina es la poblacio de Catalunya? I l'atur?"*
+- *"Analitza la qualitat de l'aire a Terrassa"*
+- *"Compara Girona i Tarragona en dades obertes"*
+- *"Quines dades obertes hi ha sobre educacio a Catalunya?"*
+- *"Dona'm les ultimes dades de pressupostos de Reus"*
+- *"Tenim informacio d'actuacions de bombers o del 112?"*
 
 ## Com funciona
 
@@ -224,6 +199,13 @@ Les contribucions son benvingudes! Per afegir un nou portal de dades obertes:
 
 ## Changelog
 
+### v0.1.0 (2026-04-14)
+- Nou portal Idescat (Institut d'Estadistica de Catalunya) — 138 indicadors estadistics
+- Client Idescat amb series temporals (poblacio, PIB, atur, inflacio, educacio, salut...)
+- Millora ranking de cerca: datasets amb el terme al nom surten primer
+- Instruccio multi-cerca a search_datasets per cobrir temes amplis
+- Sinonims ampliats: emergencies (112, SEM, ambulancia, bombers, mossos)
+
 ### v0.0.17 (2026-04-14)
 - Simplificacio automatica de geometries GIS: centroide + bounding box en lloc de milers de coordenades
 - Decodificador GTFS-RT integrat: trens FGC en temps real (retards, alertes, posicions GPS)

package/dist/clients/idescat.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Client per a l'API d'Idescat (Institut d'Estadística de Catalunya).
+ * Consulta indicadors estadístics de Catalunya amb sèries temporals.
+ */
+export declare function queryIdescat(endpoint: string): Promise<{
+    indicators: Record<string, unknown>[];
+    count: number;
+}>;

package/dist/clients/idescat.js

@@ -0,0 +1,30 @@
+/**
+ * Client per a l'API d'Idescat (Institut d'Estadística de Catalunya).
+ * Consulta indicadors estadístics de Catalunya amb sèries temporals.
+ */
+export async function queryIdescat(endpoint) {
+    const resp = await fetch(endpoint);
+    if (!resp.ok)
+        throw new Error(`Idescat error ${resp.status}: ${resp.statusText}`);
+    const data = (await resp.json());
+    const raw = data?.indicadors?.i;
+    if (!raw)
+        return { indicators: [], count: 0 };
+    const items = Array.isArray(raw) ? raw : [raw];
+    const indicators = items
+        .filter((item) => item.id)
+        .map((item) => {
+        const unit = item.u;
+        const period = item.r;
+        return {
+            indicador: item.c ?? "",
+            valor: item.v ?? null,
+            unitat: typeof unit === "object" ? (unit?.content ?? "") : (unit ?? ""),
+            periode: typeof period === "object" ? (period?.title ?? "") : (period ?? ""),
+            font: item.s ?? "",
+            serie_temporal: item.ts ?? "",
+            link: item.l ?? "",
+        };
+    });
+    return { indicators, count: indicators.length };
+}

package/dist/index.js

@@ -11,22 +11,54 @@ import { queryDiba } from "./clients/diba.js";
 import { queryCido } from "./clients/cido.js";
 import { queryOpendatasoft } from "./clients/opendatasoft.js";
 import { decodeGtfsRt } from "./clients/gtfsrt.js";
-const server = new McpServer({
-    name: "opendata-cat",
-    version: "0.0.19",
-});
+import { queryIdescat } from "./clients/idescat.js";
+const INSTRUCTIONS = `Servidor MCP de dades obertes de Catalunya. Pots consultar dades reals directament amb query_dataset si coneixes el dataset_id.
+
+DATASETS DESTACATS (pots fer query_dataset directament sense cercar):
+- generalitat:gn9e-3qhr → Embassaments: volum, % ple, per estació
+- generalitat:i5n8-43cw → Estat de sequera per municipi
+- generalitat:rmgc-ncpb → Accidents de trànsit amb morts o ferits greus
+- generalitat:jq8m-d7cw → Incidents operatius gestionats pel CAT 112
+- generalitat:mfqb-sbx4 → Trucades operatives gestionades pel CAT 112
+- generalitat:g2ay-3vnj → Actuacions dels Bombers de la Generalitat
+- generalitat:j6ii-t3w2 → Certificats d'eficiència energètica d'edificis
+- fgc:vehicle-positions-gtfs_realtime → Posició GPS dels trens FGC en temps real
+- fgc:alerts-gtfs_realtime → Alertes de servei FGC en temps real
+- fgc:trip-updates-gtfs_realtime → Retards dels trens FGC en temps real
+- idescat:m10328 → Població de Catalunya
+- idescat:m10234 → Confiança empresarial
+- barcelona:accidents-gu-bcn → Accidents gestionats per la Guàrdia Urbana BCN
+
+DADES MUNICIPALS (filtra per NOM_ENS amb query_dataset):
+- aoc:ge-ge-cost-efectiu-serveis-minhap → Cost dels serveis de +1.000 municipis
+- aoc:ge-p-pressupostos-i-plantilles → Pressupostos i plantilles municipals
+- aoc:ge-ge-endeutament → Endeutament municipal
+- aoc:ge-p-liquidacions-per-programes-detallat → Liquidació pressupostos per programes
+- aoc:ge-ge-termini-pagament-proveidors → Termini pagament a proveïdors
+
+PORTALS: generalitat (Socrata), barcelona (CKAN), diba (REST), aoc (CKAN), reus (CKAN), girona (CKAN), fgc (Opendatasoft+GTFS-RT), idescat (API indicadors)
+Usa search_datasets per temes que no siguin als destacats. Fes múltiples cerques amb termes diferents per cobrir temes amplis.`;
+const server = new McpServer({ name: "opendata-cat", version: "0.1.1" }, { instructions: INSTRUCTIONS });
 // Tool 1: search_datasets
-server.tool("search_datasets", "Cerca datasets de dades obertes catalanes per text lliure. IMPORTANT: fes múltiples cerques amb termes diferents per cobrir un tema ampli. Ex: si l'usuari pregunta per 'emergències', cerca 'bombers', '112 trucades', 'mossos policia', 'SEM ambulància' per separat. La cerca inclou sinònims en català i castellà.", {
+server.tool("search_datasets", "Cerca datasets per text lliure. Mira primer les instructions del servidor: molts datasets es poden consultar directament amb query_dataset sense cercar. Usa search_datasets només quan no saps quin dataset necessites.", {
     query: z.string().describe("Text de cerca (ex: 'qualitat aire', 'pressupostos')"),
-    portal: z.string().optional().describe("Filtrar per portal: 'generalitat', 'barcelona', 'diba', 'aoc', 'reus', 'girona', 'fgc'"),
+    portal: z.string().optional().describe("Filtrar per portal: 'generalitat', 'barcelona', 'diba', 'aoc', 'reus', 'girona', 'fgc', 'idescat'"),
     category: z.string().optional().describe("Filtrar per categoria"),
     limit: z.number().optional().default(20).describe("Nombre màxim de resultats (defecte: 20)"),
 }, async ({ query, portal, category, limit }) => {
     const result = await searchDatasets(query, portal, category, limit);
+    const queryableTypes = new Set(["socrata", "ckan", "opendatasoft", "idescat", "diba", "diba_cido"]);
+    const enriched = {
+        ...result,
+        items: result.items.map((item) => ({
+            ...item,
+            queryable: queryableTypes.has(item.api_type),
+        })),
+    };
     return {
         content: [{
                 type: "text",
-                text: JSON.stringify(result, null, 2),
+                text: JSON.stringify(enriched, null, 2),
             }],
     };
 });
@@ -51,8 +83,8 @@ server.tool("list_dataset_fields", "Llista els camps d'un dataset amb el seu nom
     return { content: [{ type: "text", text: JSON.stringify(dataset.fields, null, 2) }] };
 });
 // Tool 4: query_dataset
-server.tool("query_dataset", "Executa una consulta contra un dataset i retorna files de dades reals del portal origen.", {
-    dataset_id: z.string().describe("ID del dataset a consultar"),
+server.tool("query_dataset", "Consulta dades reals d'un dataset. Mira les instructions per dataset_ids destacats. Per dades municipals, usa filters: {\"NOM_ENS\": \"Ajuntament de X\"} amb els datasets aoc:ge-*.", {
+    dataset_id: z.string().describe("ID del dataset (ex: 'generalitat:gn9e-3qhr' per embassaments, 'aoc:ge-ge-cost-efectiu-serveis-minhap' per cost serveis municipal)"),
     filters: z.record(z.string(), z.string()).optional().describe("Filtres clau-valor (ex: {\"ciutat\": \"Barcelona\"})"),
     search: z.string().optional().describe("Cerca de text lliure dins el dataset"),
     limit: z.number().optional().default(20).describe("Files a retornar (defecte: 20, màxim: 100)"),
@@ -114,6 +146,20 @@ server.tool("query_dataset", "Executa una consulta contra un dataset i retorna f
             }
             results = data.records;
         }
+        else if (dataset.api_type === "idescat") {
+            const data = await queryIdescat(dataset.api_endpoint);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            dataset: dataset.name,
+                            portal: "Idescat",
+                            count: data.count,
+                            data: data.indicators,
+                        }, null, 2),
+                    }],
+            };
+        }
         else {
             return {
                 content: [{
@@ -148,6 +194,7 @@ server.tool("list_portals", "Llista els portals de dades obertes catalans dispon
         { id: "reus", name: "Ajuntament de Reus", url: "https://opendata.reus.cat", api: "CKAN" },
         { id: "girona", name: "Ajuntament de Girona", url: "https://www.girona.cat/opendata/", api: "CKAN" },
         { id: "fgc", name: "Ferrocarrils de la Generalitat de Catalunya", url: "https://dadesobertes.fgc.cat", api: "Opendatasoft" },
+        { id: "idescat", name: "Idescat (Institut d'Estadística de Catalunya)", url: "https://www.idescat.cat", api: "Idescat API" },
     ];
     const cats = await getCategories();
     const portalCounts = new Map(cats.portals.map((p) => [p.portal_id, p.total]));
@@ -471,7 +518,7 @@ async function main() {
             // Health check
             if (req.url === "/health") {
                 res.writeHead(200, { "Content-Type": "application/json" });
-                res.end(JSON.stringify({ status: "ok", name: "opendata-cat", version: "0.0.19" }));
+                res.end(JSON.stringify({ status: "ok", name: "opendata-cat", version: "0.1.1" }));
                 return;
             }
             // MCP endpoint

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.0.19",
+  "version": "0.1.1",
   "description": "Servidor MCP per consultar les dades obertes públiques de Catalunya",
   "type": "module",
   "main": "dist/index.js",