MCP Radar
Servidor MCP

skanfirmy.pl

io.github.bartosz-kuc/skanfirmy
Negocio y operaciones Legal y cumplimiento Público y accesible MCP 2026-07-28

Qué hace este MCP

Verifies Polish companies, VAT registrations, bank accounts, registry data, EU VAT numbers, tax micro-accounts, and payment interest, with optional NIP monitoring and webhooks.

Capacidades

Herramientas

14 herramientas
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 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.
Esquema de entrada 
{'type': 'object', 'required': [], 'properties': {'since': {'type': 'string', 'description': 'ISO date/timestamp (e.g. 2026-08-01). Returns changes since that date. Defaults to the beginning.'}, 'api_key': {'type': 'string', 'description': 'skanfirmy API key (optional, if not in the header).'}}}
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/mikrorachunek, which computes it in the browser).
Esquema de entrada 
{'type': 'object', 'required': ['identyfikator'], 'properties': {'identyfikator': {'type': 'string', 'description': 'NIP (10 digits). PESEL is not accepted by the server.'}}}
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_active (boolean) and status_vat_code (active/exempt/not_registered). Requires a skanfirmy API key.
Esquema de entrada 
{'type': 'object', 'required': [], 'properties': {'api_key': {'type': 'string', 'description': 'skanfirmy API key (optional, if not in the header).'}}}
oblicz_odsetki
Calculate statutory or commercial (B2B) late-payment interest, broken down by NBP reference-rate periods.
Esquema de entrada 
{'type': 'object', 'required': ['kwota', 'dataOd', 'dataDo', 'typ'], 'properties': {'typ': {'enum': ['kc', 'h10', 'h8'], 'type': 'string', 'description': 'kc = statutory late-payment interest (Civil Code art. 481, NBP reference rate + 5.5 pp); h10 = commercial B2B transactions, non-public debtor (NBP reference rate on 1 Jan / 1 Jul + 10 pp); h8 = commercial transactions, public healthcare debtor (NBP reference rate on 1 Jan / 1 Jul + 8 pp).'}, 'kwota': {'type': 'number', 'description': 'Overdue amount in PLN.'}, 'dataDo': {'type': 'string', 'description': 'Actual payment date, format YYYY-MM-DD.'}, 'dataOd': {'type': 'string', 'description': 'Payment due date, format YYYY-MM-DD.'}}}
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 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.
Esquema de entrada 
{'type': 'object', 'required': ['nip'], 'properties': {'nip': {'type': 'string', 'description': '10-digit NIP to monitor.'}, 'api_key': {'type': 'string', 'description': 'skanfirmy API key (if not provided in the Authorization header).'}}}
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).
Esquema de entrada 
{'type': 'object', 'required': [], 'properties': {'url': {'type': 'string', 'description': 'Public https URL of the receiver (empty = disable the webhook).'}, 'api_key': {'type': 'string', 'description': 'skanfirmy API key (optional, if not in the header).'}}}
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 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).
Esquema de entrada 
{'type': 'object', 'required': ['nipy'], 'properties': {'nipy': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 30, 'minItems': 1, 'description': 'List of NIPs (1 to 30). Each 10-digit with a valid checksum. Invalid NIPs are returned separately in the invalidInput field.'}}}
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 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.
Esquema de entrada 
{'type': 'object', 'required': ['nip'], 'properties': {'nip': {'type': 'string', 'description': '10-digit Polish NIP (tax ID).'}}}
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.
Esquema de entrada 
{'type': 'object', 'required': ['nip', 'numerRachunku'], 'properties': {'nip': {'type': 'string', 'description': '10-digit NIP of the counterparty.'}, 'numerRachunku': {'type': 'string', 'description': '26-digit bank account number (NRB), without the PL prefix.'}}}
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 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).
Esquema de entrada 
{'type': 'object', 'required': ['nip'], 'properties': {'nip': {'type': 'string', 'description': '10-digit Polish NIP (tax ID).'}}}
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).
Esquema de entrada 
{'type': 'object', 'required': ['countryCode', 'vatNumber'], 'properties': {'vatNumber': {'type': 'string', 'description': 'VAT number without the country prefix.'}, 'countryCode': {'enum': ['AT', 'BE', 'BG', 'CY', 'CZ', 'DE', 'DK', 'EE', 'EL', 'ES', 'FI', 'FR', 'HR', 'HU', 'IE', 'IT', 'LT', 'LU', 'LV', 'MT', 'NL', 'PL', 'PT', 'RO', 'SE', 'SI', 'SK', 'XI'], 'type': 'string', 'description': 'Two-letter EU country code (e.g. DE, IE, FR).'}}}
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).
Esquema de entrada 
{'type': 'object', 'required': [], 'properties': {'temat': {'type': 'string', 'description': 'Narrow to a specific catalog tag, e.g. "firmy" or "dane-statystyczne". Optional.'}, 'zasieg': {'enum': ['PL', 'EU'], 'type': 'string', 'description': 'Narrow to Polish (PL) or EU APIs. Optional.'}, 'zapytanie': {'type': 'string', 'description': 'Natural-language query, e.g. "euro exchange rate" or "weather data". Optional.'}}}
szukaj_pkd
Search PKD 2025 business activity codes by activity name or code number.
Esquema de entrada 
{'type': 'object', 'required': ['zapytanie'], 'properties': {'zapytanie': {'type': 'string', 'description': 'Activity name (e.g. "software") or PKD code (e.g. "62.01").'}}}
unobserve_nip
Stop watching a NIP (it stays on your list of ended watches until you unsubscribe). Requires a skanfirmy API key.
Esquema de entrada 
{'type': 'object', 'required': ['nip'], 'properties': {'nip': {'type': 'string', 'description': '10-digit NIP to stop watching.'}, 'api_key': {'type': 'string', 'description': 'skanfirmy API key (optional, if not in the header).'}}}
Historial

