Skan Firmy MCP Server

by bibi-bambi Your server? Claim it

answering

Skan Firmy is answering right now. Last checked 5 min ago. It exposes 14 tools.

Weryfikacja polskich firm po NIP/KRS i unijnego VAT (VIES) z oficjalnych rejestrów UE.

The linked repository no longer exists on GitHub — it was deleted or made private.

Uptime history 47 days of history

47 days agonow

100.0%

Uptime 24h

92 of 92 checks

Tools

read from the server

138 ms

Response time

average over 24h

open, no key

Access

streamable-http

What changed 38

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 20 August 2026. No other catalogue keeps this.

18 Sep a tool changed version

15 Sep a tool changed version

26 Aug a tool description was rewritten list_observations

25 Aug 2 tool descriptions were rewritten changes_since, observe_nip

23 Aug 14 tool descriptions were rewritten changes_since, generuj_mikrorachunek, list_observations and 11 more

23 Aug 14 tools changed the parameters they ask for changes_since, generuj_mikrorachunek, list_observations and 11 more

20 Aug 5 tools appeared changes_since, list_observations, observe_nip and 2 more

This one has been quiet for a while

Quiet is not dead — but it is worth knowing when it wakes up, or when someone else takes it over. We watch the repository and tell you either way.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 5 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

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

~/Library/Application Support/Claude/claude_desktop_config.json

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

~/.codex/config.toml

[mcp_servers.skanfirmy]
url = "https://skanfirmy.pl/mcp"

.cursor/mcp.json

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

.vscode/mcp.json

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

Available tools 14

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

sprawdz

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 and address of each entity. For verifying a portfolio of counterparties. Ministry limits: max 30 NIPs per call, about 500 bulk queries/day per IP. Does not fetch full KRS data (use sprawdz_nip for individual entities).

sprawdz_nip

Check VAT status (VAT White List / Biała Lista) and KRS data for a Polish company by NIP.

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.

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), full address (voivodeship, county, municipality). Covers ALL entities, including sole proprietors that are not in the KRS.

sprawdz_vies

Validate a counterparty's EU VAT number in the VIES system (European Commission).

szukaj

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

szukaj_pkd

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

changes

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. A polling channel for agents. Requires a skanfirmy API key.

generuj

generuj_mikrorachunek

Generate the individual tax micro-account (for PIT/CIT/VAT payments) from a NIP or PESEL.

oblicz

oblicz_odsetki

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

observations

list_observations

Return the list of NIPs you monitor, with their current VAT status and last-checked date. 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.

observe

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. Requires a skanfirmy API key (Authorization: Bearer, or the api_key argument). Free plan: up to 10 NIPs.

unobserve

unobserve_nip

Remove a NIP from monitoring. Requires a skanfirmy API key.

webhook

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

Endpoints

URL	Transport	State	Latency	Checked
https://skanfirmy.pl/mcp	streamable-http	answering	282 ms	5 min ago

Alternatives to Skan Firmy

same job, measured the same way

skanfirmy.pl

by bartosz-kuc

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

14 tools answering

Nipregon

by nipregon

Polish company registry: 4.4M firms, KRS/REGON data, VAT white list checks, financial statements

7 tools answering

REGON (Polish business register)

by smartmobilehouse

Look up Polish businesses in the GUS REGON register (BIR1) by NIP, REGON, or KRS.

87 installs/wk local only

Skan Firmy — questions

Answers built from our own checks of this server.

What can Skan Firmy do?

It exposes 14 tools, read directly from the server on our last check. Among them: changes_since, generuj_mikrorachunek, list_observations, oblicz_odsetki, observe_nip, set_webhook and 8 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

What is Skan Firmy mostly used for?

Its tools cluster around sprawdz and szukaj. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.

Is Skan Firmy working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 92 of 92 checks got a reply (100.0%), average response time 138 ms. The bar chart above shows every period we have measured.

Is Skan Firmy still maintained?

The linked repository no longer exists on GitHub — it was deleted or made private. We show this because it changes what you can expect: an unmaintained server may keep answering for months and then stop without warning.

How do I connect Skan Firmy?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Skan Firmy need an API key?

No. Skan Firmy completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 14 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Skan Firmy?

It answers our handshake in 138 ms on average, which is faster than 79% of all working MCP servers we measure. That puts it in the quick quarter of the ecosystem. The comparison comes from our own checks across the whole registry, every 15 minutes.