# Krs MCP

> Krs MCP is an open-source MCP server for legal and government. Search the Polish KRS company register by name, KRS, NIP or REGON and pull extracts. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://sobalabs.ai/open-source/
- **Repository:** https://github.com/soba-labs/krs-mcp
- **MCP Registry name:** io.github.soba-labs/krs-mcp
- **Categories:** legal and government, analytics and data
- **Listing updated:** 2026-11-14

## About

Four read-only tools front the Polish National Court Register. Name search runs against an undocumented endpoint behind the Ministry of Justice's public search site, which the README warns may change or reject programmatic use without notice. Official extracts come from the ministry's keyless API.

A typical run starts with a company-name search to resolve a ten-digit KRS number, then fetches the current extract as compact markdown covering identity, address, board, capital and PKD codes. A full extract preserves every historical entry as JSON and is much larger, and a slimmer call returns only the board, supervisory bodies and proxies. Results include a second block with provenance: source URL and retrieval time.

It needs Node.js 22.12 or later, no API key and no account. Requests time out after 15 seconds and are retried twice on network errors, HTTP 429 and server errors. It comes from Soba Labs, whose open-source page lists it under the MIT licence.

## Features

- **Four lookup keys:** Search by name, KRS, NIP or REGON.
- **Entrepreneurs and associations:** Defaults to both register types, with paging.
- **Current and full extracts:** Markdown for the current record, JSON for full history.
- **Board view:** Returns just board members, supervisory bodies and proxies.
- **Provenance block:** Each result carries source URL and retrieval time.
- **Retries:** Timeouts of 15 seconds with two retries on transient failures.

## Good for

- Check who sits on the board of a Polish company
- Resolve a company name to a KRS number for due diligence
- Pull an official extract into an agent's report
- Look up a company from its NIP or REGON

## Install

### Claude Code (Terminal)

```sh
claude mcp add krs-mcp -- npx -y krs-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "krs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "krs-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "krs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "krs-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "krs-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "krs-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "krs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "krs-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "krs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "krs-mcp"
      ]
    }
  }
}
```

## Tools

- `search_companies`: Finds entities by name, KRS, NIP or REGON, with paging.
- `get_company`: Returns the current official extract as markdown.
- `get_company_full`: Returns the full extract as JSON with historical entries.
- `get_board`: Returns the board, supervisory bodies and proxies.

## FAQ

### Do I need an API key?

No. It needs no key, account or configuration.

### Which Node.js version is required?

22.12 or later.

### Which tool should I call first?

search_companies, to turn a name into a KRS number.

### Is the search endpoint official?

The README says it is undocumented and may change.

### Is Krs MCP free?

Yes. Krs MCP is open source, so you can use and self-host it for free.

### How do I add Krs MCP to Claude Code?

Run this command in your terminal: claude mcp add krs-mcp -- npx -y krs-mcp

### What are the best alternatives to Krs MCP?

The closest alternatives to Krs MCP are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/krs-mcp
