> ## Documentation Index
> Fetch the complete documentation index at: https://docs.otbstudio.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP-server voor Belgische ondernemingsdata

> Verbind Claude, Claude Code, Cursor of ChatGPT met het Belgische ondernemingsregister via de MCP-server van OTB Studio: zeven tools voor zoeken, profielen, eigendom, jaarrekeningen en bestuurders.

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

**Claude**

1. Open in Claude **Instellingen → Connectoren → Aangepaste connector toevoegen**.
2. Vul `https://mcp.otbstudio.ai/mcp` in.
3. 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 Code**

```bash theme={null}
claude mcp add --transport http otb-studio https://mcp.otbstudio.ai/mcp \
  --header "Authorization: Bearer $OTB_KEY"
```

**Cursor**

[Toevoegen aan Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=otb-studio\&config=eyJ1cmwiOiJodHRwczovL21jcC5vdGJzdHVkaW8uYWkvbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7ZW52Ok9UQl9LRVl9In19), met uw sleutel in de omgevingsvariabele `OTB_KEY`. Of voeg dezelfde server toe aan `.cursor/mcp.json`:

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

**VS Code**

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

```json theme={null}
{
  "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}" }
    }
  }
}
```

**Codex**

Met uw sleutel in de omgevingsvariabele `OTB_KEY`:

```bash theme={null}
codex mcp add otb-studio --url https://mcp.otbstudio.ai/mcp --bearer-token-env-var OTB_KEY
```

**Andere agents**

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

```json theme={null}
{
  "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](/nl/reading-the-data.md).

## 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`:

```markdown theme={null}
## 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

> [!NOTE]
>
> **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](/nl/limits.md) 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

```bash theme={null}
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.
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.