Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1
Prepare the server locally
Run this once before adding it to Claude Code.
npm install2
Register it in Claude Code
claude mcp add idescat-mcp -- npx tsx /absolute/path/to/idescat-mcp/src/index.tsReplace any placeholder paths in the command with the real path on your machine.
3
Make your agent remember this setup
idescat-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- 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
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.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.
Original README from catbru/idescat-mcp
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
idescat_list_catalog— find the statistics and nodeidescat_get_territorial_options— pick a geo divisionidescat_get_table_metadata— understand dimensions and valid filter valuesidescat_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+