{
  "markdown": "![NIPRegon MCP Server](assets/banner-en.png)\n\n# NIPRegon MCP Server\n\nLook up **Polish companies** from any AI assistant: registry data (KRS, REGON,\nCEIDG), VAT white list checks before payments, and financial statements of\n4.4M Polish businesses.\n\nBacked by [NIPRegon.pl](https://nipregon.pl): data sourced exclusively from\nofficial public registers (KRS, REGON, CEIDG, the Ministry of Finance VAT\nwhite list and financial statements filed with the National Court Register).\n\n[![License: MIT](https://img.shields.io/badge/license-MIT-0CCC68)](LICENSE)\n[![Website](https://img.shields.io/badge/website-nipregon.pl-0F172A)](https://nipregon.pl/mcp)\n[![MCP Registry](https://img.shields.io/badge/MCP_registry-pl.nipregon%2Fnipregon-blue)](https://registry.modelcontextprotocol.io/v0/servers?search=nipregon)\n\n[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=nipregon&config=eyJ1cmwiOiJodHRwczovL2FwaS5uaXByZWdvbi5wbC9tY3AifQ==)\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=nipregon&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.nipregon.pl%2Fmcp%22%7D)\n\n## Remote server (recommended)\n\nOne endpoint, zero install:\n\n```\nhttps://api.nipregon.pl/mcp\n```\n\nGeneric config that works in most MCP clients:\n\n```json\n{\n  \"mcpServers\": {\n    \"nipregon\": {\n      \"type\": \"http\",\n      \"url\": \"https://api.nipregon.pl/mcp\"\n    }\n  }\n}\n```\n\n<details>\n<summary><b>Claude Code</b></summary>\n\n```bash\nclaude mcp add --transport http nipregon https://api.nipregon.pl/mcp\n```\n</details>\n\n<details>\n<summary><b>Cursor</b></summary>\n\nUse the install button above, or add to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"nipregon\": { \"url\": \"https://api.nipregon.pl/mcp\" }\n  }\n}\n```\n</details>\n\n<details>\n<summary><b>VS Code</b></summary>\n\nUse the install button above, or add to `mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"nipregon\": { \"type\": \"http\", \"url\": \"https://api.nipregon.pl/mcp\" }\n  }\n}\n```\n</details>\n\n<details>\n<summary><b>Claude Desktop / claude.ai</b></summary>\n\nSettings → Connectors → Add custom connector → paste\n`https://api.nipregon.pl/mcp`.\n\nOr, for any client without native streamable HTTP support:\n\n```json\n{\n  \"mcpServers\": {\n    \"nipregon\": {\n      \"command\": \"npx\",\n      \"args\": [\"mcp-remote\", \"https://api.nipregon.pl/mcp\"]\n    }\n  }\n}\n```\n</details>\n\nTransport: streamable HTTP (JSON-RPC 2.0). Free tier: 100 tool calls/day/IP.\n\n## Try asking your assistant\n\n- \"Check the company with NIP 7791906082 before I sign this contract.\"\n- \"Find the company Eurocash and show its revenue for the last 5 years.\"\n- \"Is the bank account on this invoice really on the VAT white list of the supplier?\"\n\n## Tools\n\n- **search_company** — fuzzy search of Polish companies by name. Returns NIP,\n  KRS, city, status and a profile URL. Inputs: `query` (string, min 3 chars),\n  `limit` (1-10, default 5). Read-only.\n- **get_company** — full registry data of a Polish company by NIP: address,\n  legal form, status, KRS, REGON, PKD activity codes, board members, VAT\n  status. Inputs: `nip` (string, 10 digits). Read-only.\n- **get_financials** — yearly financial statements filed with the National\n  Court Register: revenue, net profit, total assets, equity, liabilities.\n  Inputs: `nip`. Read-only.\n- **check_vat_whitelist** — the company's VAT status in the Ministry of\n  Finance taxpayer register (white list) and, optionally, whether a bank\n  account number is on the company's white list. In Poland, paying more than\n  PLN 15k to an account outside the white list has tax consequences. Inputs:\n  `nip`, optional `account` (26 digits). Read-only.\n\nExample response (shortened):\n\n```json\n{\n  \"nip\": \"7822463563\",\n  \"statements\": [\n    { \"year\": 2024, \"revenue\": 24436276969.00, \"net_profit\": 184561157.00 },\n    { \"year\": 2023, \"revenue\": 21382959713.00, \"net_profit\": 176885896.00 }\n  ],\n  \"source\": \"Sprawozdania finansowe KRS (RDF)\"\n}\n```\n\n## Local stdio bridge (single file, zero dependencies)\n\nFor clients that only support stdio. Requires Node 18+. Download\n[`nipregon-mcp.mjs`](nipregon-mcp.mjs):\n\n```json\n{\n  \"mcpServers\": {\n    \"nipregon\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/nipregon-mcp.mjs\"],\n      \"env\": { \"NIPREGON_API_KEY\": \"(optional, for higher limits)\" }\n    }\n  }\n}\n```\n\n## REST API\n\nThe same data over plain REST — see the [API docs](https://nipregon.pl/api)\n(Polish). Self-service API keys with Free/Start/Pro/Scale plans, an\ninteractive playground and Stripe billing.\n\n## Troubleshooting\n\n- **Client doesn't support remote MCP servers** — use the `mcp-remote` bridge\n  (see Claude Desktop above) or the local stdio file.\n- **HTTP 429 / limit message** — the free daily limit (100 tool calls/IP) was\n  reached; try tomorrow or get an API key at [nipregon.pl/api](https://nipregon.pl/api).\n- **Company not found** — `get_company` and `get_financials` cover companies\n  registered in the National Court Register (KRS); financial data covers\n  companies that filed statements electronically.\n\n## Data and privacy\n\nThe server is read-only and returns only data from official public registers.\nSole-trader (JDG) records constitute personal data under GDPR: it is\nprohibited to use this server for creditworthiness scoring, automated\nassessment of natural persons or direct marketing towards sole traders.\nQueries are not logged beyond anonymous daily rate-limit counters.\nDetails: [terms of service](https://nipregon.pl/regulamin) (Polish).\n\n---\n\n![NIPRegon MCP Server](assets/banner-pl.png)\n\n# 🇵🇱 NIPRegon MCP Server (dokumentacja po polsku)\n\nSprawdzaj **polskie firmy** z poziomu dowolnego asystenta AI: dane rejestrowe\n(KRS, REGON, CEIDG), biała lista VAT przed przelewem i sprawozdania finansowe\n4,4 mln polskich podmiotów.\n\nZasilane przez [NIPRegon.pl](https://nipregon.pl): dane wyłącznie z oficjalnych\nrejestrów publicznych (KRS, REGON, CEIDG, wykaz podatników VAT Ministerstwa\nFinansów oraz sprawozdania finansowe złożone do KRS).\n\n## Serwer zdalny (zalecany)\n\nJeden endpoint, zero instalacji:\n\n```\nhttps://api.nipregon.pl/mcp\n```\n\nUniwersalna konfiguracja dla większości klientów MCP:\n\n```json\n{\n  \"mcpServers\": {\n    \"nipregon\": {\n      \"type\": \"http\",\n      \"url\": \"https://api.nipregon.pl/mcp\"\n    }\n  }\n}\n```\n\n**Claude Code:**\n\n```bash\nclaude mcp add --transport http nipregon https://api.nipregon.pl/mcp\n```\n\n**Claude Desktop / claude.ai:** Ustawienia → Konektory → Dodaj własny konektor\n→ wklej `https://api.nipregon.pl/mcp`.\n\nTransport: streamable HTTP (JSON-RPC 2.0). Darmowy limit: 100 wywołań\nnarzędzi dziennie na adres IP. Wyższe limity: [nipregon.pl/api](https://nipregon.pl/api).\n\n## Zapytaj swojego asystenta\n\n- „Sprawdź firmę o NIP 7791906082, zanim podpiszę umowę.\"\n- „Znajdź spółkę Eurocash i pokaż jej przychody z ostatnich 5 lat.\"\n- „Czy rachunek z tej faktury jest na białej liście dostawcy?\"\n\n## Narzędzia\n\n- **search_company** — wyszukiwanie spółek po nazwie (fuzzy). Zwraca NIP, KRS,\n  miasto, status i link do profilu.\n- **get_company** — pełne dane rejestrowe spółki po NIP: adres, forma prawna,\n  status, KRS, REGON, kody PKD, zarząd, status VAT.\n- **get_financials** — roczne sprawozdania finansowe z KRS: przychody, zysk\n  netto, aktywa, kapitał własny, zobowiązania.\n- **check_vat_whitelist** — status VAT w wykazie podatników (biała lista KAS)\n  i opcjonalnie weryfikacja, czy numer rachunku figuruje na białej liście\n  podmiotu (istotne przed przelewem powyżej 15 tys. zł).\n\n## Dane i prywatność\n\nSerwer jest tylko do odczytu i zwraca wyłącznie dane z oficjalnych rejestrów\npublicznych. Dane JDG stanowią dane osobowe (RODO): zakaz wykorzystania do\nscoringu kredytowego, automatycznej oceny osób fizycznych i marketingu\nbezpośredniego wobec JDG. Zapytania nie są logowane poza anonimowymi\nlicznikami limitów dziennych. Szczegóły:\n[regulamin](https://nipregon.pl/regulamin).\n\n## License\n\nMIT (this client and manifest). The NIPRegon.pl service itself is a separate,\nproprietary product of WEBY SOLUTION SP. Z O.O.\n",
  "bytes": 8120,
  "sha": "c023a3387127b59066ad7f2dc093dcaee35cee3889932befe311ca7730f6d522",
  "repo_slug": "amr-dev-ps/nipregon-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_pl_nipregon_nipregon_d467e63c/readme"
}