Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Bewertungen und Benutzerkonten folgen in einem späteren Schritt.
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

skanfirmy.pl

von bartosz-kucVersion 1.4.0i★ –iLäuft in der Cloud
Name in der Registryio.github.bartosz-kuc/skanfirmy

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

Verify Polish companies by NIP/KRS/REGON + EU VAT (VIES). 14 MCP tools (9 no-key).

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

  • Verbindung: Läuft in der Cloud
  • Transport: Streamable HTTP
  • Kategorie: Sonstiges

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Du brauchst

Welche App nutzt du?

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Funktioniert in Claude im Web, auf dem Desktop und auf dem Handy:

  1. Öffne Settings → Connectors
  2. Tippe auf Add custom connector
  3. Füge die Adresse unten ein und tippe auf Add
  4. Wenn eine Anmeldung verlangt wird, melde dich beim Dienst des Entwicklers an
SettingsConnectors1+ Add2https://…3
https://skanfirmy.pl/mcp

Führe das in deinem Terminal aus

claude mcp add --transport http skanfirmy https://skanfirmy.pl/mcp

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "skanfirmy": {
      "url": "https://skanfirmy.pl/mcp"
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "skanfirmy": {
      "type": "http",
      "url": "https://skanfirmy.pl/mcp"
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

ChatGPT verbindet sich nur mit Servern im Internet:

  1. Öffne ChatGPT im Web → Settings → Connectors (Apps)
  2. Tippe auf Create oder Add (bei manchen Tarifen musst du zuerst Developer mode unter Advanced einschalten)
  3. Füge die Adresse unten ein, gib ihr einen Namen und speichere
  4. Wenn eine Anmeldung verlangt wird, melde dich beim Dienst des Entwicklers an
SettingsConnectors1+ Create2https://…3
https://skanfirmy.pl/mcp

Menünamen können sich je nach Tarif und mit der Zeit leicht unterscheiden.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 8. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • sprawdz_nip

    Check VAT status (VAT White List / Biała Lista) and KRS data for a Polish company by NIP. For entities without a KRS number (sole proprietors and civil partnerships, i.e. natural persons) personal data is limited (GDPR): the address is reduced to the town (the White List does not

  • sprawdz_lista_nip

    Bulk-check up to 30 NIPs in one call to the Ministry of Finance VAT White List: VAT status, bank accounts, REGON, KRS number and address of each entity. For entities without a KRS number (natural persons) the address is reduced to the town and bank accounts to their count, and no

  • sprawdz_regon

    Look up entity data in the REGON register (Statistics Poland / GUS BIR) by NIP: REGON number, official name, legal form (legal or natural person), address (voivodeship, county, municipality). Covers ALL entities, including sole proprietors that are not in the KRS. For natural per

  • sprawdz_vies

    Validate a counterparty's EU VAT number in the VIES system (European Commission). For Polish (PL) numbers the address is reduced to the town, because the number may belong to a natural person (GDPR).

  • sprawdz_rachunek

    Check whether a bank account number (NRB) appears in the VAT White List for a given NIP. Due diligence for payments above PLN 15,000.

  • generuj_mikrorachunek

    Generate the individual tax micro-account (for PIT/CIT/VAT payments) from a NIP. The server does not accept PESEL (personal ID) — for a PESEL compute it locally: BBAN = "101000712221" + PESEL + "0", IBAN = "PL" + ISO 7064 mod-97 check digits + BBAN (or use skanfirmy.pl/mikrorachu

  • szukaj_pkd

    Search PKD 2025 business activity codes by activity name or code number.

  • oblicz_odsetki

    Calculate statutory or commercial (B2B) late-payment interest, broken down by NBP reference-rate periods.

  • szukaj_katalog_api

    Search otwarteAPI.pl, a catalog of public Polish and EU APIs (VAT, KRS, GUS, NBP, ECB, Eurostat and more). Returns matching entries with a link to each API's official docs. An empty query returns the whole catalog (optionally narrowed by scope or topic).

  • observe_nip

    Add a NIP to monitoring. You get notified (via changes_since or email) when its VAT status, bank account, or registry data shown on the Ministry of Finance White List (name, address, KRS, REGON) changes. For natural persons running a business (entities without a KRS number) only

  • unobserve_nip

    Stop watching a NIP — the watch is deleted right away. Requires a skanfirmy API key.

  • list_observations

    Return the list of NIPs you monitor, with their current VAT status and last-checked date (name is null for natural persons running a business). Each entry keeps the raw Ministry of Finance literal in status_vat and, when a status is known, adds derived language-neutral fields vat

  • changes_since

    Return changes (VAT status, bank accounts, or registry data — name, address, KRS, REGON — from the White List) detected since a given date for the NIPs you monitor. The field property is one of: status_vat, account_added, account_removed, name, address, krs, regon. For natural pe

  • set_webhook

    Set (or clear) a push webhook URL for your monitoring, instead of or in addition to polling. When we detect a change for a monitored NIP, we send a POST signed with HMAC-SHA256 (X-Skanfirmy-Signature header). Returns the secret ONCE. Pass an empty url to disable. Requires a skanf

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 9. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto bartosz-kuc bestätigt, dem das Repo gehört

  • … Noch nicht geprüft

    Wird noch gepflegt

    Dieses Repo haben wir noch nicht von GitHub gelesen

  • … Noch nicht geprüft

    Hat eine Lizenz

    Dieses Repo haben wir noch nicht von GitHub gelesen

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 147 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✓ Bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Wir haben 14 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

Im Vergleich mit anderen in Sonstigesi

  • Mehr Sterne als 0 % der anderen 18639 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 55 % der anderen 18639 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 100 % der anderen 18639 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist skanfirmy.pl sicher?

Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (1.4.0) kam vor 37 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL, also funktionieren auch Apps, die Remote-MCP-Server akzeptieren, zum Beispiel ChatGPT im Entwicklermodus.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Spec Driven Development, Remote Desktop Commander, Statuser

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Spec Driven Development

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

von formulahendryAm Anfang↓ 66/Wo.★ 440Aktualisiert vor 14 Monaten

Läuft auf deinem Computer

Remote Desktop Commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

von desktop-commanderWachsend★ 211Aktualisiert vor 3 Tagen

Läuft in der Cloud✓ desktopcommander.app

Statuser

Monitor services, manage incidents and status pages in Statuser.cloud from your AI assistant.

von statuser-cloudAm Anfang↓ 1033/Wo.Aktualisiert heute

Computer oder Cloud

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

skanfirmy.pl — MCP server

A free, stateless MCP (Model Context Protocol) server that lets AI agents verify Polish companies and validate EU VAT numbers directly from official government registers. No key and no registration for the lookups; per-IP rate limits apply (see Limits and personal data).

  • Endpoint: https://skanfirmy.pl/mcp (JSON-RPC 2.0 over Streamable HTTP)
  • 14 tools: 9 lookups and calculators combining the VAT Register (Ministry of Finance), KRS (Ministry of Justice), REGON (Statistics Poland / GUS) and VIES (European Commission), plus 5 tools for the optional change monitoring, which need an API key.
  • Also usable as plain REST for crawlers/agents that can't speak MCP.

Made by [Bartosz Kuć](https://skanfirmy.pl) — the same person behind skanfirmy.pl and the otwarteAPI.pl catalog of Polish & EU public APIs.

Tools

ToolWhat it does
sprawdz_nipVAT status (Biała Lista) + KRS data for a company by NIP
sprawdz_lista_nipBulk lookup of up to 30 NIPs in one call (MF VAT Register)
sprawdz_regonREGON registry data (GUS) by NIP; for sole traders and other natural persons only name, legal form, entity type, town and activity status
sprawdz_viesValidate an EU VAT number via VIES (European Commission)
sprawdz_rachunekIs a bank account on the VAT White List for a given NIP
generuj_mikrorachunekIndividual tax micro-account (PIT/CIT/VAT) from a NIP; the formula for a PESEL is in the tool description, to compute locally
szukaj_pkdSearch the PKD 2025 business-activity classification
oblicz_odsetkiStatutory / commercial (B2B) late-payment interest calculator
szukaj_katalog_apiSearch otwarteAPI.pl — a catalog of other public PL/EU APIs

Monitoring tools (need a skanfirmy API key, which you get after confirming a sign-up at skanfirmy.pl/monitoring): observe_nip, unobserve_nip, list_observations, changes_since, set_webhook.

Limits and personal data

  • Rate limits per IP address. MCP: at most 60 requests per 10 seconds, then HTTP 429 with a JSON-RPC error (error.data.contact) for 10 seconds. REST endpoints: at most 20 requests per 10 seconds, then HTTP 429 for 10 seconds. The service is meant for single lookups started by users or their agents, not for bulk data harvesting.
  • Source limits. The Ministry of Finance White List API has its own daily limits (search: 100 queries a day, up to 30 NIPs each), shared by all users of the service. When they run out, lookups answer HTTP 503 until the next day.
  • Sole traders and other natural persons (entities without a KRS number, and civil partnerships) get minimised data (GDPR): name, NIP, VAT status, town and the *number* of White List accounts. No REGON number, address, registration date, PKD codes or list of account numbers. To check one specific account, use sprawdz_rachunek (REST: POST /rachunek).
  • Numbers restricted from presentation. Data for some numbers is not presented (a data-protection procedure). The answer is then restricted: true with a fixed sentence and a link to the Ministry of Finance search, with no data and no fields about validity, VAT status or presence in the register. Send the user to the official search.

Connect

Any MCP client that supports remote (Streamable HTTP) servers — point it at:

https://skanfirmy.pl/mcp

Claude Desktop / stdio-only clients — bridge with mcp-remote:

{

"mcpServers": { "skanfirmy": { "command": "npx", "args": ["-y", "mcp-remote", "https://skanfirmy.pl/mcp"] } } }

Raw JSON-RPC (no MCP client needed):

# list tools

curl -s https://skanfirmy.pl/mcp \ -H 'Content-Type: application/json' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

check a company by NIP

curl -s https://skanfirmy.pl/mcp \ -H 'Content-Type: application/json' \ -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"sprawdz_nip","arguments":{"nip":"5261040828"}}}'

Plain REST (no MCP)

For agents/crawlers that just want a URL:

  • GET https://skanfirmy.pl/nip/{nip} — VAT + KRS
  • GET https://skanfirmy.pl/nips/{comma,separated,nips} — bulk (≤30)
  • GET https://skanfirmy.pl/regon/{nip} — REGON registry data
  • GET https://skanfirmy.pl/vies/{country}/{number} — EU VAT (VIES)
  • POST https://skanfirmy.pl/rachunek — is one bank account on the White List for a NIP

Add ?format=json for JSON. Full docs: skanfirmy.pl/llms.txt, OpenAPI: skanfirmy.pl/openapi.yaml.

Claude Agent Skill

Prefer a drop-in Agent Skill? skill/ holds `verify-polish-company` — a single SKILL.md that teaches Claude Code, the Claude apps or the Agent SDK when and how to call the endpoints above (no key, nothing to run beyond ordinary HTTP):

cp -R skill ~/.claude/skills/verify-polish-company

See skill/README.md for details.

Data sources

VAT Register / Biała Lista (Ministry of Finance), KRS (Ministry of Justice), REGON / BIR (Statistics Poland — GUS), VIES (European Commission). Independent project — not affiliated with any of them. What the service stores and for how long is described in its privacy policy.

Author

Bartosz Kuć · skanfirmy.pl · github.com/bartosz-kuc · linkedin.com/in/bartosz-kuc · cal.com/bartosz-kuc

License

MIT © Bartosz Kuć. This repository documents the hosted server and holds its MCP registry manifest; the server itself runs at https://skanfirmy.pl/mcp.

PopNx fragen