MCP server
Eurostat MCP Server
Search and query the Eurostat catalogue — EU economy, demography, trade, and NUTS…
- Pricing
- Open source
- Runs
- Locally or Remotely
- Version
- 0.11.4
- Listing updated
- 4 days ago
About Eurostat MCP Server
Eurostat MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.
Search and query the Eurostat catalogue — EU economy, demography, trade, and NUTS regional data.
Install
Run in a terminal
claude mcp add --transport http eurostat-mcp-server https://eurostat.caseyjhand.com/mcpAdd to Settings → Connectors → Add custom connector
https://eurostat.caseyjhand.com/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"eurostat-mcp-server": {
"url": "https://eurostat.caseyjhand.com/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"eurostat-mcp-server": {
"type": "http",
"url": "https://eurostat.caseyjhand.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"eurostat-mcp-server": {
"serverUrl": "https://eurostat.caseyjhand.com/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"eurostat-mcp-server": {
"type": "http",
"url": "https://eurostat.caseyjhand.com/mcp"
}
}
}Configuration
EUROSTAT_CLAMP_LIMITSClamp positive integer preview/search/dimension limits to 500/100/1000 with a notice. False restores schemas rejecting over-cap inputs.MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').EUROSTAT_BASE_URLEurostat API base URL. Override when using a mirror or proxy.EUROSTAT_COMEXT_BASE_URLBase URL of the Comext dissemination host, which serves every DS-* dataset code (detailed trade and PRODCOM). Override when using a mirror or proxy.EUROSTAT_REQUEST_TIMEOUT_MSTotal allowance for one Eurostat request across retries, backoff and body consumption, in milliseconds.EUROSTAT_METADATA_TIMEOUT_MSTotal allowance for one dataset's SDMX dataflow structure across retries, backoff and body consumption, in milliseconds. Defaults to 120000; separate from EUROSTAT_REQUEST_TIMEOUT_MS for large structures.EUROSTAT_TOC_CACHE_TTL_MSHow long a fetched catalogue TOC stays usable before the next catalogue call refreshes it, in milliseconds. Defaults to 12 hours.EUROSTAT_BULK_TIMEOUT_MSTime budget for one eurostat_download_dataset call in milliseconds, counted from the start of the call: a filtered download's structure read, request retries, backoff and the streamed body with its staging all come out of it. Reached after rows have streamed, it keeps them as a prefix with budgetExceeded set; before the first row, the call fails as retry_deadline_exceeded. Defaults to 55000, under the 60-second request timeout of MCP SDK clients.EUROSTAT_BULK_MAX_BYTESByte budget for one eurostat_download_dataset transfer, counted on the decoded TSV rather than on the wire. Eurostat sends the body chunked with no Content-Length, so the budget is enforced while streaming and the transfer is aborted when it is reached. Defaults to 50 MiB.CANVAS_PROVIDER_TYPEDataframe canvas backend. The default, 'duckdb', lists eurostat_dataframe_describe and eurostat_dataframe_query, stages query matches with stage=true or above 5,000 observations, and retains bulk downloads beyond their previews. Set to 'none' to disable the canvas and those tools. The DuckDB binding ships with the server.CANVAS_TEMP_PATHParent directory for DuckDB canvas spill files: a private 'mcp-canvas-XXXXXX' directory is created inside it, so it must be writable by the server process. Defaults to the OS temp directory.CANVAS_TTL_MSSliding lifetime of a staged dataframe canvas in milliseconds; every call against it extends the window. Defaults to 24 hours.CANVAS_DEFAULT_ROW_LIMITMaximum complete rows a single eurostat_dataframe_query returns before reporting truncated.EUROSTAT_DATAFRAME_DROP_ENABLEDSet to 'true' to list eurostat_dataframe_drop, which removes one staged table from a dataframe canvas and leaves its other tables in place. Off by default because a drop cannot be undone; staged tables expire with their canvas either way. Has no effect with CANVAS_PROVIDER_TYPE=none.MCP_TRANSPORT_TYPESelects the HTTP transport.EUROSTAT_CLAMP_LIMITSClamp positive integer preview/search/dimension limits to 500/100/1000 with a notice. False restores schemas rejecting over-cap inputs.MCP_HTTP_HOSTThe hostname for the HTTP server.MCP_HTTP_PORTThe port to run the HTTP server on.MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.MCP_PUBLIC_URLPublic origin override for deployments behind a TLS-terminating reverse proxy (e.g. https://mcp.example.com).MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').EUROSTAT_BASE_URLEurostat API base URL. Override when using a mirror or proxy.EUROSTAT_COMEXT_BASE_URLBase URL of the Comext dissemination host, which serves every DS-* dataset code (detailed trade and PRODCOM). Override when using a mirror or proxy.EUROSTAT_REQUEST_TIMEOUT_MSTotal allowance for one Eurostat request across retries, backoff and body consumption, in milliseconds.EUROSTAT_METADATA_TIMEOUT_MSTotal allowance for one dataset's SDMX dataflow structure across retries, backoff and body consumption, in milliseconds. Defaults to 120000; separate from EUROSTAT_REQUEST_TIMEOUT_MS for large structures.EUROSTAT_TOC_CACHE_TTL_MSHow long a fetched catalogue TOC stays usable before the next catalogue call refreshes it, in milliseconds. Defaults to 12 hours.EUROSTAT_BULK_TIMEOUT_MSTime budget for one eurostat_download_dataset call in milliseconds, counted from the start of the call: a filtered download's structure read, request retries, backoff and the streamed body with its staging all come out of it. Reached after rows have streamed, it keeps them as a prefix with budgetExceeded set; before the first row, the call fails as retry_deadline_exceeded. Defaults to 55000, under the 60-second request timeout of MCP SDK clients.EUROSTAT_BULK_MAX_BYTESByte budget for one eurostat_download_dataset transfer, counted on the decoded TSV rather than on the wire. Eurostat sends the body chunked with no Content-Length, so the budget is enforced while streaming and the transfer is aborted when it is reached. Defaults to 50 MiB.CANVAS_PROVIDER_TYPEDataframe canvas backend. The default, 'duckdb', lists eurostat_dataframe_describe and eurostat_dataframe_query, stages query matches with stage=true or above 5,000 observations, and retains bulk downloads beyond their previews. Set to 'none' to disable the canvas and those tools. The DuckDB binding ships with the server.CANVAS_TEMP_PATHParent directory for DuckDB canvas spill files: a private 'mcp-canvas-XXXXXX' directory is created inside it, so it must be writable by the server process. Defaults to the OS temp directory.CANVAS_TTL_MSSliding lifetime of a staged dataframe canvas in milliseconds; every call against it extends the window. Defaults to 24 hours.CANVAS_DEFAULT_ROW_LIMITMaximum complete rows a single eurostat_dataframe_query returns before reporting truncated.EUROSTAT_DATAFRAME_DROP_ENABLEDSet to 'true' to list eurostat_dataframe_drop, which removes one staged table from a dataframe canvas and leaves its other tables in place. Off by default because a drop cannot be undone; staged tables expire with their canvas either way. Has no effect with CANVAS_PROVIDER_TYPE=none.
Pricing
Open source
Eurostat MCP Server FAQ
Is Eurostat MCP Server free?
Yes. Eurostat MCP Server is open source, so you can use and self-host it for free.
How do I add Eurostat MCP Server to Claude Code?
Run this command in your terminal: claude mcp add --transport http eurostat-mcp-server https://eurostat.caseyjhand.com/mcp