logo

KRS Poland MCP Server

An MCP server for the Polish National Court Register (KRS) public API.

Usage

This server is designed to be run with npx, allowing you to use it as a tool provider for LLM clients without a global installation.

Running with npx

To start the server, run the following command:

npx krs-poland-mcp-server

Configuration for LLM Clients

To integrate this server with an LLM client (like LM Studio or others that support MCP), you can configure it to spawn the server process. Here is an example configuration:

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

This configuration tells the client how to start the KRS tool server.

Server Functions

The server provides the following tools (checklist):

• [x] Get Current KRS Record (get-krs-current-extract): Retrieves the current status and information for a given entity from the KRS.
• [x] Get Full KRS Record (get-krs-full-extract): Retrieves the complete historical data for a given entity from the KRS.

Development

To run the server in a development environment:

1. Clone the repository.
2. Install dependencies: npm install
3. Build the project: npm run build
4. Run the server: npm start

Author

Piotr Kolawa (@pkolawa) / (Linkedin)

License

This project is licensed under the MIT License - see the LICENSE file for details.