MCP.Market

skanfirmy.pl MCP server

online · 100% uptime
by bartosz-kuc·io.github.bartosz-kuc/skanfirmy·v1.4.0
No reviews yet

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

A91/100grade A
Write a reviewRun it
What users say
No reviews yet
Be the first
Safety scan
A91/100

full report

Adoption
New

0 stars

Reviews

Write one

Nobody has reviewed skanfirmy.pl yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

skanfirmy.pl tools (14)

write = sends, deletes, buys or posts
  • changes_sinceFree

    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 persons (entities without a KRS number; natural_person: true) only status_vat, account_added and account_removed are returned, account numbers are masked (check digits + last 4, e.g. 61…2874) and name is null (GDPR); check a specific account with sprawdz_rachunek. A polling channel for agents. Requires a skanfirmy API key.

  • generuj_mikrorachunekFree

    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/mikrorachunek, which computes it in the browser).

  • list_observationsFree

    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_active (boolean) and status_vat_code (active/exempt/not_registered). Requires a skanfirmy API key.

  • oblicz_odsetkiFree

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

  • observe_nipFree

    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 the VAT status and masked bank accounts are monitored (GDPR): no name, address or REGON changes. Requires a skanfirmy API key (Authorization: Bearer, or the api_key argument). Free plan: up to 10 NIPs.

  • set_webhookFree

    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 skanfirmy API key. Public https addresses only (port 443).

  • sprawdz_lista_nipFree

    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 REGON number or registration date is returned (GDPR) — check a specific account with sprawdz_rachunek. For verifying a portfolio of counterparties. Ministry limits: max 30 NIPs per call; the Ministry's daily query limit is shared by the whole service — when it is exhausted, the tool returns an error. Does not fetch full KRS data (use sprawdz_nip for individual entities).

  • sprawdz_nipFree

    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 say whether it is a business or a home address), and bank accounts to their count — check a specific account with sprawdz_rachunek; no REGON number, registration date or PKD codes are returned for them (the ceidg field is always null). The privacy field lists what was hidden.

  • sprawdz_rachunekFree

    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.

  • sprawdz_regonFree

    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 persons (GUS type F / LF) and civil partnerships (s.c.) only the NIP, name, entity type code (typ), form (forma: 'osoba fizyczna' / 'jednostka lokalna osoby fizycznej' / 'spółka cywilna'), town and activity status (status: active / ended) are returned — no REGON number, address, administrative units or dates (GDPR); the full entry is in the GUS REGON search (privacy.officialSource).

  • sprawdz_viesFree

    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).

  • szukaj_katalog_apiFree

    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).

  • szukaj_pkdFree

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

  • unobserve_nipFree

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

Public scan report

scanner v0.1.10 · 2026-10-02 · same rubric, same numbers if you re-run it

no findings
  • –Code scanremote-only server, no package to scann/a
  • Live reliabilityremote reachable in 886ms20/20
  • Tool poisoning14 tool descriptions checked15/15
  • Auth qualityopen endpoint, read-only tools10/15
  • Maintenancelast push 4 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 91/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How skanfirmy.pl compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
91/100
higher than 85% of 48,255 servers
Tools
14
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Uptime
100%
of our recent checks; the typical remote server answers 100%
Response time
91 ms
faster than 86% of 30,031 servers

What its tools let an agent do: 13 read · 1 change

Release history: 3 versions in the registry since 2026-09-15, latest 2026-10-02, typically one every 14 days.

Install skanfirmy.pl in Claude Code, Cursor or VS Code

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

What the publisher says

From the skanfirmy.pl repository's README, as published. We do not edit it. Read it on GitHub

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, no registration, no limits beyond the source registries' own.

Justice), REGON (Statistics Poland / GUS) and VIES (European Commission).

  • Endpoint: https://skanfirmy.pl/mcp (JSON-RPC 2.0 over Streamable HTTP)
  • 9 tools combining the VAT Register (Ministry of Finance), KRS (Ministry of
  • Also usable as plain REST for crawlers/agents that can't speak MCP.

Made by Bartosz Kuć — the same person behind skanfirmy.pl and the otwarteAPI.pl catalog of Polish & EU public APIs.

Tools

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)

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

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. Nothing is persisted; responses are transiently CDN-cached (max 24h), POST /mcp isn't cached at all.

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.

Nothing above is checked by us. What we check is on the safety report.

Grade history

  • 2026-10-02restoreB → Ascore 91

skanfirmy.pl: common questions

Is skanfirmy.pl MCP server safe?
Yes, by our scan: it is graded A (91/100). Read the skanfirmy.pl safety report
How do I install skanfirmy.pl?
It runs remotely at skanfirmy.pl. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
Does skanfirmy.pl need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is skanfirmy.pl maintained?
The last commit was 37 days ago (2026-09-28). The latest release is v1.4.0.
Is skanfirmy.pl up?
100% of our last 28 checks got an answer. We check remote servers about four times a day.
How does skanfirmy.pl compare with other MCP servers?
safety score 91/100 (higher than 85% of 48,255 servers); tools 14 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.