{
  "markdown": "# skanfirmy.pl — MCP server\n\nA free, stateless **MCP (Model Context Protocol) server** that lets AI agents\nverify **Polish companies** and validate EU VAT numbers directly from official\ngovernment registers — **no key, no registration, no limits** beyond the source\nregistries' own.\n\n- **Endpoint:** `https://skanfirmy.pl/mcp` (JSON-RPC 2.0 over Streamable HTTP)\n- **9 tools** combining the VAT Register (Ministry of Finance), KRS (Ministry of\n  Justice), REGON (Statistics Poland / GUS) and VIES (European Commission).\n- Also usable as plain REST for crawlers/agents that can't speak MCP.\n\nMade by **[Bartosz Kuć](https://skanfirmy.pl)** — the same person behind\n[skanfirmy.pl](https://skanfirmy.pl) and the\n[otwarteAPI.pl](https://otwarteapi.pl) catalog of Polish & EU public APIs.\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `sprawdz_nip` | VAT status (Biała Lista) + KRS data for a company by NIP |\n| `sprawdz_lista_nip` | Bulk lookup of up to 30 NIPs in one call (MF VAT Register) |\n| `sprawdz_regon` | REGON registry data (GUS) by NIP — incl. sole traders not in KRS |\n| `sprawdz_vies` | Validate an EU VAT number via VIES (European Commission) |\n| `sprawdz_rachunek` | Is a bank account on the VAT White List for a given NIP |\n| `generuj_mikrorachunek` | Individual tax micro-account (PIT/CIT/VAT) from NIP/PESEL |\n| `szukaj_pkd` | Search the PKD 2025 business-activity classification |\n| `oblicz_odsetki` | Statutory / commercial (B2B) late-payment interest calculator |\n| `szukaj_katalog_api` | Search [otwarteAPI.pl](https://otwarteapi.pl) — a catalog of other public PL/EU APIs |\n\n## Connect\n\n**Any MCP client that supports remote (Streamable HTTP) servers** — point it at:\n\n```\nhttps://skanfirmy.pl/mcp\n```\n\n**Claude Desktop / stdio-only clients** — bridge with `mcp-remote`:\n\n```json\n{\n  \"mcpServers\": {\n    \"skanfirmy\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://skanfirmy.pl/mcp\"]\n    }\n  }\n}\n```\n\n**Raw JSON-RPC** (no MCP client needed):\n\n```bash\n# list tools\ncurl -s https://skanfirmy.pl/mcp \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}'\n\n# check a company by NIP\ncurl -s https://skanfirmy.pl/mcp \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"sprawdz_nip\",\"arguments\":{\"nip\":\"5261040828\"}}}'\n```\n\n## Plain REST (no MCP)\n\nFor agents/crawlers that just want a URL:\n\n- `GET https://skanfirmy.pl/nip/{nip}` — VAT + KRS\n- `GET https://skanfirmy.pl/nips/{comma,separated,nips}` — bulk (≤30)\n- `GET https://skanfirmy.pl/regon/{nip}` — REGON registry data\n- `GET https://skanfirmy.pl/vies/{country}/{number}` — EU VAT (VIES)\n\nAdd `?format=json` for JSON. Full docs: [skanfirmy.pl/llms.txt](https://skanfirmy.pl/llms.txt).\n\n## Claude Agent Skill\n\nPrefer a drop-in [Agent Skill](https://docs.claude.com/en/docs/agents-and-tools/agent-skills)?\n[`skill/`](skill/) holds **`verify-polish-company`** — a single `SKILL.md` that\nteaches Claude Code, the Claude apps or the Agent SDK when and how to call the\nendpoints above (no key, nothing to run beyond ordinary HTTP):\n\n```bash\ncp -R skill ~/.claude/skills/verify-polish-company\n```\n\nSee [`skill/README.md`](skill/README.md) for details.\n\n## Data sources\n\nVAT Register / Biała Lista (Ministry of Finance), KRS (Ministry of Justice),\nREGON / BIR (Statistics Poland — GUS), VIES (European Commission). Independent\nproject — not affiliated with any of them. Nothing is persisted; responses are\ntransiently CDN-cached (max 24h), `POST /mcp` isn't cached at all.\n\n## Author\n\n**Bartosz Kuć**\n· [skanfirmy.pl](https://skanfirmy.pl)\n· [github.com/bartosz-kuc](https://github.com/bartosz-kuc)\n· [linkedin.com/in/bartosz-kuc](https://pl.linkedin.com/in/bartosz-kuc)\n· [cal.com/bartosz-kuc](https://cal.com/bartosz-kuc)\n\n## License\n\nMIT © [Bartosz Kuć](https://skanfirmy.pl). This repository documents the hosted\nserver and holds its MCP registry manifest; the server itself runs at\n`https://skanfirmy.pl/mcp`.\n",
  "bytes": 3999,
  "sha": "7be6083edf9475e2e2ce3db46f803edf9c4df5295903e1b95f01011120b386de",
  "repo_slug": "bartosz-kuc/skanfirmy-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_bartosz_kuc_skanfirmy_ab0c8c00/readme"
}