skanfirmy.pl — servidor MCP

Un servidor MCP (Model Context Protocol) gratuito y sin estado que permite a los agentes de IA verificar empresas polacas y validar números de IVA de la UE directamente en los registros públicos gubernamentales — sin clave, sin registro, sin límites, salvo los de los propios registros de origen.

• Endpoint: https://skanfirmy.pl/mcp (JSON-RPC 2.0 sobre Streamable HTTP)

• 9 herramientas que combinan el Registro de IVA (Ministerio de Hacienda), el KRS (Ministerio de Justicia), el REGON (Estadística de Polonia / GUS) y el VIES (Comisión Europea).

• También se puede usar como REST puro para rastreadores/agentes que no puedan usar MCP.

Creado por Bartosz Kuć — la misma persona detrás de skanfirmy.pl y del catálogo otwarteAPI.pl de APIs públicas de Polonia y la UE.

Herramientas

Related MCP server: ksef-mcp

Conectar

Cualquier cliente MCP que admita servidores remotos (Streamable HTTP) — apúntalo a:

https://skanfirmy.pl/mcp

Clientes de Claude Desktop / solo stdio — crea un puente con mcp-remote:

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

JSON-RPC puro (no se necesita ningún cliente 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 puro (sin MCP)

Para agentes/rastreadores que solo quieran una URL:

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

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

• GET https://skanfirmy.pl/regon/{nip} — datos del registro REGON

• GET https://skanfirmy.pl/vies/{country}/{number} — IVA de la UE (VIES)

Añade ?format=json para obtener JSON. Documentación completa: skanfirmy.pl/llms.txt.

Claude Agent Skill

¿Te sirve una Agent Skill plug-and-play? En skill/ tienes verify-polish-company — un único SKILL.md que enseña a Claude Code, a las aplicaciones Claude o al Agent SDK cuándo y cómo llamar a los endpoints anteriores (sin clave, nada que ejecutar aparte de HTTP normal):

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

Consulta skill/README.md para más detalles.

Fuentes de datos

Registro de IVA / Biała Lista (Ministerio de Hacienda), KRS (Ministerio de Justicia), REGON / BIR (Estadística de Enseñanza — GUS), VIES (Comisión Europea). Proyecto independiente: no está afiliado a ninguno de ellos. No se persiste nada; las respuestas se cachean de forma transitoria en la CDN (máx. 24 horas), y POST /mcp no se cachea en absoluto.

Automatizado

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

Licencia

MIT © Bartosz Kuć. Este repositorio documenta el servidor alojado y mantiene el manifiesto de su registro MCP; el propio servidor se ejecuta en https://skanfirmy.pl/mcp.