Skip to content
MCP server

Krs MCP

Search the Polish KRS company register by name, KRS, NIP or REGON and pull extracts

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.1.1
Listing updated
3 days ago

About Krs MCP

Krs MCP is an open-source MCP server for legal and government. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add krs-mcp -- npx -y krs-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "krs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "krs-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "krs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "krs-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

MIT licence; no API key

Prices change. Check sobalabs.ai before you buy.

Krs MCP 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 to Krs MCP

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data
  6. New York LLC publication rules, deadline, county prices, clerks and notice text

    • 8 tools
    • Remote
    • Free
    • Legal and government