OpenRegister

An MCP server that accesses the OpenRegister API to search and retrieve German company data.

python

8

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "syndicats-openregister-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<Absolute Path to openregister-mcp>/openregister-mcp",
        "run",
        "server.py"
      ],
      "env": {
        "OPENREGISTER_API_KEY": "YOUR_API_KEY",
        "OPENREGISTER_API_URL": "https://api.openregister.de/v0"
      }
    }
  }
}

You can use an MCP server to access OpenRegister through MCP clients, enabling you to search for German companies and fetch detailed company data, including history, financials, documents, and shareholders, in a structured, programmatic way.

How to use

Install and run the MCP server in your environment, then connect with your MCP client to access search and data endpoints. You can perform three core actions: search_companies to find companies by name or identifiers; get_company_info to retrieve comprehensive details for a specific company; and get_company_shareholders to obtain the ownership structure for GmbH entities. Configure your client to point to the local MCP server, provide your OpenRegister API key, and supply any needed search parameters to tailor results. Ensure your environment variable OPENREGISTER_API_KEY is set and that the server has access to OPENREGISTER_API_URL for the API endpoint.

How to install

Prerequisites you must have before starting:

Python 3.9+
uv
OpenRegister API key obtained from OpenRegister after creating an account

Installation steps

# 1) Clone the repository
git clone https://github.com/Syndicats/openregister-mcp.git
cd openregister-mcp

# 2) Create a virtual environment and install dependencies
uv venv
source .venv/bin/activate
uv pip install "mcp[cli]" httpx dotenv

# 3) Create a .env file based on the example
cp env.example .env

# 4) Add your OpenRegister API key and URL
OPENREGISTER_API_KEY=your_api_key_here
OPENREGISTER_API_URL=https://api.openregister.de/v0

Configure the MCP server in Claude Desktop

{
  "mcpServers": {
    "openregister": {
      "command": "uv",
      "args": [
        "--directory",
        "<Absolute Path to openregister-mcp>/openregister-mcp",
        "run",
        "server.py"
      ]
    }
  }
}

Available tools

search_companies

Search for companies by name, register number, type, court, and other criteria to find matching entities.

get_company_info

Retrieve detailed information for a specific company by its unique ID, with options to include history, financials, and documents.

get_company_shareholders

Fetch the shareholders of a company, currently supported for GmbH entities.