Skip to main content
Glama
statistik-austria-mcp

statistik-austria-mcp

About The Project

A Model Context Protocol server for the free Open Government Data portal of Statistik Austria (data.statistik.gv.at). It lets an AI assistant such as Claude search the catalog, read a dataset's structure and fetch its data directly, instead of you downloading and pasting CSV files.

The portal publishes each dataset as a set of files with coded values, so a raw table is hard for a model to read correctly. The server joins the classification files onto the data, so every value arrives as a readable German label together with its original code, and marks the rows that are totals of other rows.

Built as a personal learning project to practise building MCP servers.

Features:

  • Keyword search over the full OGD catalog (around 540 datasets)

  • Dataset metadata: dimensions and measures

  • Data with codes resolved to German labels, formatted label <code>

  • Total rows are flagged, so the assistant doesn't add a total to its own parts

  • Filters by dimension value, so large tables don't have to be read in full

  • Paging that never drops rows silently: every response says how many rows exist and where to continue

  • Clear messages for datasets in formats the server can't read, instead of a bare error

  • Downloads are cached for an hour, so paging through a dataset doesn't download it again

Built With

Related MCP server: mcp-podatki-si

Getting Started

The server runs locally on your computer and talks to your MCP client over stdio. uvx installs and starts it, so there is nothing to clone for normal use.

Prerequisites

  • uv (it downloads a matching Python version automatically)

  • Git

  • Claude Desktop or Claude Code (or any other MCP client)

Installation

Claude Desktop

  1. Open the config file. In Claude Desktop, go to Settings → Developer → Edit Config, or open it directly:

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  2. Add the server

    {
      "mcpServers": {
        "statistik-austria": {
          "command": "uvx",
          "args": ["--from", "git+https://github.com/DV155/Statistik-Austria-MCP-Server", "statistik-austria-mcp"]
        }
      }
    }
  3. Quit Claude Desktop completely and start it again.

Claude Code

claude mcp add --transport stdio --scope user statistik-austria -- uvx --from git+https://github.com/DV155/Statistik-Austria-MCP-Server statistik-austria-mcp

The first start takes a while, because uv installs the dependencies (pandas is the largest). To get that out of the way, run the uvx command above once in a terminal and stop it with Ctrl+C once it is running. If Claude can't find uvx, replace "uvx" with its full path (which uvx shows it). Claude Desktop writes the server's logs to %APPDATA%\Claude\logs on Windows and ~/Library/Logs/Claude on macOS.

Local development

  1. Clone the repo

    git clone https://github.com/DV155/Statistik-Austria-MCP-Server.git
    cd Statistik-Austria-MCP-Server
  2. Install the dependencies

    uv sync
  3. Start the server in the MCP Inspector

    uv run mcp dev src/statserver/server.py

Usage

Ask Claude a question about Austrian statistics, and it uses the tools on its own.

Tool

What it does

search_dataset

Searches the catalog by keyword and returns matching dataset IDs and titles

fetch_dataset_json

Returns a dataset's dimensions and measures with their codes

fetch_dataset_csv

Returns the data with labels, total-row flags and paging; filters keeps only the rows for given dimension values

The server also provides an ogd://catalog resource with the catalog's categories.

Tip: the catalog's titles are German, so the server searches in German. Claude translates the question itself, but asking in German works just as well.

Limitations

Tested against all 543 datasets in the catalog in October 2026:

  • 474 load fully

  • 66 are published in formats the server can't read (zip archives and map services such as WFS and WMS); the server says so instead of failing

  • 2 contain no data rows

  • 1 (OGDEXT_BINNENWAND_1) loads without labels and slowly

Other limitations:

  • Only the free OGD portal is supported, not the paid STATcube API

  • The catalog is read from the portal's HTML page, so search stops working if Statistik Austria changes that page's structure

  • The first request for a very large dataset can take several seconds while it downloads

Data Source

All data comes from Statistik Austria - data.statistik.gv.at, licensed under CC BY 4.0. When you publish results obtained through this server, credit Statistik Austria as the source.

This is an independent project and is not affiliated with or endorsed by Statistik Austria.

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project

  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)

  3. Commit your Changes (git commit -m 'Add some AmazingFeature')

  4. Push to the Branch (git push origin feature/AmazingFeature)

  5. Open a Pull Request

Top contributors:

License

Distributed under the MIT license. See LICENSE for more information.

Contact

Daniil Vasilcovschii - LinkedIn - GitHub

Project Link: https://github.com/DV155/Statistik-Austria-MCP-Server

Available Tools

3 tools
fetch_dataset_csvA

Fetch an OGD dataset's data with codes resolved to German labels, formatted "label ". dataset_id is the Statistik Austria dataset identifier (e.g. "OGD_vpi86_VPI_1986_1"). "aggregate" names the dimensions in which a row is a total of other rows; never sum it with them. Empty "aggregate" does not guarantee rows can be summed (overlapping groupings exist, e.g. VPI). Dimensions in "unlabeled_dimensions" have raw codes and no aggregate information. filters: {dimension code: [value codes]} keeps matching rows, e.g. {"C-A10-0": ["A10-2024"]}; values are the parts. Pages: at most limit rows (max 5000, fewer if rows are large); if "truncated", continue at offset + returned with the same filters.

Inputs: dataset_id (required), limit, offset, filters.

fetch_dataset_jsonA

Return the dimension and measure metadata for an OGD dataset. dataset_id is the Statistik Austria dataset identifier (e.g. "OGD_vpi86_VPI_1986_1").

Inputs: dataset_id (required).

search_datasetA

Search the OGD catalog by keyword. By default every query word of 3+ characters must appear in a result; word parts match too. An empty query returns recently updated datasets. Titles are in German, so search with German keywords (e.g. "Bevölkerung", not "population"). Pass a result's "id" to fetch_dataset_json or fetch_dataset_csv. Some datasets aren't standard CSV tables; fetch_dataset_csv then explains why it can't load them. Pages: at most limit results (max 50); if "truncated", continue at offset + returned. Setting match_all=False returns datasets containing any query word, best matches first.

Inputs: limit, query, offset, match_all.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 3 tools

    Disambiguation5/5

    The three tools have clearly distinct roles: catalog search, CSV data retrieval, and metadata retrieval. An agent can easily determine whether it needs to search, fetch data, or inspect metadata.

    Naming Consistency5/5

    All tool names use consistent snake_case and follow a predictable verb_dataset pattern. The suffixes _csv and _json clearly distinguish the two fetch variants.

    Tool Count5/5

    Three tools are well-scoped for a read-only statistical catalog server: search, fetch data, and fetch metadata. Each tool has a clear purpose and no extraneous operations.

    Completeness4/5

    The surface covers the core read-only workflow of finding datasets, retrieving their data, and inspecting metadata. However, datasets that are not standard CSV tables appear to be a dead end for actual data access, with only an explanatory error from fetch_dataset_csv.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      A
      maintenance
      Enables AI assistants to search, explore, and query any CKAN open data portal through natural language, making public datasets accessible without requiring knowledge of the portal's API.
      20
      2,453 npm
      79
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to search and query datasets from Slovenia Open Data (podatki.gov.si) via its CKAN API, including searching datasets, retrieving metadata, and querying tabular resources.
      84 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables language models to search and query Statistics Netherlands open data, turning natural-language questions into traceable statistics by discovering tables, resolving codes, and retrieving filtered observations.
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to search, preview, and query Ireland's public-sector open data catalogue, including CSV, Excel, JSON, GeoJSON, and JSON-stat resources. It supports filtering, grouping, counting, summing, and sorting datasets conversationally without manual downloads or cleanup.
      MIT