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+