eurostat-mcp-server
Server Details
Search and query the Eurostat catalogue — EU economy, demography, trade, and NUTS regional data.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP
- URL
- Repository
- cyanheads/eurostat-mcp-server
- GitHub Stars
- 1
Glama MCP Gateway
Connect through Glama MCP Gateway for full control over tool access and complete visibility into every call.
Full call logging
Every tool call is logged with complete inputs and outputs, so you can debug issues and audit what your agents are doing.
Tool access control
Enable or disable individual tools per connector, so you decide what your agents can and cannot do.
Managed credentials
Glama handles OAuth flows, token storage, and automatic rotation, so credentials never expire on your clients.
Usage analytics
See which tools your agents call, how often, and when, so you can understand usage patterns and catch anomalies.
Tool Definition Quality
Average 4.7/5 across 5 of 5 tools scored.
Each tool targets a distinct aspect of Eurostat data access: theme navigation, metadata, dimension values, querying, and keyword search. There is no functional overlap, and descriptions clearly differentiate their purposes.
All tools follow a consistent 'eurostat_verb_noun' pattern using snake_case (e.g., browse_themes, get_dataset_info, query_dataset). The naming is uniform and predictable.
With 5 tools, the server covers the complete workflow of discovering and querying Eurostat data without being cluttered. The count is well-scoped for its domain.
The tool set provides full lifecycle coverage: discovery (browse, search), metadata exploration (info, dimension values), and data retrieval (query). No obvious gaps exist for the intended use.
Available Tools
5 toolseurostat_browse_themesBrowse Eurostat Theme HierarchyRead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| theme_code | No | Folder code to expand (e.g., "econ", "reg"). Omit to list the top-level theme folders. |
Output Schema
| Name | Required | Description |
|---|---|---|
| items | Yes | Immediate children of the requested theme, or the root themes if theme_code was omitted. |
| nextStep | No | Suggested next action based on these results. Populated when there is a clear follow-up call. |
| itemCount | Yes | Number of items returned in this level. |
| themeCode | No | Folder code that was browsed, or omitted for root. |
| parentPath | Yes | Breadcrumb from root to the requested theme (e.g., ["Economy and finance", "National accounts"]). Empty when browsing root. |
eurostat_get_dataset_infoGet Eurostat Dataset InfoRead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| dataset_code | Yes | Dataset code (e.g., "nama_10_gdp"). Use eurostat_search_datasets or eurostat_browse_themes to find codes. |
Output Schema
| Name | Required | Description |
|---|---|---|
| code | Yes | Dataset code as provided. |
| label | Yes | Human-readable dataset title. |
| obsCount | Yes | Total number of observations in the full dataset (all periods). |
| timeRange | Yes | Overall data coverage period for this dataset. |
| dimensions | Yes | All dimensions of the dataset with their valid codes and labels. |
| lastUpdated | Yes | ISO 8601 timestamp of the most recent data update. |
| metadataUrl | No | URL to the ESMS HTML metadata page for this dataset. Omitted when not provided by Eurostat. |
eurostat_get_dimension_valuesGet Eurostat Dimension ValuesRead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| dimension | Yes | Dimension code to retrieve values for (e.g., "unit", "na_item", "geo"). Use eurostat_get_dataset_info to see available dimensions. | |
| geo_level | No | 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). | |
| dataset_code | Yes | Dataset code (e.g., "nama_10_gdp"). |
Output Schema
| Name | Required | Description |
|---|---|---|
| values | Yes | All valid values for this dimension in the dataset. |
| totalCount | Yes | Total number of distinct values returned. |
| dimensionCode | Yes | The dimension code that was queried. |
| dimensionLabel | Yes | Human-readable dimension name. |
eurostat_query_datasetQuery Eurostat DatasetRead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Language for labels in the response. Default is "EN". Options: "EN", "FR", "DE". | EN |
| filters | No | 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 dimension values silently return no data — verify with eurostat_get_dimension_values first. | |
| geo_level | No | 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 basic regions), "nuts3" (1,343 small regions). | |
| dataset_code | Yes | Dataset code (e.g., "nama_10_gdp"). Required. | |
| since_period | No | Start of time range (e.g., "2020", "2023-Q1", "2024-01"). Mutually exclusive with last_n_periods. | |
| until_period | No | End of time range (e.g., "2024"). Omit for data through the latest available period. Mutually exclusive with last_n_periods. | |
| last_n_periods | No | Return only the N most recent periods. Mutually exclusive with since_period and until_period. |
Output Schema
| Name | Required | Description |
|---|---|---|
| notice | No | Guidance when the result was truncated at 5,000 rows. Omitted for normal results. |
| obsCount | Yes | Total number of observations matched (before any cap). |
| timeRange | Yes | Time coverage of the returned observations. |
| truncated | Yes | True when the result exceeded 5,000 observations and was capped. Apply dimension filters to get the full result. |
| datasetCode | Yes | Dataset code as provided. |
| datasetLabel | Yes | Human-readable dataset title. |
| observations | Yes | Decoded observations, capped at 5,000 rows. When truncated is true, apply dimension filters to narrow the result. |
| appliedFilters | Yes | Effective query parameters applied to the Eurostat API. |
| dimensionsUsed | Yes | Ordered list of dimension codes present in the response (e.g., ["freq", "unit", "na_item", "geo", "time"]). |
| missingObsCount | Yes | Number of observations with null value (missing data points in the source). |
eurostat_search_datasetsSearch Eurostat DatasetsRead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | 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 | Yes | 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 "business demography NUTS 3" or "regional economic accounts" resolve without naming a label verbatim. | |
| cursor | No | 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. |
Output Schema
| Name | Required | Description |
|---|---|---|
| query | Yes | Search terms as submitted. |
| datasets | Yes | Matching datasets for the current page, up to the requested limit. |
| nextStep | No | Suggested next action based on these results. Populated when there is a clear follow-up call. |
| truncated | Yes | True when more matches remain beyond this page — pass nextCursor as cursor to fetch them. |
| nextCursor | No | Opaque cursor for the next page of matches. Pass it back as cursor. Omitted on the last page. |
| totalMatches | Yes | Total datasets matching the query across all pages, before the page limit. |
Claim this connector by publishing a /.well-known/glama.json file on your server's domain with the following structure:
{
"$schema": "https://glama.ai/mcp/schemas/connector.json",
"maintainers": [{ "email": "your-email@example.com" }]
}The email address must match the email associated with your Glama account. Once published, Glama will automatically detect and verify the file within a few minutes.
Control your server's listing on Glama, including description and metadata
Access analytics and receive server usage reports
Get monitoring and health status updates for your server
Feature your server to boost visibility and reach more users
For users:
Full audit trail – every tool call is logged with inputs and outputs for compliance and debugging
Granular tool control – enable or disable individual tools per connector to limit what your AI agents can do
Centralized credential management – store and rotate API keys and OAuth tokens in one place
Change alerts – get notified when a connector changes its schema, adds or removes tools, or updates tool definitions, so nothing breaks silently
For server owners:
Proven adoption – public usage metrics on your listing show real-world traction and build trust with prospective users
Tool-level analytics – see which tools are being used most, helping you prioritize development and documentation
Direct user feedback – users can report issues and suggest improvements through the listing, giving you a channel you would not have otherwise
The connector status is unhealthy when Glama is unable to successfully connect to the server. This can happen for several reasons:
The server is experiencing an outage
The URL of the server is wrong
Credentials required to access the server are missing or invalid
If you are the owner of this MCP connector and would like to make modifications to the listing, including providing test credentials for accessing the server, please contact support@glama.ai.
Discussions
No comments yet. Be the first to start the discussion!