handelsregister.ai
Login Signup
Documentation ChatGPT plugin and MCP

ChatGPT plugin and MCP

Company data right in ChatGPT, Claude and other AI agents.

With the ChatGPT plugin and the MCP server, your AI agent looks up official company data on its own. You ask a question in the chat, the agent picks the right tools and answers with data from the register.

ChatGPT plugin

The ChatGPT plugin is the fastest way. You don’t need an API key, because you sign in with your handelsregister.ai account when you connect.

  1. Open the ChatGPT plugin and add it in ChatGPT.
  2. Sign in with your handelsregister.ai account and confirm the access.
  3. Ask your question, for example “Who runs Hetzner Online GmbH and how has its revenue developed?”
Whether you can use plugins depends on your ChatGPT plan. In company workspaces, admins can allow or block plugins.

Claude, Cursor and other MCP clients

MCP, the Model Context Protocol, is an open standard that AI agents use to access tools and data sources. Any client that connects to an MCP server by URL can use our server.

What
What Value
Server URL https://mcp.handelsregister.ai/mcp
Transport Streamable HTTP
Sign-in OAuth with your account, API key in the x-api-key header or bearer token in the Authorization header

Claude

In Claude, you add the MCP server as a custom connector. In the connector settings, choose “Add custom connector”, enter a name and the server URL, and sign in with your handelsregister.ai account. Then turn the connector on in the chat under “+” › “Connectors”.

In Team and Enterprise workspaces, an owner adds the connector for everyone. Each member then connects their own handelsregister.ai account.

Claude Code

In Claude Code, you add the server with one command. With the header, Claude Code uses your API key.

Terminal 
claude mcp add --transport http handelsregister https://mcp.handelsregister.ai/mcp \
  --header "x-api-key: YOUR_API_KEY"

Without the header, you sign in in the browser instead: start a session and select the server under /mcp.

Cursor

Cursor reads MCP servers from .cursor/mcp.json in the project or from ~/.cursor/mcp.json for all projects. Many other clients use the same format.

mcp.json 
{
    "mcpServers": {
        "handelsregister": {
            "url": "https://mcp.handelsregister.ai/mcp",
            "headers": {
                "x-api-key": "YOUR_API_KEY"
            }
        }
    }
}

Other MCP clients

Enter the server URL and send your API key in the x-api-key header with every request. Alternatively, use a bearer token in the Authorization header; Authentication shows how to create one.

You find your API key under Account › API keys. It belongs in the configuration on your machine, never in a public repository.

Available tools

The MCP server offers tools for your account, company profiles, people, documents, search and Signals. All tools only read: they create nothing and change no settings. They cost as many credits as the same request to the API.

The company tools take an entity_id, a company name or register court with register number in the q parameter, for example “Ansbach HRB 6089”. The entity_id from a search is the most reliable. For most company tools, ai_search turns on AI Mode and realtime turns on Realtime.

Account

Tool
Tool What it returns Credits
get_account_status Plan, balance, next credit expiry and the data your plan unlocks. free

Company profile

Each company tool costs the base price of the company profile plus the price of its feature, just like fetch-organization. The feature is only charged when it returns data.

Tool
Tool What it returns Credits
get_company_overview The basic data: name, status, legal form, register, address, capital, business purpose and industry. 5
get_company_snapshot Basic data, Financial KPIs and the current management in one call. 5 + 1 + 2
get_financials Financial KPIs per financial year, such as revenue, net income and employees. 5 + 1
get_balance_sheet The balance sheet with all items. 5 + 3
get_profit_and_loss The profit and loss statement (P&L). 5 + 3
get_annual_financial_statements Full-text annual financial statements as Markdown. 5 + 5
get_annual_financial_statements_html Full-text annual financial statements as HTML. 5 + 5
get_related_persons The management and other registered people, former ones too if you ask for them. 5 + 2
get_shareholders The shareholders with their stakes. 5 + 5
get_ubos The beneficial owners (UBO). 5 + 10
get_shareholdings The company’s shareholdings in other companies. 5 + 5
get_mergers_and_acquisitions Mergers & Acquisitions (M&A) and enterprise agreements. 5 + 20
get_publications The history of register notices. 5 + 1
get_insolvency_publications Insolvency notices. 5 + 5
get_news News about the company from the web. 5 + 10
get_website_content The content of the company website as Markdown. This tool always uses AI Mode. 5 + 20 (AI Mode)
get_company_features Several features in one call, with only one base price. 5 + features

People and documents

Tool
Tool What it returns Credits
fetch_person The person profile: positions, shareholdings and career of a person, looked up by name and a related company. · from Plus 15, with shareholdings + 5
fetch_document A document from the register: Aktueller Abdruck (AD, current printout), Chronologischer Abdruck (CD, chronological printout), Strukturierter Registerinhalt (SI, structured register content), Gesellschafterliste (shareholder list) or articles of association. 15

Search

The search tools return up to 30 results per page, each with its entity_id. Your agent then uses it to fetch the company profile.

Tool
Tool What it returns Credits
search_organizations Find companies by name or filters. 1 per page
search_organizations_advanced Search with all filters of the API and sorting, for example by revenue or founding date. 1 per page
find_companies_by_industry Companies in an industry, described in words or as a WZ code. 1 per page
find_companies_by_financials Companies by revenue, employees, net income, equity and other KPIs. 1 per page
find_companies_near Companies around a location, nearest first. 1 per page
find_newly_registered_companies Newly registered companies in a period. 1 per page
find_recently_changed_companies Companies with recent changes, for example in management, registered seat or capital. 1 per page
find_related_companies Connected companies through shareholdings, positions, mergers or enterprise agreements. 1 per page
find_companies_by_person Companies in which a person holds a position. Search by shareholder is available with Pro and Max. 1 per page
find_companies_by_ownership Companies by ownership structure, for example owner-managed or family-owned. · Pro, Max 1 per page
find_companies_by_management Companies by age and size of the management. · Pro, Max 1 per page
find_companies_in_insolvency Companies in insolvency proceedings, by phase and period. · Pro, Max 1 per page
get_search_filter_reference The allowed values of the search filters. free
find_industry_codes WZ codes for an industry described in words, for example “software development”. free

Signals

The Signals tools return changes in the register across all companies, up to 20 per page. A page is charged even when it is empty.

Tool
Tool What it returns Credits
get_recent_new_registrations New registrations. 20 per page
get_recent_management_changes Management changes. 20 per page
get_recent_capital_changes Capital changes. 20 per page
get_recent_master_data_changes Master data changes such as name, registered seat or address. 20 per page
get_recent_company_closures Closures & dissolutions. 20 per page
get_recent_insolvency_events Insolvencies. · Pro, Max 20 per page
get_recent_mergers_and_transformations Transformations & M&A. · Max 20 per page
get_recent_company_changes All changes for up to five specific companies. 20 per page
get_signal_details A single signal with all details. 20

Costs

Each tool call costs as many credits as the same request to the API. There is no separate fee for MCP. The credits are deducted from the account you signed in with or that the API key belongs to.

The same rules apply as in the API: features without data cost nothing, and a failed call costs nothing. AI Mode is charged even without a match, Realtime for every successful live fetch. Every result states the charged credits in meta.request_credit_cost and your balance in meta.credits_remaining.

The limits are also the same as in the API, for documents for example 5 requests per minute. More under Billing and Limits.

Authentication API key, bearer token and OAuth at a glance. Billing What each request costs and how you track it.