Log inSubmit server
MCP Krs logo

MCP Krs

Queries Poland’s official KRS registry for company records, registration history, board details, and representation rules.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Krs

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mcp-krs": {
      "command": "npx",
      "args": [
        "-y",
        "@matematicsolutions/mcp-krs"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 3 tools correctly (19d ago).

Overview

mcp-krs MCP server queries Poland’s Krajowy Rejestr Sądowy through the official Ministry of Justice API. It provides current entity data, full records with entry history, and a focused board-and-representation lookup using a KRS number and register type. Reach for it when an agent needs Polish company details, signing authority context, or commercial proxy information from the registry.

Use cases

  • Look up a Polish company by KRS number
  • Check board composition and representation rules
  • Retrieve a company’s registry entry history
  • Find commercial proxies recorded in KRS
  • Open the Ministry of Justice source record

Key features

  • Current KRS entity extracts
  • Full records with entry history
  • Board and representation lookup
  • Commercial proxy data
  • Automatic KRS number padding
  • Structured Ministry of Justice citations

Tools3

What MCP Krs lets your agent do. Expand a tool for its parameters.

Verified live~372 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

8/8 checks healthy over the last 49d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11d ago via OSV.dev · @matematicsolutions/mcp-krs (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads294Package downloads in the last 30 days.
Last commit14d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed3Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Krs works

What mcp-krs MCP server does

mcp-krs MCP server exposes Polish National Court Register data through the Model Context Protocol. It connects to the Ministry of Justice’s official KRS API and returns registry information for entities in the entrepreneurs register or associations register.

The returned entity data can include the registered name, legal form, NIP, REGON, address, share capital, primary PKD code, status, court, board composition, representation rules, and commercial proxies. Depending on the tool, the response can represent the current record or include the entity’s entry history. Responses also include a Ministry of Justice search URL and structured citation metadata.

How it works

The client supplies a KRS identifier containing one to ten digits. The server pads shorter values with leading zeroes before making the request; for example, 28860 becomes 0000028860. The optional rejestr parameter selects the register: P for entrepreneurs, which is the default, or S for associations.

Requests use the official Ministry of Justice API and are sent over the server’s stdio transport. A 500-millisecond throttle limits request frequency to two requests per second. The implementation uses Node.js and the built-in fetch API.

Personal data for board members is returned in the masked form supplied by the Ministry of Justice API. The server passes that data through without attempting to reveal or reconstruct hidden surnames. Users who need the full surnames must follow the provided Ministry of Justice link and authenticate in a browser.

Setup and configuration

The published package can run without cloning the repository:

Terminal
npx -y @matematicsolutions/mcp-krs

For a stdio MCP client, configure the command as npx with -y and @matematicsolutions/mcp-krs as its argument. Building from source requires Node.js 18 or newer:

Terminal
npm install
npm run build
node dist/index.js

No environment variables are documented. The source can also be connected to Patron with a stdio entry that runs node against dist/index.js.

Tools and capabilities

The mcp-krs MCP server exposes three tools:

  • get_entity(krs, rejestr?) returns the current extract for an entity.
  • get_entity_full(krs, rejestr?) returns the full extract, including entry history.
  • get_board(krs, rejestr?) returns representation rules, board composition, and commercial proxies.

Each response includes structured citation fields such as the title, source URL, KRS number, entity name, NIP, REGON, legal form, status, locality, registry court, and selected register. This metadata can be rendered by clients that support structured MCP content.

Limitations and notes

The service depends on the official Ministry of Justice API and its available response data. Board-member surnames may be masked by the source. The server is a registry lookup connector, so it provides source data and representation rules but does not independently decide whether a specific contract signature is legally sufficient.

The documented transport is stdio. The repository describes the connector as compatible with MCP clients generally, while Patron has an explicit integration example. The API request throttle is part of the implementation and may affect sequences of lookups.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Krs

mcp-krs is an MCP server that connects AI clients to Poland’s official Krajowy Rejestr Sądowy API from the Ministry of Justice. Its main tools retrieve current entity data, full records with entry history, and board information including representation rules and commercial proxies, using a KRS number and register type.

Install it by running `npx -y @matematicsolutions/mcp-krs` and configure your MCP client to use `npx` with `-y` and the package name as arguments. Source builds require Node.js 18 or newer, followed by `npm install`, `npm run build`, and `node dist/index.js`.

mcp-krs supports the `P` entrepreneurs register and the `S` associations register. `P` is selected by default when the optional `rejestr` parameter is omitted.

No, mcp-krs returns board-member personal data in the masked form provided by the Ministry of Justice API. Users needing full surnames must open the supplied Ministry of Justice link in a browser after logging in.

The repository states that mcp-krs works with any MCP client and documents stdio configuration. It does not provide Cursor-specific setup instructions, so configure it as a standard stdio server using the published npm command.

Related MCP servers

All in Legal All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Krs AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mcp-krs?style=directory)](https://allmcps.com/mcp/mcp-krs)
HTML Embed
<a href="https://allmcps.com/mcp/mcp-krs"><img src="https://allmcps.com/api/badge/mcp-krs?style=directory" alt="MCP Krs on AllMCPs" /></a>