# OpenRegister — how to use (mcp.ai)

Connect your OpenRegister account and use 10 tools for business intelligence straight from your AI agent. Connect with your own API key. OpenRegister provides structured German company, person, ownership, financial, insolvency, document, monitoring, and usage data.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_open_register?ms=1787295780000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `open_register_get_company_data`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/open_register`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/open_register/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/open_register/get/company/data` — Read one company profile, financials, historical ownership, holdings, current owners, or UBOs. Operations cost 10-25 credits; realtime profile/owners cost 20 credits. Historical ownership polls only a
  - body: { export?: boolean, realtime?: boolean, data_type?: string, company_id: string, best_available?: boolean, wait_for_completion?: boolean, poll_timeout_seconds?: integer }
- `POST https://api.mcp.ai/api/open_register/get/credit/usage` — Check the connected OpenRegister account's plan, included and used credits, remaining balance, overage, and reset time. This request costs 0 credits.
- `POST https://api.mcp.ai/api/open_register/get/document` — Fetch an official Handelsregister document in real time for a company or retrieve a stored document by ID. Each request costs 10 credits. The tool returns document metadata and an ephemeral URL withou
  - body: { company_id?: string, document_id?: string, document_source: string, document_category?: string }
- `POST https://api.mcp.ai/api/open_register/get/insolvency` — Get one insolvency proceeding and its complete published event history, including linked entities, status, court, case dates, administration, distributions, and event-specific details. Costs 10 OpenRe
  - body: { insolvency_id: string }
- `POST https://api.mcp.ai/api/open_register/get/person/data` — Read a person's profile and management positions or the companies in which they hold ownership stakes. Each request costs 10 credits.
  - body: { data_type?: string, person_id: string }
- `POST https://api.mcp.ai/api/open_register/list/monitors` — List every company and person monitor for the connected OpenRegister account, including disabled monitors. This unpaginated read costs zero credits and was verified as available on a free account. It 
- `POST https://api.mcp.ai/api/open_register/lookup/company/by/url` — Resolve a fully qualified company website URL to its OpenRegister company ID and available contact details. Each lookup costs 10 credits.
  - body: { url: string }
- `POST https://api.mcp.ai/api/open_register/search/companies` — Find companies by name or structured criteria. Use autocomplete for a fast 1-credit lookup, or advanced search for filters, location, and paginated results at 10 credits per page.
  - body: { query?: string, filters?: object[], location?: object, per_page?: integer, next_cursor?: string, search_mode?: string }
- `POST https://api.mcp.ai/api/open_register/search/insolvencies` — Search German insolvency proceedings by free text or structured debtor, proceeding, status, date, company, or person criteria. Returns one page at a time; each page costs 10 OpenRegister credits.
  - body: { query?: string, filters?: object[], per_page?: integer, next_cursor?: string }
- `POST https://api.mcp.ai/api/open_register/search/people` — Search natural persons by name, birth date, city, or active status. Each returned page costs 10 credits.
  - body: { query?: string, filters?: object[], per_page?: integer, next_cursor?: string }

## Example prompts
- "What can I do in OpenRegister?"
- "Show me a summary of my OpenRegister account"

## More
- Page: https://mcp.ai/open_register
- Agent spec (llms.txt): https://mcp.ai/open_register/llms.txt
- Postman collection: https://mcp.ai/open_register/postman.json