# io.github.xaviviro/opendata-cat (remote · opendata.cat)

15 Catalan portals + radio archive: gov, INE/REE/CNMC, CORA, Catalònica, radioteca.cat.

- Trust score: 64/100 (medium)
- Change this week: +5
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `opendata.cat`: 64/100 (this document), [markdown](https://verifymcp.io/servers/xaviviro-opendata-cat/api-mcp.md), [page](https://verifymcp.io/servers/xaviviro-opendata-cat/api-mcp)
- npm · `@opendata.cat/mcp-server`: 64/100, [markdown](https://verifymcp.io/servers/xaviviro-opendata-cat/opendata-cat-mcp-server.md), [page](https://verifymcp.io/servers/xaviviro-opendata-cat/opendata-cat-mcp-server)

## Channel facts

- Endpoint: `https://opendata.cat/api/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.6.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 66/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS not yet verified: we couldn't determine whether a plaintext access path exists.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 64/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 5530 tokens (~460/item across 12 items; 8 tools + 4 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 20/100
  - Spec-recency check failed: implements MCP spec 2024-11-05; the latest is 2026-07-28.

## Install

### Claude

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

### Codex

```toml
[mcp_servers.xaviviro-opendata-cat]
url = "https://opendata.cat/api/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "xaviviro-opendata-cat": {
      "type": "remote",
      "url": "https://opendata.cat/api/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add xaviviro-opendata-cat --url https://opendata.cat/api/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  xaviviro-opendata-cat:
    url: "https://opendata.cat/api/mcp"
```

### Other

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

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 64, +1)

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 63, +2)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 61, 0)

- [security] The server rewrote its instructions, which are the text every model session reads

### 2026-07-29 (score 61, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 60, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 59, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 59)

First indexed and scored.

## MCP tools (8)

### `search_datasets` (~181 tokens)

Search datasets by free text. IMPORTANT: check server instructions first — many common queries have a direct dataset_id you can use with query_dataset without searching. Only use search_datasets when you don't know which dataset you need.

Input parameters:

- `category` (string): Filter by thematic category. Examples: 'Medi Ambient', 'Educació', 'Salut', 'Economia', 'Transport', 'Seguretat'. Use list_categories to see all available categories.
- `limit` (number): Maximum number of results to return. Min 1, max 100. Default 20.
- `portal` (string): Filter results to a single portal.
- `query` (string, required): Search text in Catalan or Spanish. Examples: 'qualitat aire', 'pressupostos municipals', 'transport públic', 'residus', 'educació', 'rodalies'.

### `get_dataset_info` (~108 tokens)

Get complete metadata for a dataset: fields with types and descriptions, API endpoint, license, available formats and last update. Call after search_datasets to get full details of a specific dataset.

Input parameters:

- `dataset_id` (string, required): Unique dataset identifier in 'portal:id' format. Obtained from search_datasets results. Examples: 'generalitat:gn9e-3qhr', 'barcelona:qualitat-de-laire', 'renfe:vehicle-positions-gtfsrt'.

### `list_dataset_fields` (~60 tokens)

List fields of a dataset with name, data type and description. Call before query_dataset to know which fields and filters are available.

Input parameters:

- `dataset_id` (string, required): Unique dataset identifier in 'portal:id' format. Obtained from search_datasets results.

### `query_dataset` (~223 tokens)

Query real data from a dataset. Check instructions for featured dataset_ids and NOTES section for common filter patterns (municipal budgets, contracts, weather, energy, fuel prices).

Input parameters:

- `dataset_id` (string, required): Unique dataset identifier in 'portal:id' format. Obtained from search_datasets results.
- `filters` (object): Key-value filters where the key is the field name and the value is the filter value. Examples: {"municipi": "Barcelona"}, {"any": "2024"}, {"NOM_ENS": "Ajuntament de Tiana"}. Use list_dataset_fields…
- `limit` (number): Number of rows to return. Min 1, max 100. Default 20. Use offset for pagination.
- `offset` (number): Number of rows to skip for pagination. Default 0. Combine with limit to navigate large results.
- `search` (string): Free text search within dataset data. Works with Socrata ($q) and CKAN (q). For Diba and CIDO, use specific filters.

### `list_portals` (~80 tokens)

List all 13 indexed open data portals with dataset counts. Catalan portals (Generalitat, Barcelona, Diba, AOC, Reus, Girona, FGC, Idescat, Renfe) + Spanish national sources with Catalonia focus (INE statistics, REE energy, SEPE employment, CNMC fuel prices). No parameters required.

### `list_categories` (~53 tokens)

List all dataset categories and themes with counts per portal. Great first step to discover what data types are available before searching with search_datasets. Returns total datasets, count per portal and category list with counts. No parameters required.

### `related_datasets` (~75 tokens)

Find related datasets from OTHER portals. Great for discovering complementary data: if you're looking at air quality from Generalitat, it may suggest traffic data from Barcelona or emissions from AOC. Relations are computed by thematic similarity across portals.

Input parameters:

- `dataset_id` (string, required): Dataset ID to find related datasets for. Obtained from search_datasets.

### `search_radioteca` (~306 tokens)

Search radio shows, episodes and people indexed at radioteca.cat (Catalan radio archive, ~485K documents from Catalunya Ràdio, RAC1, Catalunya Música, iCat, Catalunya Informació, RTVE, Cadena SER, ara.cat). Searches across episode titles, descriptions (which include a detailed summary of what was said), program name and subheading. Returns episodes (~473K), programs (~3K) and people (~9K). IMPORTANT: always cite radioteca.cat as the source and include the absolute 'url' in your reply for traceability — never paraphrase without linking.

Input parameters:

- `limit` (number): Maximum results. Min 1, max 50. Default 10.
- `offset` (number): Pagination offset. Default 0.
- `publisher` (string): Filter by broadcaster.
- `query` (string, required): Free text in Catalan or Spanish. Searches title, description (contains episode summary), program and subheading. Examples: 'visita papa', 'eleccions municipals', 'crisi habitatge', 'Albert Serra cine…
- `type` (string): Filter by document type.
- `year` (string): Filter by year (4 digits, e.g. '2025'). NOTE: only year-level filtering is indexed; for a specific day, use the broader year filter and look at the URL path (radioteca URLs include /YYYY/MM/DD/) or t…

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/xaviviro-opendata-cat/api-mcp#diagnostics

## Score history

- 2026-08-03: 64
- 2026-08-02: 64
- 2026-08-01: 63
- 2026-07-31: 63
- 2026-07-30: 61
- 2026-07-29: 61
- 2026-07-28: 60
- 2026-07-27: 59
- 2026-07-26: 59

## Links

- Remote endpoint: https://opendata.cat/api/mcp
- Repository: https://github.com/xaviviro/Opendata.cat-MCP-Server
- Changelog RSS feed: https://verifymcp.io/servers/xaviviro-opendata-cat/api-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/xaviviro-opendata-cat/api-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/xaviviro-opendata-cat/api-mcp
