About mcp-polish-data
mcp-polish-data is an MCP server published by emilpinski in the Blockchain category: mCP server providing AI assistants access to Polish public registries (KRS, CEIDG) and statistical data (GUS BDL) for querying companies, sole proprietorships, and regional statistics.
Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/emilpinski/mcp-polish-dataThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (13)
batch_company_lookup(nips)Look up up to 50 companies by NIP simultaneously — returns name, VAT status, KRS number, REGON per NIP. Results cached 7 days.
Parameters not published.
cache_stats_info()Show SQLite cache statistics: total entries, per-tool breakdown, hits in last 24h
Parameters not published.
ceidg_search_business(name, nip, regon, surname)Search sole traders in CEIDG
Parameters not published.
gus_get_average_salary(year)Average gross salary by voivodeship
Parameters not published.
gus_get_population(unit_name, year)Population by voivodeship
Parameters not published.
gus_get_unemployment_rate(year)Unemployment rate by voivodeship
Parameters not published.
gus_search_variable(query)Discover statistical variables in GUS BDL
Parameters not published.
krs_get_company_details(krs_number)Full extract for a 9 or 10-digit KRS number
Parameters not published.
krs_search_company(nip)Search company by NIP (via VAT Whitelist — KRS API doesn't support name search)
Parameters not published.
validate_nip_number(nip)Validate NIP checksum — pure local computation, no API calls
Parameters not published.
Show all 13 tools
validate_pesel_number(pesel)Validate PESEL checksum and extract date of birth and gender (PII-sensitive, GDPR applies)
Parameters not published.
validate_regon_number(regon)Validate REGON checksum (9 or 14 digits) — pure local computation, no API calls
Parameters not published.
vat_whitelist_check(nip, check_date)Check VAT taxpayer status in MF Biala Lista — returns VAT status, registered bank accounts, response hash for audit
Parameters not published.
Ask AI
Ask AI about mcp-polish-data
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
mcp-polish-data
MCP Server with Polish public data — KRS, CEIDG, GUS BDL for Claude, Cursor, and Windsurf.
What is it
A Model Context Protocol (MCP) server that gives AI assistants direct access to Polish government registries and GUS statistics without leaving the chat. Install once, and Claude or Cursor automatically knows how to look up companies in KRS, verify sole traders in CEIDG, and retrieve regional statistics from GUS BDL.
MIT licensed, no API key required.
Features
- KRS — look up a company by NIP (via VAT Whitelist — KRS API doesn't support name search), retrieve full extract by 9 or 10-digit KRS number
- CEIDG — search sole trader businesses by name, NIP, REGON, or owner surname
- GUS BDL — population by voivodeship, unemployment rate, average gross salary, statistical variable discovery
- Graceful degradation — when CEIDG requires a JWT token, the server provides a helpful message instead of crashing
- Zero configuration — single pip install, no API keys required for basic functions
- Python 3.11+ — async/await, httpx, FastMCP 2.0
Stack
| Layer | Technology |
|---|---|
| Protocol | Model Context Protocol (MCP) |
| Framework | FastMCP 2.0 |
| HTTP | httpx (async) |
| Python | 3.11+ |
| Build | Hatchling |
| Tests | pytest, pytest-asyncio |
| License | MIT |
Getting Started
pip install mcp-polish-data
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"polish-data": {
"command": "mcp-polish-data"
}
}
}
Restart Claude Desktop — tools will appear automatically.
Cursor / Windsurf
git clone https://github.com/emilpinski/mcp-polish-data
cd mcp-polish-data
pip install -e ".[dev]"
pytest tests/ -v -m "not integration"
Available Tools
| Tool | Description |
|---|---|
krs_search_company(nip) |
Search company by NIP (via VAT Whitelist — KRS API doesn't support name search) |
krs_get_company_details(krs_number) |
Full extract for a 9 or 10-digit KRS number |
ceidg_search_business(name, nip, regon, surname) |
Search sole traders in CEIDG |
gus_get_population(unit_name, year) |
Population by voivodeship |
gus_get_unemployment_rate(year) |
Unemployment rate by voivodeship |
gus_get_average_salary(year) |
Average gross salary by voivodeship |
gus_search_variable(query) |
Discover statistical variables in GUS BDL |
Environment Variables
| Variable | Description | Required |
|---|---|---|
CEIDG_TOKEN |
JWT token for advanced CEIDG endpoints | optional |
Example Prompts
- "Look up NIP 5270103391 and tell me the company name and address"
- "Compare the unemployment rate in 2023 across all voivodeships"
- "What is the average salary in Pomerania vs Masovia?"
- "Find all CEIDG sole traders with surname Kowalski in Kraków"
Status
Live — mcp-polish-data.vercel.app | PyPI: mcp-polish-data
Built by Emil Piński
Screenshots
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.