skanfirmy.pl

io.github.bartosz-kuc由 GitHub 账号 bartosz-kuc 发布v1.4.0更新于 Oct 30, 2026

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

已验证Streamable HTTP可网页运行网页搜索与抓取金融商业与电商

概览

AI 生成的概览

远程 MCP 服务器,可按 NIP、KRS、REGON 核验波兰企业、验证欧盟增值税号,并可选监控登记信息变更。

可以做什么
  • 按 NIP 查询波兰企业的增值税状态与 KRS 数据,或一次批量查询最多 30 个 NIP
  • 获取 REGON 登记数据,并通过 VIES 验证欧盟增值税号
  • 核查某银行账户是否出现在该 NIP 的增值税白名单中,并根据 NIP 生成个人税务微账户
  • 检索 PKD 2025 经营活动代码,计算法定或 B2B 逾期付款利息
  • 检索波兰与欧盟公共 API 目录
  • 监控 NIP 的增值税、银行账户或登记信息变更,列出监控项、获取某日期以来的变更,并设置带签名的 webhook
适用场景
适合需要核查波兰合作方增值税或登记状态、付款前确认收款账户、验证欧盟增值税号,或长期跟踪合作方变更的场景。
运行要求
远程 Streamable HTTP 端点;九个查询与计算工具无需密钥或注册。五个监控工具需要确认注册后获得的 skanfirmy API 密钥。仅支持 stdio 的客户端需借助 mcp-remote 之类的桥接。按 IP 有速率限制。
安装前请注意
查询会把 NIP 和增值税号发送给第三方服务,由其访问政府登记库;自然人数据依 GDPR 被最小化,部分号码被限制展示。监控工具会写入数据:observe_nip 和 unobserve_nip 新增或删除监控,set_webhook 只返回一次签名密钥并向你提供的 URL 推送变更通知。API 密钥属于需妥善保管的凭据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 skanfirmy.pl,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.bartosz-kuc%2Fskanfirmy/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

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ć — 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:

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

Raw JSON-RPC (no MCP client needed):

bash
# list toolscurl -s https://skanfirmy.pl/mcp \  -H 'Content-Type: application/json' \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# check a company by NIPcurl -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):

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

来源:README.md,提交 a9d0ebb

工具

14

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. White List data for entities with a KRS number may come from a same-day cache: then mfCached is true and bl.mfRequestDateTime is the time of the original Ministry query.

输入参数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 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). If every NIP in the list is an entity with a KRS number already checked today, the result comes from a same-day cache without a Ministry query: mfCached is true and mfRequestDateTime is the time of the oldest of those queries.

输入参数nipy必填

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

输入参数nip必填

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

输入参数vatNumber必填countryCode必填

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.

输入参数nip必填numerRachunku必填

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

输入参数identyfikator必填

szukaj_pkd

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

输入参数zapytanie必填

oblicz_odsetki

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

输入参数typ必填kwota必填dataDo必填dataOd必填

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

输入参数tematzasiegzapytanie

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.

输入参数nip必填api_key

unobserve_nip

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

输入参数nip必填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_active (boolean) and status_vat_code (active/exempt/not_registered). Requires a skanfirmy API key.

输入参数api_key

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.

输入参数sinceapi_key

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

输入参数urlapi_key

版本历史

3
  1. v1.4.0最新Oct 2, 2026
  2. v1.1.2Sep 18, 2026
  3. v1.1.1Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分