Idescat MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add idescat-mcp -- npx tsx /absolute/path/to/idescat-mcp/src/index.ts
README.md

Access Catalonia's statistical data via the IDESCAT Tables API v2.

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

Typical workflow

  1. idescat_list_catalog — find the statistics and node
  2. idescat_get_territorial_options — pick a geo division
  3. idescat_get_table_metadata — understand dimensions and valid filter values
  4. 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+

Tools (5)

idescat_list_catalogNavigate catalogue: statistics, nodes, and tables.
idescat_get_territorial_optionsList available geo divisions for a table.
idescat_get_table_metadataInspect dimensions and valid filter values.
idescat_query_dataFetch data as flattened rows with resolved labels.
idescat_check_historical_relationsDiscover historical and related tables.

Configuration

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

Try it

List the available statistics in the Idescat catalog.
Find the territorial options for the population table.
Get the metadata for the latest employment statistics table.
Query the data for the population table filtered by the Barcelona region.

Frequently Asked Questions

What are the key features of Idescat?

Navigate the Idescat statistical catalog hierarchy. Retrieve territorial geo-division options for specific tables. Inspect table dimensions and valid filter metadata. Fetch statistical data as flattened rows with resolved labels. Discover historical and related statistical tables.

What can I use Idescat for?

Researchers analyzing demographic trends in Catalonia. Data journalists looking for official regional statistics. Policy analysts needing historical data on Catalan economic indicators. Students performing regional socio-economic research.

How do I install Idescat?

Install Idescat by running: npm install

What MCP clients work with Idescat?

Idescat works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Idescat docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare