mcp-polska
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., "@mcp-polska Sprawdź firmę po NIP 5260250274 i jej status VAT"
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.
mcp-polska 🇵🇱
Polskie rejestry publiczne w Claude. Darmowy serwer MCP, dzięki któremu Claude (Desktop, Code, Cursor i inne klienty MCP) sam sprawdzi firmę po NIP, konto na Białej liście, odpis z KRS i kurs NBP do faktury.
Bez kluczy API, bez rejestracji — korzysta wyłącznie z otwartych API Ministerstwa Finansów, Ministerstwa Sprawiedliwości i NBP.
Co potrafi
Narzędzie | Co robi | Źródło |
| Sprawdza sumę kontrolną NIP (wyłapuje literówki) | offline |
| Status VAT, nazwa, adres, REGON, KRS i rachunki firmy | wl-api.mf.gov.pl |
| Czy konto z faktury należy do tego NIP (TAK/NIE + | wl-api.mf.gov.pl |
| Forma prawna, adres, kapitał, zarząd, reprezentacja, upadłość/likwidacja | api-krs.ms.gov.pl |
| Kurs średni NBP; z | api.nbp.pl |
Related MCP server: Polish Business Intelligence MCP
Przykładowe polecenia
Sprawdź firmę z NIP 5260250274 i czy konto 60 1010 1010 0038 2522 3000 0000 jest na białej liście.
Kto jest w zarządzie spółki z KRS 0000019193?
Faktura w EUR z datą sprzedaży 12.10.2026 — jaki kurs NBP przyjąć do VAT?
Instalacja
Wymaga Node.js 18 lub nowszego.
Claude Desktop
Otwórz Ustawienia → Developer → Edit Config i dodaj do claude_desktop_config.json:
{
"mcpServers": {
"polska": {
"command": "npx",
"args": ["-y", "github:auto-mate-pl/mcp-polska"]
}
}
}Zrestartuj Claude Desktop. W oknie rozmowy pojawią się narzędzia „polska”.
Claude Code
claude mcp add polska -- npx -y github:auto-mate-pl/mcp-polskaLokalnie (z klonu repozytorium)
git clone https://github.com/auto-mate-pl/mcp-polska.git
cd mcp-polska && npm install
# w konfiguracji klienta: "command": "node", "args": ["/ścieżka/do/mcp-polska/index.js"]Ograniczenia
API Białej listy ma dzienne limity zapytań (najostrzejsze dla wyszukiwania) — do masowej weryfikacji tysięcy kontrahentów używaj pliku płaskiego MF.
CEIDG i GUS/REGON wymagają kluczy API, dlatego nie są (jeszcze) w tym serwerze.
To narzędzie do sprawdzania danych w rejestrach, nie porada prawna ani podatkowa.
Chcesz więcej?
Ten serwer to darmowa część Biblioteki Auto-mate — 44 skille do Claude po polsku, m.in. Weryfikacja kontrahenta, Faktura pod KSeF i Oferty na Allegro, 21 promptów i kurs „Claude w marketingu”.
Licencja
MIT © Auto-mate. Zgłoszenia i pomysły: zakładka Issues.
Available Tools
5 toolsbiala_lista_kontoBiała lista VAT — czy konto należy do NIPA
Sprawdza, czy rachunek bankowy jest przypisany do danego NIP na Białej liście (ważne przy płatnościach powyżej 15 000 zł). Zwraca TAK/NIE i requestId jako dowód sprawdzenia.
Inputs: nip (required), konto (required), data.
biala_lista_nipBiała lista VAT — wyszukaj po NIPB
Zwraca dane podatnika z wykazu podatników VAT Ministerstwa Finansów (Biała lista): nazwa, status VAT, REGON, KRS, adres, rachunki bankowe, daty rejestracji i wykreślenia.
Inputs: nip (required), data.
krs_odpisKRS — odpis aktualnyA
Pobiera aktualny odpis z Krajowego Rejestru Sądowego: forma prawna, adres, kapitał, zarząd, sposób reprezentacji, upadłość/likwidacja.
Inputs: krs (required), pelny, rejestr.
nbp_kursKurs średni NBPA
Kurs średni waluty z tabeli A NBP. Z parametrem 'dla_faktury' zwraca kurs z ostatniego dnia roboczego PRZED podaną datą (zasada dla VAT i kosztów).
Inputs: waluta (required), data, dla_faktury.
nip_walidujWalidacja NIPA
Sprawdza sumę kontrolną polskiego numeru NIP (offline, bez zapytania do rejestru).
Inputs: nip (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a clearly distinct artifact or check: offline NIP checksum, VAT white-list taxpayer data, bank-account-to-NIP binding, KRS extract, and NBP exchange rate. The two biała_lista tools are cleanly separated by query object (NIP vs. bank account) and purpose. There is no meaningful overlap that would cause misselection.
All names use lowercase snake_case and are domain-prefixed, which makes the set predictable and readable. The only minor deviation is that nip_waliduj uses a noun_verb order while the others are noun_noun phrases, so the pattern is not perfectly uniform.
Five tools is well-scoped for a focused Polish business-verification utility. Each tool covers a distinct workflow and none feels redundant or arbitrarily added.
The surface covers core checks: NIP validation, VAT white-list lookup, bank-account verification, KRS extract, and NBP rates. Minor gaps remain, such as direct REGON validation or CEIDG lookup for sole proprietors, but common company-verification workflows are covered.
Maintenance
Related MCP Connectors
Verify Polish companies by NIP/KRS/REGON + EU VAT (VIES). 14 MCP tools (9 no-key).
Fakturownia (InvoiceOcean) MCP server for ChatGPT, Claude and any AI agent: issue invoice, send invoice, mark invoice paid, add client and list unpaid invoices in your own Fakturownia (InvoiceOcean) account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Fakturownia (InvoiceOcean) yourself; Cotlet does not store your password and you need no Fakturownia (InvoiceOcean) API key. About the official Fakturownia (InvoiceOcean) API: Yes. Fakturownia has a documented REST API that creates invoices, clients and payments, sends invoices by email and sends them to KSeF (checked 14 Oct 2026). Setup and FAQ: https://cotlet.dev/integrations/fakturownia-api-mcp-server
Polish companies and people: KRS, CEIDG, financials, boards, VAT, sanctions. Free, no API key.
iFirma MCP server for ChatGPT, Claude and any AI agent: issue invoice, send invoice, send to KSeF, add cost and list unpaid invoices in your own iFirma account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to iFirma yourself; Cotlet does not store your password and you need no iFirma API key. About the official iFirma API: Yes. iFirma has a documented JSON API that issues invoices, lists them, records payments, sends them by email and to KSeF, and adds cost documents (checked 14 Oct 2026). Setup and FAQ: https://cotlet.dev/integrations/ifirma-api-mcp-server
Related MCP Servers
- AlicenseAqualityCmaintenanceLook up Polish companies from any AI assistant: registry data (KRS, REGON, CEIDG), VAT white list checks before payments, and financial statements of 4.4M businesses. Read-only tools backed by official public registers.4MIT
- AlicenseAqualityDmaintenanceProvides AI agents with real-time access to Polish official data: VAT whitelist for company verification and NBP exchange rates, enabling checks on VAT status, company details, and currency conversion without API keys.5MIT
- AlicenseAqualityDmaintenanceMCP server that provides AI agents with Polish business data tools: identifier validation (NIP, PESEL, REGON, KRS, IBAN), VAT whitelist checks, EU VIES lookups, and NBP exchange rates.57 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to verify Polish companies and EU VAT numbers against official government registries using 9 tools, with no API key and optional plain REST access.MIT