skanfirmy.pl — MCP-сервер

Бесплатный не сохраняющий состояние MCP-сервер (Model Context Protocol), который позволяет AI-агентам проверять польские компании и валидировать номера НДС ЕС напрямую в официальных государственных реестрах — без ключа, без регистрации, без ограничений, кроме тех, что установлены самими реестрами.

• Эндпоинт: https://skanfirmy.pl/mcp (JSON-RPC 2.0 over Streamable HTTP)

• 9 инструментов, объединяющих реестры VAT (Minister Financ), KRS (Minister Justice), REGON (Statistics Poland / GUS) и VIES (European Commission)РЕ.

• также доступно как обычный REST-API для краулеров/агентов, которые не умеют работать с MCP.

Автор — Bartosz Kuć — тот же человек, который создал skanfirmy.pl и каталог польских и европейских публичных API otwarteAPI.pl.

Инструменты

Related MCP server: ksef-mcp

Подключение

Любой MCP-клиент, поддерживающий remote (Streamable HTTP) серверы, — направьте его на:

https://skanfirmy.pl/mcp

Claude Desktop / stdio-only клиенты — подключайтесь через 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"}}}'

Обычный REST (без MCP)

Для агентов/краулеров, которым нужен just a URL:

• GET https://skanfirmy.pl/nip/{nip} — НДС + KRS

• GET https://skanfirmy.pl/nips/{в х} — массовая проверка (≤30)

• GET https://skanfirmy.pl/regon/{nip} — данные реестра REGON

• GET https://skanfirmy.pl/vies/{country}/{number} — EU VIES (НДС)

Чтобы получить JSON, добавьте ?format=json. Полная документация: skanfirmy.pl/llms.txt.

Claude Agent Skill

Предпочитаете готовый Agents Skill? В skill/ находится verify-polish-company — по one SKILL.md, оп know when and how to call the odpowed endpoints above (no key, no extra programs — just regular HTTP):

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

Подробнее см. в skill/README.md.

Источники данных

Реестр НДС / Biała Lista (Министерство финансов), KRS (Министерство юстиции), REGON / BIR (Statistics Poland — GUS) и VIES (European Commission). Это независимый проект — он не связан ни с одним из этих ведомств. Ничего не хранится; ответы временно кешируются 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.