Eurostat MCP Server

A Model Context Protocol (MCP) server that provides tools to query Eurostat APIs for European statistics data.

Features

• Search datasets - Find Eurostat datasets by keyword
• Query data - Retrieve data with flexible filtering options
• Export to CSV - Save data locally for further analysis
• Support for both APIs:
  • SDMX 3.0 API for regular datasets (GDP, unemployment, population, etc.)
  • SDMX 2.1 Comext API for trade/production datasets (DS-prefixed)

Available Tools

Installation

Prerequisites

• Python 3.10 or higher
• uv (recommended) or pip

Install with uv (recommended)

# Clone the repository
git clone https://github.com/YOUR_USERNAME/eurostat-mcp.git
cd eurostat-mcp

# Install dependencies
uv pip install -r requirements.txt

Install with pip

# Clone the repository
git clone https://github.com/YOUR_USERNAME/eurostat-mcp.git
cd eurostat-mcp

# Create virtual environment (optional but recommended)
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

Configuration

Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "eurostat": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/eurostat-mcp",
        "run",
        "server.py"
      ]
    }
  }
}

Or with Python directly:

{
  "mcpServers": {
    "eurostat": {
      "command": "python",
      "args": ["/path/to/eurostat-mcp/server.py"]
    }
  }
}

Claude Code (CLI)

Add to your Claude Code settings (.claude/settings.json in your project or ~/.claude/settings.json globally):

{
  "mcpServers": {
    "eurostat": {
      "command": "python",
      "args": ["/path/to/eurostat-mcp/server.py"]
    }
  }
}

Usage Examples

Search for datasets

Search for GDP datasets
→ search_datasets("GDP")

Query unemployment data

Get monthly unemployment rate for Germany and France in 2024
→ query_eurostat_data(
    dataset_id="UNE_RT_M",
    geo="DE+FR",
    time_period="ge:2024"
  )

Query international trade data (Comext)

Get German exports to China in 2024
→ query_eurostat_data(