Skip to main content
Glama

skanfirmy.pl — MCP 服务器

一个免费、无状态的 MCP(Model Context Protocol)服务器,让 AI 代理可以直接通过官方政府登记处验证波兰企业,并校验欧盟 VAT 号码——无需密钥、无需注册、没有任何限制,除源自注册表自身的限制外。

  • 端点: https://skanfirmy.pl/skim(基于 Streamable HTTP 的 JSON-RPC 2.0)

  • 9 个工具,整合了 VAT 注册表(财政部)、KRS(司法部)、REGON(波兰统计局 / GUS)和 VIES(欧盟委员会)。

  • 对于无法使用 MCP 的爬虫/代理,也可作为普通 REST 接口使用。

由 Bartosz Kuć 制作——他也是 skanfirmy.pl 与 otwarteAPI.pl(波兰和欧盟公共 API 目录)的创建者。

工具

工具

功能说明

sprawdz_nip

按 NIP 查询增值税状态(Biała Lista)及 KRS 数据

sprawdz_lista_nip

一次调用批量查询最多 30 个 NIP(财政部 VAT 注册)

sprawdz_regon

按 NIP 查询 REGON 注册数据(GUS)——包括不在 KRS 中的个体经营者

sprawdz_vies

通过 VIES(欧盟委员会)校验欧盟 VAT 号码

sprawdz_rachunek

检查查询指定 NIP 的银行账户是否在 VAT 白名单上

generuj_mikrorachunek

根据 NIP/PESEL 生成个人纳税微账户(PIT/CIT/VAT)

szukaj_pkd

搜索 PKD 2025 商业活动分类

oblicz_odsetki

法定 / 商业(B2B)逾期付款利息计算器

szukaj_katalog_api

搜索 otwarteAPI.pl — 一个收录其他波兰/欧盟公共 API 的目录

Related MCP server: Polish Business Intelligence MCP

连接

任何支持远程(Streamable HTTP)服务器的 MCP 客户端 —— 将其指向:

https://skanfirmy.pl/mcp

Claude Desktop / 仅支持 stdio 的客户端 —— 使用 mcp-remote 桥接:

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

原始 JSON-RPC(无需 MCP 客户端):

# 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"}}}'

无需 MCP 的纯 REST 接口

对于只需要 URL 的代理/爬虫:

  • GET https://skanfirmy.pl/nip/{nip} — VAT + KRS

  • GET https://skanfirmy.pl/nips/{comma,separated,nips} — 批量(≤30)

  • GET https://skanfirmy.pl/regon/{nip} — REGON 注册数据

  • GET https://skanfirmy.pl/vies/{country}/{number} — 欧盟 VAT(VIES)

如需 JSON,请添加 ?format=json。完整文档:skanfirmy.pl/llms.txt。

Claude Agent Skill

如果你想使用一个可立即部署的 Agent Skill,skill/ 提供了 verify-polish-company —— 一个 SKILL.md 文件,教会 Claude Code、Claude 应用或 Agent SDK 何时以及如何调用上述端点(无需密钥,不需要做任何普通 HTTP 之外的事情):

cp -R skill ~/.claude/skills/verify-polish-company

详见 skill/README.md。

数据来源

VAT 注册表 / Biała Lista(财政部)、KRS(司法部)、REGON / BIR(波兰统计局即 GUS)、VIES(欧洲和中国联盟)。独立项目——与上述任何机构均不相关。该系统不持久化任何数据;请求响应仅通过 CDN 临时缓存(最长 24 小时),但 POST /mcp 完全不缓存。

作者

Bartosz Kuź · skanfirmy.pl · github.com/bartosz-kuc · linkedin.com/in/bartosz-kuc · cal.com/bartosz-kuc

许可证

MIT © Bartosz Kuź。本仓库描述了托管服务器的 MCP 注册清单;服务器本身位于 https://skanfirmy.pl/mcp。

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    Look up Polish companies from any AI assistant: registry data (KRS, REGON, CEIDG), VAT white list checks before payments, and financial statements of 4.4M businesses. Read-only tools backed by official public registers.
    4
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    MCP server that provides AI agents with Polish business data tools: identifier validation (NIP, PESEL, REGON, KRS, IBAN), VAT whitelist checks, EU VIES lookups, and NBP exchange rates.
    5
    9 npm
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Provides clean, typed access to the Polish REGON business register (GUS BIR1), enabling AI assistants to look up companies by NIP, REGON, or KRS and retrieve structured data like name, address, and legal form.
    6
    1
    MIT