Gratis
€0
- 100 tool-aanroepen per maand
- Onbeperkt tijdens de alfa — het quotum wordt getoond, niet afgedwongen
- Alle vier de labeltalen
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. Één keer verbinden en uw assistent kan een Belgisch bedrijf op naam opzoeken.
Geen kaart nodig. Het gratis plan bevat 100 tool-aanroepen per maand.
Hoe het werkt
-
Stap 1
Vraag een sleutel aan
Meld u aan met uw e-mailadres — geen wachtwoord te verzinnen. Uw accountpagina geeft een API-sleutel die met
nbb_live_begint. -
Stap 2
Voeg de connector toe
Laat uw MCP-client naar
https://nbb-mcp.be/mcpwijzen en de sleutel als bearertoken meesturen — uw accountpagina loodst u door elke client. - 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.
Drie 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.
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, komen terug in unmapped_facts 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 Claude, ChatGPT, 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: u voegt één keer een URL en een sleutel toe, en uw assistent kan Belgische jaarrekeningen opzoeken. 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.