MCP-server voor Belgische ondernemingsdata

Met de MCP-server beantwoordt een agent vragen over Belgische ondernemingen vanuit het register, zonder dat u zelf een API-client of toollaag hoeft te bouwen.

Voeg hem toe aan uw client

Open in Claude Instellingen → Connectoren → Aangepaste connector toevoegen.
Vul https://mcp.otbstudio.ai/mcp in.
Meld u aan met uw OTB Studio-account. Daarvoor is een actief plan nodig.

U hoeft geen sleutel te kopiëren: de connector hoort bij uw organisatie, en u trekt hem in het dashboard in zoals een sleutel.

claude mcp add --transport http otb-studio https://mcp.otbstudio.ai/mcp \
  --header "Authorization: Bearer $OTB_KEY"

Toevoegen aan Cursor, met uw sleutel in de omgevingsvariabele OTB_KEY. Of voeg dezelfde server toe aan .cursor/mcp.json:

{
  "mcpServers": {
    "otb-studio": {
      "url": "https://mcp.otbstudio.ai/mcp",
      "headers": { "Authorization": "Bearer ${env:OTB_KEY}" }
    }
  }
}

Voeg toe aan .vscode/mcp.json. VS Code vraagt de sleutel één keer en bewaart hem als geheim:

{
  "inputs": [
    { "type": "promptString", "id": "otb-key", "description": "OTB Studio API key", "password": true }
  ],
  "servers": {
    "otb-studio": {
      "type": "http",
      "url": "https://mcp.otbstudio.ai/mcp",
      "headers": { "Authorization": "Bearer ${input:otb-key}" }
    }
  }
}

Met uw sleutel in de omgevingsvariabele OTB_KEY:

codex mcp add otb-studio --url https://mcp.otbstudio.ai/mcp --bearer-token-env-var OTB_KEY

Elke client die MCP over HTTP spreekt met een request-header:

{
  "mcpServers": {
    "otb-studio": {
      "type": "http",
      "url": "https://mcp.otbstudio.ai/mcp",
      "headers": { "Authorization": "Bearer otb_live_…" }
    }
  }
}

Vraag dan bijvoorbeeld: “Wie zijn de bestuurders van [een onderneming], en wie is eigenaar?” of “Toon het eigen vermogen en het resultaat van [een onderneming] over de laatste vijf jaar.”

Tools

Tool	Neemt	Geeft terug
`search_companies`	`query` (string, Nederlandse of Franse naam), `limit` (1 tot 25, standaard 10)	Gerangschikte resultaten: ondernemingsnummer, de naam die overeenkwam, werknemers (VTE), statuscode
`get_company`	`enterprise_number` (elke gangbare vorm: `BE0712345630`, `0712.345.630`, `0712345630`)	Eén profiel: namen, adres, activiteiten, codes, kerncijfers, beschikbaarheidsvlaggen
`get_company_ownership`	`enterprise_number`	Wie een belang heeft in de onderneming, en de belangen die zij in andere heeft
`get_company_financials`	`enterprise_number`, `years` (1 tot 20, standaard 10), `detail` (kasstroom- en balansposten)	De neergelegde cijfers, één rij per boekjaar
`get_company_people`	`enterprise_number`, `limit` (1 tot 200, standaard 50)	Bestuurders en andere mandaten, de huidige eerst
`search`, `fetch`	`query`; `id`	Dezelfde zoekopdracht en hetzelfde profiel, in de vorm die ChatGPT en deep research vereisen. Gebruik liever de benoemde tools waar de client u de keuze laat

De gebruikelijke weg is search_companies, dan get_company, en dan de tool voor eigendom, financiële gegevens of personen als de vraag die nodig heeft. Zoeken rangschikt op hoe goed de naam overeenkomt en op hoe groot de onderneming is, zodat een bekende naam eerst de operationele onderneming teruggeeft en niet een eenmansvennootschap met hetzelfde woord in haar naam. Een onderneming heeft een juridische, een commerciële, een Nederlandse en een Franse naam; de naam die overeenkwam, is de naam die terugkomt. De toolbeschrijvingen vertellen het model wat het niet uit een schema kan afleiden: een naam moet eerst een nummer worden, twee velden zijn codes zonder label, en de cijfers komen uit één neerlegging waarvan de afsluitdatum vaak niet 31 december is. Zie De data lezen.

Verbinding


Endpoint	`POST https://mcp.otbstudio.ai/mcp`
Interface	Streamable HTTP, stateless: geen sessie, geen `Mcp-Session-Id`
Authenticatie	`Authorization: Bearer otb_live_…`, of aanmelden via OAuth vanuit Claude
Dienst	Dezelfde dienst en data als de REST API

Zeg uw agent wanneer hij hem gebruikt

Een coding agent gebruikt een server die hij kent. Plak dit in AGENTS.md, CLAUDE.md of .cursor/rules:

## Belgian company data

For any question about a Belgian company (KBO/BCE enterprise number, directors,
shareholders, filed annual accounts), use the `otb-studio` MCP server. Find the
enterprise number with `search_companies` first, then call `get_company`,
`get_company_people`, `get_company_ownership` or `get_company_financials`.
REST API and field reference: https://docs.otbstudio.ai/llms.txt

Wilt u dat een agent ook deze documentatie doorzoekt, voeg dan https://docs.otbstudio.ai/mcp toe. Die server doorzoekt alleen de documentatie; de ondernemingsdata staan op https://mcp.otbstudio.ai/mcp.

Fouten en limieten

Niets gevonden is een gewoon resultaat met een zin, geen fout. Een naam die nergens mee overeenkomt, of een ondernemingsnummer dat niemand heeft, geeft een toolresultaat terug met een note die zegt wat er gebeurde en wat u in de plaats kunt proberen. Een model kan iets doen met een zin, niet met een 404. Een leeg creditsaldo werkt net zo: een gewoon resultaat waarvan de note zegt dat er credits moeten worden bijgekocht.

Twee fouten komen binnen als HTTP-status, nog voor er een tool draait, en uw client handelt ze af: 401 voor een ontbrekende of geweigerde sleutel (met een WWW-Authenticate-header), en 429 rate_limited met Retry-After wanneer de organisatie boven haar snelheidslimiet zit. Elk MCP-verzoek telt mee voor die limiet, ook tools/list. Een aanroep die niet binnen 15 seconden beantwoord kan worden, komt terug als toolfout die zegt dat u het opnieuw moet proberen. MCP-antwoorden melden hun kost in credits niet. Het verbruik staat in het dashboard.

Test het manueel

curl -s -X POST https://mcp.otbstudio.ai/mcp \
  -H "Authorization: Bearer $OTB_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# The answer arrives as one text/event-stream message. Strip the
# "data: " prefix before parsing it.

Aan de slag

Verbinden

Data

In productie

MCP-server voor Belgische ondernemingsdata

Voeg hem toe aan uw client

Tools

Verbinding

Zeg uw agent wanneer hij hem gebruikt

Fouten en limieten

Test het manueel

​Voeg hem toe aan uw client

​Tools

​Verbinding

​Zeg uw agent wanneer hij hem gebruikt

​Fouten en limieten

​Test het manueel

Voeg hem toe aan uw client

Tools

Verbinding

Zeg uw agent wanneer hij hem gebruikt

Fouten en limieten

Test het manueel