Beschikbaar in ChatGPT · MCP-server · NBB / BCSO

Belgische jaarrekeningen voor uw AI-assistent

Jaarrekeningen die bij de Nationale Bank van België zijn neergelegd, als gestructureerde JSON met de officiële rubriekcodes en labels in het Nederlands, Frans, Duits of Engels. Beschikbaar als app in ChatGPT, en als gewone MCP-server voor elke andere client.

Gratis beginnen Uw client verbinden

Geen kaart nodig en niets te installeren. Gratis tijdens de publieke alfa.

Tarieven

Gratis tijdens de publieke alfa: aanroepen worden geteld, nooit geweigerd. Een betalend plan volgt later — de prijs en de maandlimieten liggen nog niet vast, en er wordt nooit iets aangerekend zonder uw uitdrukkelijke inschrijving.

Verwittig mij bij de start

Hoe het werkt

Stap 1 Voeg het toe aan uw assistent Zoek Belgian Annual Accounts in de plugin-directory van ChatGPT en zet het aan.
Stap 2 Meld u aan De assistent stuurt u hierheen om u aan te melden met uw e-mailadres — geen wachtwoord te verzinnen en geen sleutel te kopiëren. Clients op de commandoregel gebruiken in de plaats een API-sleutel van uw accountpagina.
Stap 3 Vraag het "Hoe zag de balans van Colruyt eruit in 2023?" De assistent zoekt het ondernemingsnummer bij de naam, haalt de neerlegging op en leest ze voor.

Gebruikt u iets anders? Elke andere MCP-client neemt de server-URL https://nbb-mcp.be/mcp — uw accountpagina heeft een blok per client, met het commando of de configuratie om te plakken.

Acht tools, dat is de hele API

`search_company`

Zet een bedrijfsnaam om in het Belgische ondernemingsnummer (KBO/BCE), of geef de namen die bij een nummer geregistreerd staan.

`get_annual_accounts`

Haal de jaarrekening op die een bedrijf bij de NBB heeft neergelegd: balans, resultatenrekening, resultaatverwerking, sociale balans en toelichting, elke lijn met haar officiële rubriekcode en een vertaald label.

`check_xbrl_availability`

Som elke jaarrekening op die een bedrijf bij de NBB neerlegde en of ze machineleesbaar (XBRL) is of alleen als pdf bestaat — de jaren die get_annual_accounts kan leveren.

`get_company_activities`

Som elke NACE-activiteit op die een bedrijf op ondernemingsniveau geregistreerd heeft: code, nomenclatuurversie, classificatie en een leesbare omschrijving.

`get_registered_office`

Haal het adres van de maatschappelijke zetel van een bedrijf op als gestructureerde velden.

`list_establishments`

Som de vestigingseenheden op die een bedrijf momenteel operationeel heeft, elk met haar vestigingsnummer, startdatum en gestructureerd adres.

`list_nace_codes`

Doorblader de NACEBEL-activiteitennomenclatuur laag per laag, om de code te vinden die een activiteit zoals "bakkerij" omschrijft. Gratis: de enige tool die niet van uw quotum afgaat.

`find_companies_by_activity`

Zoek bedrijven op NACE-activiteitscode, postcode of gemeente — het omgekeerde van de tools per bedrijf. Minstens één van nace_code, zipcode of municipality is verplicht; worden er meerdere opgegeven, dan tellen ze allemaal mee, en een bedrijf komt in aanmerking zodra één van zijn adressen (maatschappelijke zetel of een vestigingseenheid) in het gebied ligt. Alleen bedrijven die nu actief zijn in het register komen terug.

Eén JSON-vorm voor elke neerlegging, in welke taxonomiegeneratie ze ook is ingediend: elke lijn draagt haar officiële rubriekcode (20/28, 9900), het vertaalde label en de cijfers van het huidige en het vorige boekjaar. Feiten die niet te koppelen zijn, worden geteld en komen terug in unmapped_facts wanneer je om detail: full vraagt, in plaats van te verdwijnen.

De volledige parametertabellen, de responstijden en de foutcodes staan in de documentatie.

Vragen

Wat is een MCP-server, en heb ik er een nodig?

MCP (Model Context Protocol) is de standaardmanier waarop een AI-assistent tools aanroept die elders staan. Gebruikt u ChatGPT, Claude, Claude Code of Codex CLI, dan kan uw client over HTTP verbinding maken met een MCP-server op afstand en die tools gebruiken terwijl hij u antwoordt. Dit is zo'n server: in ChatGPT zet u hem aan vanuit de app-directory, en elke andere client krijgt één keer een URL en een sleutel. Niets te installeren en niets te laten draaien.

Welke gegevens precies, en waar komen ze vandaan?

De jaarrekeningen zoals ze zijn neergelegd bij de Balanscentrale (BCSO) van de Nationale Bank van België, gelezen uit haar webdienst voor authentieke gegevens en niet van een website gescrapet. Het opzoeken op naam gebruikt het opendatabestand met benamingen van de KBO/BCE, zodat maatschappelijke namen, afkortingen en commerciële namen in elke taal naar hetzelfde ondernemingsnummer leiden.

Welke jaren zijn beschikbaar?

Neerleggingen bestaan ruwweg vanaf 1978, maar machineleesbare beginnen veel later: neerleggingen in de gestandaardiseerde modellen komen terug als gestructureerde gegevens, al de rest is een pdf. Recente jaren (ruwweg vanaf 2016) zijn bijna altijd gestructureerd; oudere zijn gemengd. check_xbrl_availability somt op wat een bedrijf neerlegde en wat daarvan machineleesbaar is. Bestaat een neerlegging alleen als pdf, dan zegt het antwoord dat met de foutcode pdf_fallback_required — het betalende plan zal die met een LLM lezen, vanaf de start.

Welke talen?

Nederlands, Frans, Duits en Engels. De cijfers zijn in alle vier identiek — alleen de labels verschillen, en die komen uit de labellinkbases van de Nationale Bank zelf en niet uit een machinevertaling. Ontbreekt een label in de gevraagde taal, dan valt het antwoord terug op de taal van de neerlegging zelf en vermeldt dat in meta.