destatis-mcp

MCP server for the German Federal Statistical Office (Destatis) Genesis-Online API. Access 330+ official German statistics with 1.2 billion data points directly from Claude, Cursor, or any MCP-compatible AI client.

Quick Start

1. Get a free API account

Register at genesis.destatis.de (free).

2. Add to your MCP client

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "destatis": {
      "command": "npx",
      "args": ["-y", "destatis-mcp"],
      "env": {
        "DESTATIS_USERNAME": "your-username",
        "DESTATIS_PASSWORD": "your-password"
      }
    }
  }
}

Claude Code (.claude/settings.json):

{
  "mcpServers": {
    "destatis": {
      "command": "npx",
      "args": ["-y", "destatis-mcp"],
      "env": {
        "DESTATIS_USERNAME": "your-username",
        "DESTATIS_PASSWORD": "your-password"
      }
    }
  }
}

Available Tools (14)

Search

| Tool | Description | |------|-------------| | find | Full-text search across all statistics, tables, variables |

Catalogue (9)

| Tool | Description | |------|-------------| | catalogue_statistics | List all 330+ statistics | | catalogue_tables | List tables for a statistic (e.g. 52111*) | | catalogue_variables | List all 2,500+ variables | | catalogue_values | Get valid codes for a variable (e.g. all WZ industry codes) | | catalogue_tables_for_variable | Find tables using a specific variable | | catalogue_variables_for_statistic | Get variables for a statistic | | catalogue_statistics_for_variable | Find statistics using a variable | | catalogue_cubes | List data cubes | | catalogue_timeseries | List time series |

Metadata (2)

| Tool | Description | |------|-------------| | metadata_table | Table structure: dimensions, measures, time range, filters | | metadata_variable | Variable details: type, values, breakdown |

Data (2)

| Tool | Description | |------|-------------| | data_table | Query data with filters → formatted table + raw CSV | | data_tablefile | Download flat-file CSV (machine-readable, for large datasets) |

Example Workflows

"How many companies are in the German mechanical engineering sector?"

1. find → term: "Maschinenbau"
2. catalogue_tables → selection: "48112*"
3. metadata_table → name: "48112-0001"
4. data_table → name: "48112-0001", startyear: "2023", endyear: "2023", classifyingvariable1: "WZ08F2", classifyingkey1: "WZ08-28"

"Show insolvency trends by industry"

1. find → term: "Insolvenz"
2. catalogue_tables → selection: "52411*"
3. data_table → name: "52411-0068", startyear: "2020", endyear: "2024"

"What is the population of Bavaria?"

1. data_table → name: "12411-0010", startyear: "2023", endyear: "2023", regionalvariable: "DLAND", regionalkey: "09"

Data Domains

The API covers all official German statistics including:

• Enterprise statistics — company counts, revenue, employees by industry (WZ 2-5 digit)
• SME statistics — micro, small, medium, large enterprises
• Insolvency statistics — proceedings, claims, affected employees
• Business registrations — foundings and closures
• Population — demographics by region, age, nationality
• Labor market — employment, unemployment, short-time work
• Consumer prices — CPI, inflation rates
• Foreign trade — imports/exports by country and product (8-digit)
• National accounts — GDP, consumption, investment

Important Variable Codes

| Variable | Description | |----------|-------------| | WZ08F2 | Industry codes 2-digit (80 sectors) | | WZ08A5 | Industry codes 5-digit (detailed) | | DLAND | Federal states (16) | | KREISE | Districts (476) | | BESG12 | Employee size classes | | JAHR | Years |

License

MIT — Greyt GmbH