# Idescat MCP server

> Query official Catalonia statistics from Idescat: find statistics, read table metadata and fetch JSON-stat data by territory.

- Listing: https://mcp.tc/i/idescat
- Connect: use the server's own URL `https://api.idescat.cat/mcp` (no sign-in); clients connect to it directly. The listing link is a page, not an MCP endpoint.
- Type: remote (Streamable HTTP)
- Auth: none
- Category: [Data & Analytics](https://mcp.tc/c/analytics)
- Vendor: Idescat (Institut d'Estadística de Catalunya)
- Homepage: <https://www.idescat.cat/>
- Repository: <https://github.com/idescat/mcp>

## About

Connects to the official statistics of Catalonia published by Idescat. You can list available statistics, browse the tables of a statistic, read table metadata, and fetch data in JSON-stat format at levels such as Catalonia, provinces, comarques, municipalities, districts and census tracts. A render tool returns ready-made Markdown tables with a link to the source.

The server runs as a hosted Streamable HTTP endpoint at https://api.idescat.cat/mcp. No sign-in or API key is needed. Labels and descriptions are in Catalan. Table fetches are limited to 20,000 cells after filters are applied.

## What it can do

- List all Idescat statistics with territorial breakdown levels
- Browse tables of a statistic
- Read table metadata: dimensions, categories, units
- Fetch JSON-stat data filtered by territory and recent periods
- List territorial divisions available for a table
- Render a table as Markdown with a source link

## Tools (7)

- `get_idescat_stats`: List all Idescat statistics with acronym, description and territorial levels.
- `get_idescat_stat`: Get information about one statistic by its acronym.
- `get_idescat_stat_tables`: List the tables of a normalized statistic.
- `get_table_metadata`: Get table metadata in JSON-stat: dimensions, categories, units, update date.
- `get_table_data`: Fetch table data in JSON-stat, optionally filtered by dimension, territory or last periods.
- `get_table_geo`: List territorial divisions available for a table.
- `render_table`: Return a Markdown table of filtered data with a link to the Idescat site.

## Example prompts

- "What is the latest population of each comarca in Catalonia?"
- "Which Idescat statistics have municipality-level data?"
- "Show GDP data for Catalonia for the last 5 years as a table."
- "List the tables available in the population census statistic."

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

```bash
claude mcp add --transport http idescat https://api.idescat.cat/mcp
```

2. Start Claude Code and type `/mcp`. **idescat** should show as connected.

Add `--scope user` to make it available in every project, not just this one.

### Claude Desktop

1. Open **Customize → Connectors**, click **+ Add**, then **Add custom connector**.

2. Name it **Idescat** and paste this URL:

```url
https://api.idescat.cat/mcp
```

3. Click **Add**. Its tools appear in the chat’s tools menu.

Claude Desktop’s JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too.

### claude.ai

1. Open the connector form on claude.ai. This button fills in the name and URL for you:

[Add to claude.ai](<https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Idescat&connectorUrl=https%3A%2F%2Fapi.idescat.cat%2Fmcp>) (opens connector settings)

2. Check that the URL reads `https://api.idescat.cat/mcp` and click **Add**.

3. Turn it on in a chat from the tools menu.

Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under **Organization settings → Connectors**.

### ChatGPT

1. On chatgpt.com, go to **Plugins**, select **+**, then **Add custom MCP server**.

2. Enter a name for the server.

3. Under **Connection**, paste `https://api.idescat.cat/mcp` as the server URL, then for authentication choose **No authentication**.

4. Check **I understand and want to continue**, then select **Create as a plugin**.

Whether you can add a custom MCP server depends on your ChatGPT plan and your workspace permissions (in Business workspaces, admins and owners can).

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=idescat&config=eyJ1cmwiOiJodHRwczovL2FwaS5pZGVzY2F0LmNhdC9tY3AifQ%3D%3D>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

```json
{
  "mcpServers": {
    "idescat": {
      "url": "https://api.idescat.cat/mcp"
    }
  }
}
```

### VS Code

[Install in VS Code](<https://vscode.dev/redirect/mcp/install?name=idescat&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.idescat.cat%2Fmcp%22%7D>) (opens VS Code)

Or from a terminal:

```bash
code --add-mcp '{"name":"idescat","type":"http","url":"https://api.idescat.cat/mcp"}'
```

Or commit it to the repo in `.vscode/mcp.json`:

`.vscode/mcp.json`:

```json
{
  "servers": {
    "idescat": {
      "type": "http",
      "url": "https://api.idescat.cat/mcp"
    }
  }
}
```

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```json
{
  "mcpServers": {
    "idescat": {
      "serverUrl": "https://api.idescat.cat/mcp"
    }
  }
}
```

2. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf. It reads `serverUrl` (or `url`) for remote servers.

### Codex

```bash
codex mcp add idescat --url https://api.idescat.cat/mcp
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.idescat]
url = "https://api.idescat.cat/mcp"
```

### Gemini CLI

```bash
gemini mcp add --transport http idescat https://api.idescat.cat/mcp
```

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients accept this shape. Some name the URL field differently: `serverUrl` in Devin Desktop, `httpUrl` in Gemini CLI’s settings file.

```json
{
  "mcpServers": {
    "idescat": {
      "type": "http",
      "url": "https://api.idescat.cat/mcp"
    }
  }
}
```

Zed puts servers under `context_servers` in its settings. Cline needs `"type": "streamableHttp"`, or it assumes SSE.

Client only starts local servers? Bridge it with `npx -y mcp-remote https://api.idescat.cat/mcp`.

## Recent changes

- 2026-10-19 13:37 UTC: New version 1.1.1 (was 1.1.0), reported by the server. Source: automatic check.
- 2026-10-14 10:31 UTC: New version 1.1.0 (was 1.0.0), reported by the server. Source: automatic check.
- 2026-10-14 10:31 UTC: 2 tools changed. Server instructions changed. Source: automatic check. Worth a look: new server instructions. Changed: get\_table\_data, render\_table.
- 2026-10-09 04:21 UTC: Tracking started: 7 tools read. Source: automatic check.

More on the History tab, with descriptions before and after for the newest entries: https://mcp.tc/i/idescat#history (Atom feed: https://mcp.tc/i/idescat/history.xml). It records what mcp.tc's anonymous checks saw, every 3 hours where the tool list can be read without sign-in; it is not a security review.

## Details

- Server version: 1.1.1
- MCP protocol version: 2026-07-28
- Last checked: 2026-11-17 (reachable)
- Listed: 2026-10-09
- Updated: 2026-10-09

---
Source: https://mcp.tc/i/idescat (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report
