handelsregister.ai
Anmelden Registrieren
Dokumentation ChatGPT-Plugin und MCP

ChatGPT-Plugin und MCP

Firmendaten direkt in ChatGPT, Claude und anderen KI-Agenten.

Mit dem ChatGPT-Plugin und dem MCP-Server fragt dein KI-Agent amtliche Firmendaten selbst ab. Du stellst eine Frage im Chat, der Agent wählt die passenden Tools und antwortet mit Daten aus dem Register.

ChatGPT-Plugin

Das ChatGPT-Plugin ist der schnellste Weg. Du brauchst keinen API-Schlüssel, denn du meldest dich beim Verbinden mit deinem handelsregister.ai-Konto an.

  1. Öffne das ChatGPT-Plugin und füge es in ChatGPT hinzu.
  2. Melde dich mit deinem handelsregister.ai-Konto an und bestätige den Zugriff.
  3. Stell deine Frage, etwa „Wer führt die Hetzner Online GmbH und wie hat sich ihr Umsatz entwickelt?“
Ob du Plugins nutzen kannst, hängt von deinem ChatGPT-Plan ab. In Arbeitsbereichen von Firmen können Admins Plugins freigeben oder sperren.

Claude, Cursor und andere MCP-Clients

MCP, das Model Context Protocol, ist ein offener Standard, über den KI-Agenten Tools und Datenquellen nutzen. Jeder Client, der einen MCP-Server per URL einbindet, kann unseren Server verwenden.

Was
Was Wert
Server-URL https://mcp.handelsregister.ai/mcp
Transport Streamable HTTP
Anmeldung OAuth mit deinem Konto, API-Schlüssel im Header x-api-key oder Bearer-Token im Header Authorization

Claude

In Claude fügst du den MCP-Server als eigenen Connector hinzu. Wähle in den Connector-Einstellungen „Add custom connector“, gib einen Namen und die Server-URL ein und melde dich mit deinem handelsregister.ai-Konto an. Danach schaltest du den Connector im Chat über „+“ › „Connectors“ ein.

In Team- und Enterprise-Arbeitsbereichen fügt ein Owner den Connector für alle hinzu. Jedes Mitglied verbindet danach sein eigenes handelsregister.ai-Konto.

Claude Code

In Claude Code bindest du den Server mit einem Befehl ein. Mit dem Header nutzt Claude Code deinen API-Schlüssel.

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

Ohne den Header meldest du dich stattdessen im Browser an: Starte eine Sitzung und wähle den Server unter /mcp aus.

Cursor

Cursor liest MCP-Server aus .cursor/mcp.json im Projekt oder aus ~/.cursor/mcp.json für alle Projekte. Viele andere Clients nutzen dasselbe Format.

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

Andere MCP-Clients

Trag die Server-URL ein und schick bei jeder Anfrage deinen API-Schlüssel im Header x-api-key mit. Alternativ geht ein Bearer-Token im Header Authorization; wie du eines erstellst, steht unter Authentifizierung.

Deinen API-Schlüssel findest du unter Konto › API-Schlüssel. Er gehört in die Konfiguration auf deinem Rechner, nie in ein öffentliches Repository.

Verfügbare Tools

Der MCP-Server bietet Tools für dein Konto, Firmenprofile, Personen, Dokumente, Suche und Signals. Alle Tools lesen nur: Sie legen nichts an und ändern keine Einstellungen. Sie kosten so viele Credits wie die gleiche Anfrage an die API.

Die Firmen-Tools nehmen im Parameter q eine entity_id, einen Firmennamen oder Registergericht mit Registernummer, etwa „Ansbach HRB 6089“. Am zuverlässigsten ist die entity_id aus einer Suche. Bei den meisten Firmen-Tools schaltest du mit ai_search den AI-Mode und mit realtime Echtzeit zu.

Konto

Tool
Tool Was es liefert Credits
get_account_status Plan, Guthaben, nächster Verfall von Credits und die Daten, die dein Plan freischaltet. kostenlos

Firmenprofil

Jedes Firmen-Tool kostet den Grundpreis des Firmenprofils plus den Preis seines Features, genau wie fetch-organization. Das Feature wird nur berechnet, wenn es Daten liefert.

Tool
Tool Was es liefert Credits
get_company_overview Die Basisdaten: Name, Status, Rechtsform, Register, Anschrift, Kapital, Gegenstand und Branche. 5
get_company_snapshot Basisdaten, Finanz-KPIs und die aktuelle Geschäftsführung in einem Aufruf. 5 + 1 + 2
get_financials Finanz-KPIs pro Geschäftsjahr, etwa Umsatz, Jahresergebnis und Mitarbeiter. 5 + 1
get_balance_sheet Die Bilanz mit allen Posten. 5 + 3
get_profit_and_loss Die Gewinn- und Verlustrechnung (GuV). 5 + 3
get_annual_financial_statements Jahresabschlüsse im Volltext als Markdown. 5 + 5
get_annual_financial_statements_html Jahresabschlüsse im Volltext als HTML. 5 + 5
get_related_persons Die Geschäftsführung und weitere eingetragene Personen, auf Wunsch auch frühere. 5 + 2
get_shareholders Die Gesellschafter mit ihren Anteilen. 5 + 5
get_ubos Die wirtschaftlich Berechtigten (UBO). 5 + 10
get_shareholdings Die Beteiligungen der Firma an anderen Firmen. 5 + 5
get_mergers_and_acquisitions Fusionen & Übernahmen (M&A) und Unternehmensverträge. 5 + 20
get_publications Die Historie der Registerbekanntmachungen. 5 + 1
get_insolvency_publications Insolvenzbekanntmachungen. 5 + 5
get_news Nachrichten über die Firma aus dem Web. 5 + 10
get_website_content Der Inhalt der Firmenwebsite als Markdown. Dieses Tool nutzt immer den AI-Mode. 5 + 20 (AI-Mode)
get_company_features Mehrere Features in einem Aufruf, mit nur einem Grundpreis. 5 + Features

