bartosz-kuc/honest-stat-gov-mcp
БесплатноНе проверенPolish Central Statistical Office (GUS) Local Data Bank (BDL): browse subjects, search variables and territorial units (voivodeship, powiat, gmina), get unit de
Описание
Polish Central Statistical Office (GUS) Local Data Bank (BDL): browse subjects, search variables and territorial units (voivodeship, powiat, gmina), get unit details, and fetch a variable's time series over a year range. No API key; queries bdl.stat.gov.pl directly with no third-party middleman.
README
Local MCP server for the Polish Central Statistical Office (GUS) Bank Danych Lokalnych (BDL) — the definitive public source for Polish socioeconomic statistics: population, prices, business demographics, unemployment, GDP, at country / voivodeship / powiat / gmina resolution.
Part of the honest-mcp family of small, auditable, local-first MCP servers.
Why
BDL contains tens of thousands of time series about Poland. Its web UI (bdl.stat.gov.pl) is powerful but slow to navigate when you know exactly what you want. The public REST API is the fast path but has enough concepts (subjects → variables → units → data) to make manual use annoying. This server lets your AI find the right variable and unit and pull the data — one conversation, done.
Same trust model as the rest of the family: data flows only between your machine and GUS.
Features
Five tools:
search_subjects— browse or search the subject tree (e.g., "CENY", "LUDNOŚĆ")search_variables— find data series in a subjectsearch_units— find territorial units (voivodeship, powiat, gmina) by name and/or levelget_unit_details— full record for a unit IDget_data— pull actual values for a variable across chosen units and year range. Withunit_ids, only those units are returned (one API request per unit); without them, all voivodeships
Data source
- Endpoint: bdl.stat.gov.pl/api/v1 — GUS BDL public REST API
- No API key required; anonymous limits are 5 req/s, 100 per 15 min, 1,000 per 12 h and 10,000 per 7 days (api.stat.gov.pl)
get_datawithunit_idsmakes one request per unit (at most 4 req/s); on HTTP 429 it stops and lists the units it did not fetch- Higher limits are available with free registration (API key); this server does not send a key, so it always uses the anonymous limits
Requirements
- Python 3.10+
Setup
git clone https://github.com/bartosz-kuc/honest-stat-gov-mcp.git
cd honest-stat-gov-mcp
python3 -m venv venv
./venv/bin/pip install -r requirements.txt
On Windows, use venv\Scripts\pip and venv\Scripts\python instead of the venv/bin/... paths here and below.
Register with Claude Code:
claude mcp add stat-gov /absolute/path/to/venv/bin/python /absolute/path/to/server.py
Claude Desktop claude_desktop_config.json:
{
"mcpServers": {
"stat-gov": {
"command": "/absolute/path/to/venv/bin/python",
"args": ["/absolute/path/to/server.py"]
}
}
}
Example usage
"How has the average monthly wage changed in Mazowieckie over the last 10 years?"
Three-step: search_variables(name="przeciętne wynagrodzenie") → note variable ID → search_units(name="mazowieckie", level=2) → note unit ID → get_data(variable_id=..., unit_ids=[...], year_from=2015, year_to=2024) (with only year_from, just that one year is returned).
"Which voivodeships had the highest unemployment in 2024?"
search_variables(name="stopa bezrobocia") → get_data(variable_id=..., year_from=2024, year_to=2024) — default returns all voivodeships.
Data flow
Your AI client
↕ MCP stdio
This server (Python, on your machine)
↕ HTTPS
bdl.stat.gov.pl (GUS)
No cloud middle. No telemetry.
Author
Bartosz Kuć — Warsaw-based developer, JDG owner running skanfirmy.pl.
GitHub: https://github.com/bartosz-kuc
Email: [email protected]
Consulting
Available for consulting on Polish tax and business integrations (KSeF, GUS/NFZ/GIOŚ APIs, mBank data), MCP server design, and AI-assisted tooling for JDGs and small teams. See skanfirmy.pl/uslugi for productized packages (audit 3k PLN, setup 8-15k PLN, retainer 2-4k PLN/mo), or reach out via email.
License
MIT — see LICENSE.
Related
- Part of the honest-mcp family — see the family index.
Установка bartosz-kuc/honest-stat-gov-mcp
У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.
▸ github.com/bartosz-kuc/honest-stat-gov-mcpFAQ
bartosz-kuc/honest-stat-gov-mcp MCP бесплатный?
Да, bartosz-kuc/honest-stat-gov-mcp MCP бесплатный — установка в пару кликов через Unyly без оплаты.
Нужен ли API-ключ для bartosz-kuc/honest-stat-gov-mcp?
Нет, bartosz-kuc/honest-stat-gov-mcp работает без API-ключей и переменных окружения.
bartosz-kuc/honest-stat-gov-mcp — hosted или self-hosted?
Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.
Как установить bartosz-kuc/honest-stat-gov-mcp в Claude Desktop, Claude Code или Cursor?
Открой bartosz-kuc/honest-stat-gov-mcp на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.
Похожие MCP
GitHub
PRs, issues, code search, CI status
автор: GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
автор: mcpdotdirectServer Sequential Thinking
MCP server for sequential thinking and problem solving
автор: GitHub ActionsUnyly Deploy
Deploy sites and MCP servers to Unyly straight from your AI agent
автор: UnylyAmap Maps Mcp Server
MCP server for using the AMap Maps API
автор: duxiaohuiPayMCP
Lightweight payments layer for MCP servers: turn tools into paid endpoints with a two-line decorator. [PyPI](https://pypi.org/project/paymcp/) · [npm](https://w
автор: blustAIServer For Power BI
Enables exploring Microsoft Fabric / Power BI workspaces and semantic models, and executing ad-hoc DAX queries.
автор: Mitsubishi-FusoGpt Image 2 Mcp
RunAPI GPT Image 2 MCP server for image generation: create tasks, poll results, and check pricing across 1 model from Claude Code, Codex, Cursor, and VS Code.
автор: runapi-aiCompare bartosz-kuc/honest-stat-gov-mcp with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории development
