statistik-austria-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@statistik-austria-mcp Search Austria's OGD catalog for population datasets and show the latest totals"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Python 3
pandas
httpx2
cachetools
uv
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
Open the config file. In Claude Desktop, go to Settings → Developer → Edit Config, or open it directly:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Add the server
{ "mcpServers": { "statistik-austria": { "command": "uvx", "args": ["--from", "git+https://github.com/DV155/Statistik-Austria-MCP-Server", "statistik-austria-mcp"] } } }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-mcpThe 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
Clone the repo
git clone https://github.com/DV155/Statistik-Austria-MCP-Server.git cd Statistik-Austria-MCP-ServerInstall the dependencies
uv syncStart 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 |
| Searches the catalog by keyword and returns matching dataset IDs and titles |
| Returns a dataset's dimensions and measures with their codes |
| Returns the data with labels, total-row flags and paging; |
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!
Fork the Project
Create your Feature Branch (
git checkout -b feature/AmazingFeature)Commit your Changes (
git commit -m 'Add some AmazingFeature')Push to the Branch (
git push origin feature/AmazingFeature)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 toolsfetch_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
Scored across 3 tools
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.
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.
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.
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
Related MCP Connectors
Search and query 1,500+ OECD statistical datasets via SDMX. Keyless.
Official statistics for AI agents: Eurostat, World Bank, OECD, IMF and WHO data for 150+ countries.
Query official statistics of Catalonia (Idescat): tables, metadata and JSON-stat data via MCP.
Open-data tables (Swiss government data, S&P 500 financials), cleaned and typed; search and SQL.
Related MCP Servers
- AlicenseAqualityAmaintenanceEnables 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.202,453 npm79MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables 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.1MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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