
MCP server for the Polish KRS (National Court Register). Search companies by name, KRS, NIP or REGON
MCP server for the Polish KRS (National Court Register). Search companies by name, KRS, NIP or REGON and fetch official registry extracts.
·
An MCP server for the Polish KRS (Krajowy Rejestr Sądowy — National Court Register). It lets any MCP-capable AI client search Polish companies by name, KRS, NIP or REGON, and fetch official current and full registry extracts.
All four tools are read-only and require no API key, account, or configuration. KRS data is public record. Node.js 22.12 or later is required.
| Tool | Inputs | Returns |
|---|---|---|
search_companies | query (name or partial name) and/or krs, nip, regon; optional registries (array of registry types: P = entrepreneurs, S = associations; defaults to ["P", "S"], both searched), page, pageSize | Matching entities with their zero-padded 10-digit KRS numbers, city, registry, bankruptcy flag; paginated. Use this first to resolve a company name to a KRS number. |
get_company | krs (1–10 digits, padding applied automatically), rejestr (P/S, default P) | Current official extract (odpis aktualny): identity, address, board, capital, PKD — as markdown |
get_company_full | same as get_company | Full official extract (odpis pełny) as semantic JSON, preserving all historical entries. Much larger; prefer get_company unless you need history |
get_board | same as get_company | Slim view of just the board, supervisory bodies and proxies (prokurenci) |
sourceProducedAt is null rather than inferred. The full extract remains parseable JSON in the first text block.Requests time out after 15 seconds. Network errors, HTTP 429 responses, and server errors are retried twice with short delays. Authentication or permission failures are returned immediately.
A daily GitHub Actions check verifies company-name search and the official extract API against a known public Soba Labs record. A contract change or access failure opens or updates one incident issue. Temporary upstream outages fail the check without creating an issue. Maintainers can also run npm run check:live manually.
GitHub may disable scheduled workflows in a public repository after 60 days without repository activity. If this repository becomes inactive, a maintainer must re-enable the workflow or run it manually.
The live check detects breakage; it does not make the undocumented search endpoint official or supported. A 403 requires human review. Maintainers and repair agents must not bypass new access controls automatically. The official extract tools remain usable if only name search breaks.
Add to your MCP configuration:
{
"mcpServers": {
"krs-mcp": {
"command": "npx",
"args": ["-y", "krs-mcp"]
}
}
}git clone https://github.com/soba-labs/krs-mcp.git
cd krs-mcp
npm install && npm run buildnpm test is fully self-contained (synthetic fixtures, no network). Optionally, node scripts/fetch-test-fixtures.mjs refreshes ignored live captures for manual comparison with KRS 0001245101.
{
"mcpServers": {
"krs-mcp": {
"command": "node",
"args": ["<path-to-repo>/dist/index.js"]
}
}
}search_companies with "query": "allegro" → get the padded KRS numberget_company with "krs": "0000245961" → current extractget_board with the same KRS → just the peopleNeed an MCP server for your own registry, CRM or internal data? Talk to Soba Labs.
The Ministry of Justice's public-sector information reuse conditions require users to identify the source, the time the information was produced and obtained, and any processing applied to it. krs-mcp adds those disclosure fields to every successful tool result and explicitly marks an unavailable source-production time as null. Downstream users remain responsible for preserving the required attribution and complying with applicable privacy and reuse rules.
krs-mcp sends requests only to the Ministry's KRS services. It has no telemetry and does not persist registry responses. Your MCP client may send tool output to its configured model provider; review that provider's privacy terms before processing personal data. The Ministry controls masking in the source responses, and krs-mcp does not independently redact fields in full extracts.
This project is not affiliated with, endorsed by, or connected to the Polish Ministry of Justice (Ministerstwo Sprawiedliwości). Registry data is fetched from public government sources. Formatted tools transform or select fields as described above; full extracts are passed through as JSON. Provided without warranty of any kind.
krs-mcp is free and open source under the MIT license, built and maintained by Soba Labs, an AI-native software development agency that builds and operates production agentic systems. If you need an MCP server or an agent built on your own data, talk to Soba Labs or write to [email protected].
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add krs-mcp -- npx -y krs-mcp{
"mcpServers": {
"krs-mcp": {
"args": [
"-y",
"krs-mcp"
],
"command": "npx"
}
}
}code --add-mcp '{"name":"krs-mcp","args":["-y","krs-mcp"],"command":"npx"}'[mcp_servers.krs-mcp]
command = "npx"
args = ["-y", "krs-mcp"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/krs-mcp to learn what the "Krs Mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
| Name | What it does |
|---|---|
search_companies | Search Polish companies in the KRS (National Court Register) by name or partial name ("query"), KRS, NIP or REGON. Returns matching entities with their padded 10-digit KRS numbers — use this FIRST to |
get_company | Fetch the CURRENT (aktualny) official extract of a Polish company from the KRS registry by its 1-10 digit KRS number. Returns identity, address, board, capital and PKD as markdown. |
get_company_full | Fetch the FULL (pelny) official semantic JSON extract of a Polish company from the KRS registry by its 1-10 digit KRS number. Preserves all historical entries. Much larger than the current extract; us |
get_board | List the board, supervisory bodies and proxies of a Polish company from its current KRS extract. Resolve the KRS number first with search_companies. |
Read live from the server on November 13, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/krs-mcp)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "krs-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.