Skip to main content
Glama

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

nip_waliduj

Sprawdza sumę kontrolną NIP (wyłapuje literówki)

offline

biala_lista_nip

Status VAT, nazwa, adres, REGON, KRS i rachunki firmy

wl-api.mf.gov.pl

biala_lista_konto

Czy konto z faktury należy do tego NIP (TAK/NIE + requestId jako dowód)

wl-api.mf.gov.pl

krs_odpis

Forma prawna, adres, kapitał, zarząd, reprezentacja, upadłość/likwidacja

api-krs.ms.gov.pl

nbp_kurs

Kurs średni NBP; z dla_faktury: true — z dnia roboczego przed datą (zasada dla VAT)

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-polska

Lokalnie (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”.

👉 auto-mate.space/skille

Licencja

MIT © Auto-mate. Zgłoszenia i pomysły: zakładka Issues.

Available Tools

5 tools
biala_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

    A3.7/5.0

    Scored across 5 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Look 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.
      4
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      5
      7 npm
      MIT