# io.github.cyanheads/eurostat-mcp-server (remote · eurostat.caseyjhand.com)

Search and query the Eurostat catalogue — EU economy, demography, trade, and NUTS regional data.

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

## Components

- remote · `eurostat.caseyjhand.com`: 69/100 (this document), [markdown](https://verifymcp.io/servers/cyanheads-eurostat-mcp-server/eurostat.md), [page](https://verifymcp.io/servers/cyanheads-eurostat-mcp-server/eurostat)
- npm · `@cyanheads/eurostat-mcp-server`: 35/100, [markdown](https://verifymcp.io/servers/cyanheads-eurostat-mcp-server/cyanheads-eurostat-mcp-server.md), [page](https://verifymcp.io/servers/cyanheads-eurostat-mcp-server/cyanheads-eurostat-mcp-server)

## Channel facts

- Endpoint: `https://eurostat.caseyjhand.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.1.15`

## 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.
  - Authorisation not fully verified: no authorisation is required to call this server, and 5 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - 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**: 66/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1250 tokens (~250/item across 5 items; 5 tools + 0 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.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http cyanheads-eurostat-mcp-server https://eurostat.caseyjhand.com/mcp
```

### Codex

```toml
[mcp_servers.cyanheads-eurostat-mcp-server]
url = "https://eurostat.caseyjhand.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cyanheads-eurostat-mcp-server": {
      "type": "remote",
      "url": "https://eurostat.caseyjhand.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add cyanheads-eurostat-mcp-server --url https://eurostat.caseyjhand.com/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  cyanheads-eurostat-mcp-server:
    url: "https://eurostat.caseyjhand.com/mcp"
```

### Other

```json
{
  "mcpServers": {
    "cyanheads-eurostat-mcp-server": {
      "type": "http",
      "url": "https://eurostat.caseyjhand.com/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-03 (score 69, +1)

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

### 2026-08-01 (score 68, +1)

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

### 2026-07-31 (score 67, +1)

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

### 2026-07-30 (score 66, +1)

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

### 2026-07-29 (score 65, +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-27 (score 64, +1)

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

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

First indexed and scored.

## MCP tools (5)

### `eurostat_search_datasets` (~227 tokens)

Search Eurostat Datasets

Search the Eurostat catalogue by keyword. Returns matching datasets with codes, descriptions, period coverage, and theme breadcrumbs. Use this to discover dataset codes before calling eurostat_get_dataset_info or eurostat_query_dataset. Results are limited to datasets and predefined tables — folders are excluded.

Input parameters:

- `cursor` (string): Opaque pagination cursor from a previous call's nextCursor. Omit for the first page; pass it back to fetch the next page of matches over a stable order.
- `limit` (integer): Page size — maximum datasets returned per page (1–100). Default is 20. To retrieve matches beyond one page, pass the returned nextCursor back as cursor; the page size is fixed by this first call.
- `query` (string, required): Search terms. Split on whitespace into tokens; every token must match (AND), case-insensitively, somewhere across the dataset label, theme breadcrumb, or code. Word order does not matter, so "busines…

Output parameters:

- `datasets` (array): Matching datasets for the current page, up to the requested limit.
- `nextCursor` (string): Opaque cursor for the next page of matches. Pass it back as cursor. Omitted on the last page.
- `nextStep` (string): Suggested next action based on these results. Populated when there is a clear follow-up call.
- `query` (string): Search terms as submitted.
- `totalMatches` (number): Total datasets matching the query across all pages, before the page limit.
- `truncated` (boolean): True when more matches remain beyond this page — pass nextCursor as cursor to fetch them.

### `eurostat_browse_themes` (~134 tokens)

Browse Eurostat Theme Hierarchy

Navigate the Eurostat theme tree. Without theme_code returns the top-level theme folders (Economy, Population, Transport, etc.) — the practical starting points. With a theme_code returns its immediate children: subtheme folders and datasets in that branch. Use this for structured discovery when you know the domain but not the dataset code, or to drill down from a broad topic to a specific dataset. Pair with eurostat_search_datasets for keyword-based discovery.

Input parameters:

- `theme_code` (string): Folder code to expand (e.g., "econ", "reg"). Omit to list the top-level theme folders.

Output parameters:

- `itemCount` (number): Number of items returned in this level.
- `items` (array): Immediate children of the requested theme, or the root themes if theme_code was omitted.
- `nextStep` (string): Suggested next action based on these results. Populated when there is a clear follow-up call.
- `parentPath` (array): Breadcrumb from root to the requested theme (e.g., ["Economy and finance", "National accounts"]). Empty when browsing root.
- `themeCode` (string): Folder code that was browsed, or omitted for root.

### `eurostat_get_dataset_info` (~123 tokens)

Get Eurostat Dataset Info

Fetch metadata for a Eurostat dataset: dimensions with valid values, time range, observation count, and last-update date. Call this before eurostat_query_dataset to discover what dimension codes are valid (unit, na_item, geo, etc.). Returns up to 10 sample values per dimension for orientation; use eurostat_get_dimension_values to list the full set for large dimensions.

Input parameters:

- `dataset_code` (string, required): Dataset code (e.g., "nama_10_gdp"). Use eurostat_search_datasets or eurostat_browse_themes to find codes.

Output parameters:

- `code` (string): Dataset code as provided.
- `dimensions` (array): All dimensions of the dataset with their valid codes and labels.
- `label` (string): Human-readable dataset title.
- `lastUpdated` (string): ISO 8601 timestamp of the most recent data update.
- `metadataUrl` (string): URL to the ESMS HTML metadata page for this dataset. Omitted when not provided by Eurostat.
- `obsCount` (number): Total number of observations in the full dataset (all periods).
- `timeRange` (object): Overall data coverage period for this dataset.

### `eurostat_get_dimension_values` (~248 tokens)

Get Eurostat Dimension Values

List all valid values for a specific dimension in a Eurostat dataset (e.g., all unit codes for nama_10_gdp, all geo codes for a regional dataset). Use this when eurostat_get_dataset_info returns more values than the 10-item sample, or to confirm exact codes before querying. For the "geo" dimension, use geo_level to filter by NUTS hierarchy (country, nuts1, nuts2, nuts3). Invalid dimension_value codes passed to eurostat_query_dataset silently return no data; use this tool to verify codes first.

Input parameters:

- `dataset_code` (string, required): Dataset code (e.g., "nama_10_gdp").
- `dimension` (string, required): Dimension code to retrieve values for (e.g., "unit", "na_item", "geo"). Use eurostat_get_dataset_info to see available dimensions.
- `geo_level` (string): NUTS hierarchy level filter — only relevant when dimension is "geo". Options: "aggregate" (EU/EA codes), "country" (2-letter codes, default), "nuts1" (3-char), "nuts2" (4-char), "nuts3" (5-char).

Output parameters:

- `dimensionCode` (string): The dimension code that was queried.
- `dimensionLabel` (string): Human-readable dimension name.
- `totalCount` (number): Total number of distinct values returned.
- `values` (array): All valid values for this dimension in the dataset.

### `eurostat_query_dataset` (~441 tokens)

Query Eurostat Dataset

Fetch statistical data from a Eurostat dataset with dimension filters. Returns decoded observations with dimension codes and labels, numeric values, and status flags (e.g., "p" = provisional, "e" = estimated). Call eurostat_get_dataset_info first to discover valid dimension codes and values. Apply filters to keep the result set manageable — large unfiltered queries may trigger an async response error. Use filters.geo for specific country/region codes, or geo_level for NUTS hierarchy filtering (mutually exclusive). Use last_n_periods for the N most recent periods without knowing the end date.

Input parameters:

- `dataset_code` (string, required): Dataset code (e.g., "nama_10_gdp"). Required.
- `filters` (object): Dimension filters as a map of dimension code → array of valid values. Example: {"unit": ["CP_MEUR"], "na_item": ["B1GQ"], "geo": ["DE", "FR"]}. Do not include "geo" here if using geo_level. Invalid d…
- `geo_level` (string): Filter by NUTS hierarchy level. Mutually exclusive with a "geo" key in filters. Options: "aggregate" (EU/EA totals), "country" (41 member/candidate states), "nuts1" (127 major regions), "nuts2" (309…
- `lang` (string): Language for labels in the response. Default is "EN". Options: "EN", "FR", "DE".
- `last_n_periods` (integer): Return only the N most recent periods. Mutually exclusive with since_period and until_period.
- `since_period` (string): Start of time range (e.g., "2020", "2023-Q1", "2024-01"). Mutually exclusive with last_n_periods.
- `until_period` (string): End of time range (e.g., "2024"). Omit for data through the latest available period. Mutually exclusive with last_n_periods.

Output parameters:

- `appliedFilters` (object): Effective query parameters applied to the Eurostat API.
- `datasetCode` (string): Dataset code as provided.
- `datasetLabel` (string): Human-readable dataset title.
- `dimensionsUsed` (array): Ordered list of dimension codes present in the response (e.g., ["freq", "unit", "na_item", "geo", "time"]).
- `missingObsCount` (number): Number of observations with null value (missing data points in the source).
- `notice` (string): Guidance when the result was truncated at 5,000 rows. Omitted for normal results.
- `obsCount` (number): Total number of observations matched (before any cap).
- `observations` (array): Decoded observations, capped at 5,000 rows. When truncated is true, apply dimension filters to narrow the result.
- `timeRange` (object): Time coverage of the returned observations.
- `truncated` (boolean): True when the result exceeded 5,000 observations and was capped. Apply dimension filters to get the full result.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/cyanheads-eurostat-mcp-server/eurostat#diagnostics

## Score history

- 2026-08-03: 69
- 2026-08-02: 68
- 2026-08-01: 68
- 2026-07-31: 67
- 2026-07-30: 66
- 2026-07-29: 65
- 2026-07-28: 64
- 2026-07-27: 64
- 2026-07-26: 63

## Links

- Remote endpoint: https://eurostat.caseyjhand.com/mcp
- Repository: https://github.com/cyanheads/eurostat-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/cyanheads-eurostat-mcp-server/eurostat/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/cyanheads-eurostat-mcp-server/eurostat/changelog.json
- HTML version of this page: https://verifymcp.io/servers/cyanheads-eurostat-mcp-server/eurostat