A Model Context Protocol server for accessing the OpenRegister API
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"iflow-mcp-syndicats-openregister-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# OpenRegister MCP Server A unofficial Model Context Protocol (MCP) server for accessing the [OpenRegister API](https://openregister.de/), providing tools to search and retrieve company information from the German company register. ## 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 ## Requirements - Python 3.9+ - uv - OpenRegister API key (which you can get from https://openregister.de after you have created an account) - Claude Desktop (or another MCP client that understands MCP) ## Installation 1. Clone the repository: ```bash git clone https://github.com/Syndicats/openregister-mcp.git cd openregister-mcp ``` 2. Create a virtual environment and install dependencies: ```bash uv venv source .venv/bin/activate uv pip install "mcp[cli]" httpx dotenv ``` 3. Create a `.env` file based on the example: ```bash 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 as MCP Server Run the server within Claude Desktop, e.g. by editing the `claude_desktop_config.json` from Claude Desktop ```json { "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. #### Caution 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: 1. **search_companies** - Search for companies based on various criteria - Parameters: - `query`…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.