skanfirmy.pl — MCP-Server

Ein kostenloser, zustandsloser MCP-Server (Model Context Protocol), der KI-Agenten direkt polnische Unternehmen verifizieren und EU-USt-IdNr. validieren lässt – aus offiziellen Registern, ganz ohne Schlüssel, Anmeldung oder Limits, außer denen der Quellregister selbst.

• Endpunkt: https://skanfirmy.pl/mcp (JSON-RPC 2.0 über Streamable HTTP)

• 9 Werkzeuge, die das USt-Register (Ministry of Finance), KRS (Ministry of Justice), REGON (Statistics Poland / GUS) und VIES (European Commission) kombinieren.

• Ebenso als reines REST nutzbar für Crawler/Agenten, die nicht MCP sprechen.

Erstellt von Bartosz Kuć – dieselbe Person, die hinter skanfirmy.pl und dem otwarteAPI.pl Katalog polnischer & EU-öffentlicher APIs steht.

Werkzeuge

Related MCP server: ksef-mcp

Verbinden

Echten MCP-Clients, die Remote-Server (Streamable HTTP) unterstützen – zeigen Sie darauf:

https://skanfirmy.pl/mcp

Claude Desktop / nur stdio – mit mcp-remote überbrücken:

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

Reines JSON-RPC (kein MCP-Client nötig):

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

Reines REST (ohne MCP)

Für Agenten/Crawler, die nur eine URL brauchen:

• GET https://skanfirmy.pl/nip/{nip} – USt + KRS

• GET https://skanfirmy.pl/nips/{komma,getrennt,nips} – Massenabruf (≤30)

• GET https://skanfirmy.pl/regon/{nip} – REGON-Registerdaten

• GET https://skanfirmy.pl/vies/{land}/{nummer} – EU-USt-IdNr. (VIES)

Fügen Sie ?format=json für JSON hinzu. Volle Doku: skanfirmy.pl/llms.txt.

Claude Agent Skill

Bevorzugen Sie eine sofort einsetzbare Agent Skill? skill/ enthält verify-polish-company – eine einzelne SKILL.md, die Claude Code, die Claude-Apps oder dem Agent SDK beibringt, wann und wie die obigen Endpunkte aufgerufen werden (ohne Schlüssel, nichts zu tun außer normalem HTTP):

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

Details in skill/README.md.

Datenquellen

USt-Register / Scheidung (Ministry of Finance), KRS (Ministry of Justice), REGON / BIR (Statistics Poland – GUS), VIES (European Commission). Unabhängiges Projekt – mit keiner der Einrichtungen verbunden. Es wird nichts gespeichert; Antworten bleiben nur kurz im CDN-Cache (max. 24 Stunden), POST /endpoint wird überhaupt nicht gecacht.

Autor

Bartosz Część · skanfirmy.pl · github.com/bartosz-kuc · linkedin.com/in/bartosz-kuc · cal.com/bartosz-kuc

Lizenz

MIT ©Author: Bartosz Kuć. Dieses Repository dokumentiert den gehosteten Server und enthält sein MCP-Registrierungs-Manifest; der Server selbst wird unter https://skanfirmy.pl/mcp gehostet.