How do I use idescat-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@idescat-mcp Show me the latest population statistics for Barcelona" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

idescat-mcp

by catbru

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

idescat-mcp

MCP server for the IDESCAT Tables API v2 — the Statistical Institute of Catalonia.

Tools

Tool	Purpose
`idescat_list_catalog`	Navigate catalogue: statistics → nodes → tables
`idescat_get_territorial_options`	List available geo divisions for a table
`idescat_get_table_metadata`	Inspect dimensions and valid filter values
`idescat_query_data`	Fetch data as flattened rows with resolved labels
`idescat_check_historical_relations`	Discover historical and related tables

Related MCP server: Catalunya Open Data MCP

Typical workflow

idescat_list_catalog — find the statistics and node
idescat_get_territorial_options — pick a geo division
idescat_get_table_metadata — understand dimensions and valid filter values
idescat_query_data — fetch filtered data

Installation

npm install

Claude Desktop integration

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "idescat": {
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/idescat-mcp/src/index.ts"]
    }
  }
}

Requirements

Node.js 18+

Available Tools

5 tools

idescat_check_historical_relationsC

Descobreix taules relacionades: versions anteriors de la mateixa sèrie i les mateixes dades en altres divisions territorials.

Name	Required	Description
`geo`	No
`lang`	No	Idioma: ca (defecte), es, en.
`node`	No
`table`	No
`table_id`	No	Camí complet "statistics/node/table/geo" (alternativa als camps separats).
`statistics`	No

idescat_get_table_metadataA

Retorna les metadades d'una taula: dimensions, valors possibles, fonts i enllaç a les dades. IMPORTANT: l'ID de taula (table) és diferent de l'ID de node — obté'l primer amb idescat_list_catalog(statistics, node). Usa-la ABANS de idescat_query_data per saber quins filtres aplicar.

Name	Required	Description
`geo`	No	Divisió territorial (cat, com, mun, prov, etc.).
`lang`	No	Idioma: ca (defecte), es, en.
`node`	No
`table`	No
`filters`	No	Filtres opcionals. Ex: {"SEX": "F"}
`table_id`	No	Camí complet "statistics/node/table/geo" (alternativa als camps separats).
`statistics`	No

idescat_get_territorial_optionsC

Retorna les divisions territorials disponibles per a una taula específica (cat, com, mun, prov, etc.).

Name	Required	Description
`lang`	No	Idioma: ca (defecte), es, en.
`node`	No
`table`	No
`table_id`	No	Camí complet "statistics/node/table" (alternativa als camps separats).
`statistics`	No

idescat_list_catalogA

Navega el catàleg jeràrquic de l'IDESCAT en 3 nivells: (1) sense paràmetres → llista d'estadístiques; (2) amb statistics → llista de nodes; (3) amb statistics+node → llista de TAULES amb els seus IDs reals. Has de cridar-la fins al nivell 3 per obtenir l'ID de taula correcte abans d'usar idescat_get_table_metadata o idescat_query_data.

Name	Required	Description
`lang`	No	Idioma: ca (defecte), es, en.
`node`	No	Codi del node (requereix statistics). Opcional.
`statistics`	No	Codi de l'estadística (ex: pmh). Opcional.

idescat_query_dataA

Obté dades d'una taula com a array de files aplanades amb etiquetes. IMPORTANT: l'ID de taula (table) és diferent de l'ID de node — obté'l amb idescat_list_catalog(statistics, node). Consulta primer idescat_get_table_metadata per saber les dimensions i filtres disponibles.

Name	Required	Description
`geo`	No
`lang`	No	Idioma: ca (defecte), es, en.
`last`	No	Retorna els darrers N períodes disponibles (_LAST_). No combinar amb filtre de temps.
`node`	No
`table`	No
`filters`	No	Filtres per dimensió. Ex: {"SEX": "F", "COM": "01,TOTAL"}
`table_id`	No	Camí complet "statistics/node/table/geo" (alternativa als camps separats).
`statistics`	No

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

5 tool updatesv1.0.0Apr 3, 2026
- First observedidescat_check_historical_relations
- First observedidescat_get_table_metadata
- First observedidescat_get_territorial_options
- First observedidescat_list_catalog
- First observedidescat_query_data

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.7/5.0

Scored 2026-06-04 05:35 across 5 tools

Disambiguation5/5

Each tool has a distinct purpose: catalog navigation, metadata retrieval, territorial options, historical relations, and data querying. The descriptions clearly differentiate their roles and usage order.

Naming Consistency5/5

All tools follow the consistent pattern 'idescat_verb_noun' using snake_case, with verbs like 'list', 'get', 'query', and 'check' clearly indicating the action.

Tool Count5/5

Five tools is well-scoped for a statistical data server, covering catalog browsing, metadata, data retrieval, territorial filtering, and historical exploration without excess or deficiency.

Completeness4/5

The tool set covers core workflows (navigate, get metadata, query data, explore related tables) with a minor gap for direct dimension filtering beyond territory, but the metadata tool provides necessary information for query construction.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Idescat MCP ServerA
cat.idescat
Query official statistics of Catalonia (Idescat): tables, metadata and JSON-stat data via MCP.
Government Data Open Data
711
https://api.idescat.cat/mcp
Statistics Canada MCP ServerA
io.github.Aryan-Jhaveri
Access Statistics Canada data via the Web Data Services API
Government Data Open Data Research & Data
517
https://mcp-statcan.com/mcp
EurostatA
io.github.pipeworx-io
Eurostat MCP — wraps Eurostat Statistical Data API (no auth required)
Open Data Government Data Research & Data
472
https://gateway.pipeworx.io/eurostat/mcp
eurostat-mcp-serverA
io.github.cyanheads
Search and query the Eurostat catalogue — EU economy, demography, trade, and NUTS regional data.
Government Data Open Data Search
829
https://eurostat.caseyjhand.com/mcp

Related MCP Servers

mcp-estat-japan
Government Data Open Data Research & Data
pipeworx-io
A
license
Not graded
quality
C
maintenance
Enables querying Japanese government statistics from e-Stat, including metadata, data observations, and catalog browsing.
Updated 8 days ago (2026-11-01 20:54 UTC)
473 npm
MIT
Catalunya Open Data MCP
Government Data Open Data
aalises
A
license
A
quality
D
maintenance
Enables discovering, describing, and querying public datasets from Catalunya, including Socrata, IDESCAT, and Open Data BCN portals.
Updated 6 months ago (2026-04-30 20:58 UTC)
22
MIT
mcp-hagstofa-is
Government Data Open Data
pipeworx-io
A
license
Not graded
quality
C
maintenance
Enables access to Statistics Iceland data through the PxWeb API for querying tables and navigating subject trees.
Updated 8 days ago (2026-11-02 02:38 UTC)
498 npm
MIT
istat-mcp-suite
Government Data Open Data Research & Data
ManoloZocco
A
license
A
quality
C
maintenance
Enables querying, exploring, and downloading ISTAT statistical datasets via SDMX REST API, with unified metadata, territorial code resolution, and data extraction.
Updated 2 months ago (2026-09-01 13:15 UTC)
7
MIT

idescat-mcp

Tools

Typical workflow

Installation

Claude Desktop integration

Requirements

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

mcp-estat-japan

Catalunya Open Data MCP

mcp-hagstofa-is

istat-mcp-suite