Cambios recientes en herramientas

Modificado
changes_since
29 de September de 2026 a las 02:51
Modificado
list_observations
29 de September de 2026 a las 02:51
Modificado
unobserve_nip
29 de September de 2026 a las 02:51
Modificado
observe_nip
29 de September de 2026 a las 02:51
Modificado
sprawdz_regon
29 de September de 2026 a las 02:51
Modificado
sprawdz_lista_nip
29 de September de 2026 a las 02:51
Modificado
sprawdz_nip
29 de September de 2026 a las 02:51
Modificado
generuj_mikrorachunek
27 de September de 2026 a las 02:43
Modificado
sprawdz_vies
27 de September de 2026 a las 02:43
Modificado
sprawdz_regon
27 de September de 2026 a las 02:43
Modificado
sprawdz_lista_nip
27 de September de 2026 a las 02:43
Modificado
sprawdz_nip
27 de September de 2026 a las 02:43
Añadido
set_webhook
17 de September de 2026 a las 12:40
Añadido
changes_since
17 de September de 2026 a las 12:40
Añadido
list_observations
17 de September de 2026 a las 12:40
Añadido
unobserve_nip
17 de September de 2026 a las 12:40
Añadido
observe_nip
17 de September de 2026 a las 12:40
Añadido
szukaj_katalog_api
17 de September de 2026 a las 12:40
Añadido
oblicz_odsetki
17 de September de 2026 a las 12:40
Añadido
szukaj_pkd
17 de September de 2026 a las 12:40
Añadido
generuj_mikrorachunek
17 de September de 2026 a las 12:40
Añadido
sprawdz_rachunek
17 de September de 2026 a las 12:40
Añadido
sprawdz_vies
17 de September de 2026 a las 12:40
Añadido
sprawdz_regon
17 de September de 2026 a las 12:40
Añadido
sprawdz_lista_nip
17 de September de 2026 a las 12:40
Añadido
sprawdz_nip
17 de September de 2026 a las 12:40
Descubrir

Servidores MCP similares

BeeL

es.beel/mcp

Provides Spanish company administration and VeriFactu-compliant invoicing, including customers, products, invoice issuance, corre…

corply

io.github.corply-dev/corply

Supports company formation and corporate administration including incorporation documents, signatures, cap tables, corporate acti…

FalaZuki Finance BR

com.falazuki/finance-br

Provides Brazil-focused financial calculations and rules for investments, credit, taxes, payroll, labor costs, debt, budgeting, a…

XBOSS

kr.xdata/xdata-mcp

Accesses Korean tax, social insurance, payroll, cash receipt, e-tax invoice, and certificate filing services.

Sirenic

eu.sirenic/sirenic

Provides European company registry, financial, procurement, sanctions, regulatory, insolvency, ownership, and ongoing due-diligen…

Xearno Tools

tools.xearno/calculators

Provides financial, tax, employment-benefit, lending, pricing, and business calculators using jurisdiction-specific rules and cur…

schedule-iii

com.datavrn/schedule-iii

Transforms Indian company trial balances into controlled Schedule III financial statement workbooks with account mappings, disclo…

editalmd

com.editalmd/editalmd

Searches Brazilian public procurement opportunities and documents, tracks deadlines and alerts, and supports tender document acce…