skanfirmy

Verify Polish companies by NIP, KRS or REGON and validate EU VAT numbers via VIES, straight from official government registers (Ministry of Finance VAT white…

CommunityOnlineNo sign-inGlobalFreeRead-only

What it can do

  • Sprawdz Nip: Check VAT status (VAT White List / Biała Lista) and KRS data for a Polish company by NIP.
  • 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 counte
  • 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, mun

What data it sees

Do you need an account

No: the server works without sign-in

Verify Polish companies by NIP, KRS or REGON and validate EU VAT numbers via VIES, straight from official government registers (Ministry of Finance VAT white list, KRS, Statistics Poland / GUS). Also checks bank accounts against the white list, generates the tax micro-account, searches PKD activity codes and computes statutory interest. Hosted, keyless, no signup. 14 tools.

How to connect

How to connect skanfirmy to Claude

The server address to paste into Claude settings:

https://skanfirmy--firma.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect skanfirmy to ChatGPT

The server address to paste into ChatGPT settings:

https://skanfirmy--firma.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect skanfirmy to Cursor

The server address to paste into Cursor settings:

https://skanfirmy--firma.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (14)

Raw names from tools/list. Only developers need these.

sprawdz_nipCheck VAT status (VAT White List / Biała Lista) and KRS data for a Polish company by NIP.
sprawdz_lista_nipBulk-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_regonLook 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_viesValidate a counterparty's EU VAT number in the VIES system (European Commission).
sprawdz_rachunekCheck 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_mikrorachunekGenerate the individual tax micro-account (for PIT/CIT/VAT payments) from a NIP or PESEL.
szukaj_pkdSearch PKD 2025 business activity codes by activity name or code number.
oblicz_odsetkiCalculate statutory or commercial (B2B) late-payment interest, broken down by NBP reference-rate periods.
szukaj_katalog_apiSearch 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_nipAdd a NIP to monitoring. You get notified (via changes_since or email) when its VAT status or bank account on the Ministry of Finance White List changes. Requires a skanfirmy API key (Authorization: Bearer, or the api_key argument). Free plan: up to 10 NIPs.
unobserve_nipRemove a NIP from monitoring. Requires a skanfirmy API key.
list_observationsReturn the list of NIPs you monitor, with their current VAT status and last-checked date. Requires a skanfirmy API key.
changes_sinceReturn changes (VAT status or bank accounts) detected since a given date for the NIPs you monitor. A polling channel for agents. Requires a skanfirmy API key.
set_webhookSet (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).