Openregister MCP

🚀 OpenRegister MCP Server

An unofficial Model Context Protocol (MCP) server for accessing the OpenRegister API, offering tools to search and retrieve company information from the German company register.

🚀 Quick Start

This server allows you to access the OpenRegister API and retrieve company information through the MCP protocol. Follow the steps below to get started.

✨ Features

• Search for companies based on various criteria (name, register number, type, etc.).
• Get detailed company information including history, financials, and documents.
• Retrieve company shareholders information.

📦 Installation

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 to the .env file:

   OPENREGISTER_API_KEY=your_api_key_here
   OPENREGISTER_API_URL=https://api.openregister.de/v0
   

💻 Usage Examples

Usage as MCP Server

Run the server within Claude Desktop, e.g., by editing the claude_desktop_config.json from Claude Desktop:

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

Restart Claude Desktop so that the changes take effect.

⚠️ Important Note

Sometimes it is necessary to use the absolute path for uv. Then the JSON needs to be changed accordingly.

Available Tools

The server provides the following MCP tools:

Basic Usage

• search_companies: Search for companies based on various criteria.
  • Parameters:
    • query: Text search query to find companies by name.
    • register_number: Company register number for exact matching.
    • register_type: Type of register to filter results (e.g., "HRB", "HRA", "PR", "GnR", "VR").
    • register_court: Court where the company is registered.
    • active: Filter for active or inactive companies (default: true).
    • legal_form: Legal form of the company (e.g., "gmbh", "ag", "ug").

Advanced Usage

• get_company_info: Get detailed information about a company using its unique ID.

  • Parameters:
    • company_id: Unique company identifier (e.g., "DE-HRB-F1103-267645").
    • history: Include historical company data (default: true).
    • financials: Include financial data (default: true).
    • documents: Include document metadata (default: true).

• get_company_shareholders: Retrieve the shareholders of a company.

  • Parameters:
    • company_id: Unique company identifier (e.g., "DE-HRB-F1103-267645").
  • Note: Currently only supports companies with the legal form GmbH.

📄 License

MIT