Personen und Dokumente

Tool
Tool Was es liefert Credits
fetch_person Das Personenprofil: Ämter, Beteiligungen und Werdegang einer Person, gesucht mit Name und einer zugehörigen Firma. · ab Plus 15, mit Beteiligungen + 5
fetch_document Ein Dokument aus dem Register: Aktueller Abdruck (AD), Chronologischer Abdruck (CD), Strukturierter Registerinhalt (SI), Gesellschafterliste oder Gesellschaftsvertrag bzw. Satzung. 15

Suche

Die Such-Tools liefern bis zu 30 Treffer pro Seite, jeweils mit entity_id. Damit ruft dein Agent danach das Firmenprofil ab.

Tool
Tool Was es liefert Credits
search_organizations Firmen nach Namen oder Filtern finden. 1 pro Seite
search_organizations_advanced Suche mit allen Filtern der API und Sortierung, etwa nach Umsatz oder Gründungsdatum. 1 pro Seite
find_companies_by_industry Firmen einer Branche, beschrieben in Worten oder als WZ-Code. 1 pro Seite
find_companies_by_financials Firmen nach Umsatz, Mitarbeitern, Ergebnis, Eigenkapital und weiteren Kennzahlen. 1 pro Seite
find_companies_near Firmen im Umkreis eines Ortes, die nächsten zuerst. 1 pro Seite
find_newly_registered_companies Neu eingetragene Firmen in einem Zeitraum. 1 pro Seite
find_recently_changed_companies Firmen mit jüngsten Änderungen, etwa in der Geschäftsführung, am Sitz oder am Kapital. 1 pro Seite
find_related_companies Verbundene Firmen über Beteiligungen, Ämter, Fusionen oder Unternehmensverträge. 1 pro Seite
find_companies_by_person Firmen, in denen eine Person ein Amt hat. Die Suche nach Gesellschaftern gibt es mit Pro und Max. 1 pro Seite
find_companies_by_ownership Firmen nach Eigentümerstruktur, etwa inhabergeführt oder in Familienhand. · Pro, Max 1 pro Seite
find_companies_by_management Firmen nach Alter und Größe der Geschäftsführung. · Pro, Max 1 pro Seite
find_companies_in_insolvency Firmen in einem Insolvenzverfahren, nach Phase und Zeitraum. · Pro, Max 1 pro Seite
get_search_filter_reference Die erlaubten Werte der Suchfilter. kostenlos
find_industry_codes WZ-Codes zu einer Branche in Worten, etwa „Softwareentwicklung“. kostenlos

Signals

Die Signals-Tools liefern Änderungen im Register über alle Firmen, bis zu 20 pro Seite. Eine Seite wird auch berechnet, wenn sie leer ist.

Tool
Tool Was es liefert Credits
get_recent_new_registrations Neueintragungen. 20 pro Seite
get_recent_management_changes Führungswechsel. 20 pro Seite
get_recent_capital_changes Kapitaländerungen. 20 pro Seite
get_recent_master_data_changes Stammdatenänderungen wie Name, Sitz oder Anschrift. 20 pro Seite
get_recent_company_closures Löschungen & Auflösungen. 20 pro Seite
get_recent_insolvency_events Insolvenzen. · Pro, Max 20 pro Seite
get_recent_mergers_and_transformations Umwandlungen & M&A. · Max 20 pro Seite
get_recent_company_changes Alle Änderungen zu bis zu fünf bestimmten Firmen. 20 pro Seite
get_signal_details Ein einzelnes Signal mit allen Angaben. 20

Kosten

Jeder Tool-Aufruf kostet so viele Credits wie die gleiche Anfrage an die API. Eine eigene Gebühr für MCP gibt es nicht. Die Credits gehen vom Konto ab, mit dem du dich angemeldet hast oder zu dem der API-Schlüssel gehört.

Es gelten dieselben Regeln wie in der API: Features ohne Daten kosten nichts, und ein fehlgeschlagener Aufruf kostet nichts. Der AI-Mode wird auch ohne Ergebnis berechnet, Echtzeit bei jedem erfolgreichen Live-Abruf. Jedes Ergebnis nennt in meta.request_credit_cost die berechneten Credits und in meta.credits_remaining dein Guthaben.

Auch die Limits sind dieselben wie in der API, für Dokumente etwa 5 Anfragen pro Minute. Mehr dazu unter Abrechnung und Limits.

Authentifizierung API-Schlüssel, Bearer-Token und OAuth im Überblick. Abrechnung Was jede Anfrage kostet und wie du es nachvollziehst.