ChatGPT-plugin en MCP
Bedrijfsgegevens direct in ChatGPT, Claude en andere AI-agents.
Met de ChatGPT-plugin en de MCP-server zoekt je AI-agent zelf officiële bedrijfsgegevens op. Je stelt een vraag in de chat, de agent kiest de juiste tools en antwoordt met gegevens uit het register.
ChatGPT-plugin
De ChatGPT-plugin is de snelste weg. Je hebt geen API-sleutel nodig, want je meldt je bij het verbinden aan met je handelsregister.ai-account.
- Open de ChatGPT-plugin en voeg hem toe in ChatGPT.
- Meld je aan met je handelsregister.ai-account en bevestig de toegang.
- Stel je vraag, bijvoorbeeld „Wie leidt Hetzner Online GmbH en hoe heeft de omzet zich ontwikkeld?”
Claude, Cursor en andere MCP-clients
MCP, het Model Context Protocol, is een open standaard waarmee AI-agents tools en gegevensbronnen gebruiken. Elke client die via een URL met een MCP-server verbindt, kan onze server gebruiken.
| Wat | Waarde |
|---|---|
| Server-URL |
https://mcp.handelsregister.ai/mcp |
| Transport | Streamable HTTP |
| Aanmelden | OAuth met je account, API-sleutel in de header x-api-key of bearer-token in de header Authorization |
Claude
In Claude voeg je de MCP-server toe als aangepaste connector. Kies in de connectorinstellingen „Add custom connector”, voer een naam en de server-URL in en meld je aan met je handelsregister.ai-account. Zet de connector daarna in de chat aan onder „+” › „Connectors”.
In Team- en Enterprise-workspaces voegt een eigenaar de connector voor iedereen toe. Elk lid verbindt daarna zijn eigen handelsregister.ai-account.
Claude Code
In Claude Code voeg je de server toe met één commando. Met de header gebruikt Claude Code je API-sleutel.
claude mcp add --transport http handelsregister https://mcp.handelsregister.ai/mcp \ --header "x-api-key: JOUW_API_SLEUTEL"
Zonder de header meld je je in plaats daarvan aan in de browser: start een sessie en kies de server onder /mcp.
Cursor
Cursor leest MCP-servers uit .cursor/mcp.json in het project of uit ~/.cursor/mcp.json voor alle projecten. Veel andere clients gebruiken hetzelfde formaat.
{ "mcpServers": { "handelsregister": { "url": "https://mcp.handelsregister.ai/mcp", "headers": { "x-api-key": "JOUW_API_SLEUTEL" } } } }
Andere MCP-clients
Voer de server-URL in en stuur bij elke aanvraag je API-sleutel mee in de header x-api-key. Je kunt ook een bearer-token gebruiken in de header Authorization; Authenticatie laat zien hoe je er een aanmaakt.
Beschikbare tools
De MCP-server biedt tools voor je account, bedrijfsprofielen, personen, documenten, zoeken en Signals. Alle tools lezen alleen: ze maken niets aan en wijzigen geen instellingen. Ze kosten evenveel credits als dezelfde aanvraag aan de API.
De bedrijfstools accepteren in de parameter q een entity_id, een bedrijfsnaam of registerrechtbank met registernummer, bijvoorbeeld „Ansbach HRB 6089”. De entity_id uit een zoekopdracht is het betrouwbaarst. Bij de meeste bedrijfstools zet ai_search de AI-modus aan en realtime Realtime.
Account
| Tool | Wat hij levert | Credits |
|---|---|---|
| get_account_status | Plan, saldo, eerstvolgende vervaldatum van credits en de gegevens die je plan ontgrendelt. | gratis |
Bedrijfsprofiel
Elke bedrijfstool kost de basisprijs van het bedrijfsprofiel plus de prijs van zijn feature, net als fetch-organization. De feature wordt alleen berekend als die gegevens oplevert.
| Tool | Wat hij levert | Credits |
|---|---|---|
| get_company_overview | De basisgegevens: naam, status, rechtsvorm, register, adres, kapitaal, doel van de onderneming en branche. | 5 |
| get_company_snapshot | Basisgegevens, Financiële KPI’s en het huidige bestuur in één aanroep. | 5 + 1 + 2 |
| get_financials | Financiële KPI’s per boekjaar, zoals omzet, jaarresultaat en medewerkers. | 5 + 1 |
| get_balance_sheet | De balans met alle posten. | 5 + 3 |
| get_profit_and_loss | De winst-en-verliesrekening (W&V). | 5 + 3 |
| get_annual_financial_statements | Volledige tekst van jaarrekeningen als Markdown. | 5 + 5 |
| get_annual_financial_statements_html | Volledige tekst van jaarrekeningen als HTML. | 5 + 5 |
| get_related_persons | Het bestuur en andere ingeschreven personen, op verzoek ook voormalige. | 5 + 2 |
| get_shareholders | De aandeelhouders met hun belang. | 5 + 5 |
| get_ubos | De uiteindelijk belanghebbenden (UBO). | 5 + 10 |
| get_shareholdings | De deelnemingen van het bedrijf in andere bedrijven. | 5 + 5 |
| get_mergers_and_acquisitions | Fusies & overnames (M&A) en ondernemingsovereenkomsten. | 5 + 20 |
| get_publications | De historie van registerbekendmakingen. | 5 + 1 |
| get_insolvency_publications | Insolventiepublicaties. | 5 + 5 |
| get_news | Nieuws over het bedrijf van het web. | 5 + 10 |
| get_website_content | De inhoud van de bedrijfswebsite als Markdown. Deze tool gebruikt altijd de AI-modus. | 5 + 20 (AI-modus) |
| get_company_features | Meerdere features in één aanroep, met maar één basisprijs. | 5 + features |
Personen en documenten
| Tool | Wat hij levert | Credits |
|---|---|---|
| fetch_person | Het persoonsprofiel: functies, deelnemingen en loopbaan van een persoon, opgezocht op naam en een gerelateerd bedrijf. · vanaf Plus | 15, met deelnemingen + 5 |
| fetch_document | Een document uit het register: Aktueller Abdruck (AD, actueel uittreksel), Chronologischer Abdruck (CD, chronologisch uittreksel), Strukturierter Registerinhalt (SI, gestructureerde registerinhoud), Gesellschafterliste (aandeelhouderslijst) of statuten. | 15 |
Zoeken
De zoektools leveren tot 30 resultaten per pagina, elk met zijn entity_id. Daarmee haalt je agent vervolgens het bedrijfsprofiel op.
| Tool | Wat hij levert | Credits |
|---|---|---|
| search_organizations | Bedrijven vinden op naam of filters. | 1 per pagina |
| search_organizations_advanced | Zoeken met alle filters van de API en sortering, bijvoorbeeld op omzet of oprichtingsdatum. | 1 per pagina |
| find_companies_by_industry | Bedrijven in een branche, in woorden beschreven of als WZ-code. | 1 per pagina |
| find_companies_by_financials | Bedrijven op omzet, medewerkers, jaarresultaat, eigen vermogen en andere kengetallen. | 1 per pagina |
| find_companies_near | Bedrijven rond een locatie, dichtstbijzijnde eerst. | 1 per pagina |
| find_newly_registered_companies | Nieuw ingeschreven bedrijven in een periode. | 1 per pagina |
| find_recently_changed_companies | Bedrijven met recente wijzigingen, bijvoorbeeld in bestuur, statutaire zetel of kapitaal. | 1 per pagina |
| find_related_companies | Verbonden bedrijven via deelnemingen, functies, fusies of ondernemingsovereenkomsten. | 1 per pagina |
| find_companies_by_person | Bedrijven waarin een persoon een functie heeft. Zoeken op aandeelhouder kan met Pro en Max. | 1 per pagina |
| find_companies_by_ownership | Bedrijven op eigendomsstructuur, bijvoorbeeld door de eigenaar geleid of in familiebezit. · Pro, Max | 1 per pagina |
| find_companies_by_management | Bedrijven op leeftijd en omvang van het bestuur. · Pro, Max | 1 per pagina |
| find_companies_in_insolvency | Bedrijven in insolventieprocedure, op fase en periode. · Pro, Max | 1 per pagina |
| get_search_filter_reference | De toegestane waarden van de zoekfilters. | gratis |
| find_industry_codes | WZ-codes voor een in woorden beschreven branche, bijvoorbeeld „softwareontwikkeling”. | gratis |
Signals
De Signals-tools leveren wijzigingen in het register over alle bedrijven heen, tot 20 per pagina. Een pagina wordt ook berekend als ze leeg is.
| Tool | Wat hij levert | Credits |
|---|---|---|
| get_recent_new_registrations | Nieuwe inschrijvingen. | 20 per pagina |
| get_recent_management_changes | Bestuurswisselingen. | 20 per pagina |
| get_recent_capital_changes | Kapitaalwijzigingen. | 20 per pagina |
| get_recent_master_data_changes | Wijzigingen in basisgegevens zoals naam, statutaire zetel of adres. | 20 per pagina |
| get_recent_company_closures | Uitschrijvingen & ontbindingen. | 20 per pagina |
| get_recent_insolvency_events | Insolventies. · Pro, Max | 20 per pagina |
| get_recent_mergers_and_transformations | Omzettingen & M&A. · Max | 20 per pagina |
| get_recent_company_changes | Alle wijzigingen voor maximaal vijf specifieke bedrijven. | 20 per pagina |
| get_signal_details | Eén signaal met alle details. | 20 |
Kosten
Elke toolaanroep kost evenveel credits als dezelfde aanvraag aan de API. Er is geen aparte vergoeding voor MCP. De credits gaan af van het account waarmee je je hebt aangemeld of waar de API-sleutel bij hoort.
Dezelfde regels gelden als in de API: features zonder gegevens kosten niets, en een mislukte aanroep kost niets. De AI-modus wordt ook zonder match berekend, Realtime voor elke geslaagde live-opvraging. Elk resultaat vermeldt de berekende credits in meta.request_credit_cost en je saldo in meta.credits_remaining.
Ook de limieten zijn dezelfde als in de API, voor documenten bijvoorbeeld 5 aanvragen per minuut. Meer onder Afrekening en Limieten.