NBB MCP-Server für belgische Jahresabschlüsse

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → NBB Central Balance Sheet Office klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

NBB Central Balance Sheet Office

Belgische Jahresabschlüsse aus der Bilanzzentrale der Belgischen Nationalbank (Webservice für authentische Daten): alle Jahresabschlüsse, die ein Unternehmen hinterlegt hat, anhand der Unternehmensnummer auflisten, die Referenzdaten einer Hinterlegung lesen und deren Abschlussdaten als JSON-XBRL oder XBRL oder das veröffentlichte PDF abrufen. Nur lesend.

Einrichtung

Die Einrichtung dauert nur wenige Minuten, sobald die NBB deine Abonnements freigegeben hat. Du brauchst ein Abonnement der Webservices der NBB CBSO und ein Konto im CBSO-Entwicklerportal mit einem freigegebenen Abonnement des Produkts NBB CBSO Web Services - Authentic Data.

1. Abonniere die CBSO-Webservices über das Anmeldeformular auf nbb.be (Central Balance Sheet Office, Produkte). Die NBB schickt dir eine CLIENT_ID für deinen technischen Benutzer; der Connector selbst braucht nur den Subscription Key aus den nächsten Schritten.
2. Registriere dich im Entwicklerportal developer.cbso.nbb.be, öffne Products und abonniere NBB CBSO Web Services - Authentic Data. Die NBB gibt die Anfrage frei.
3. Öffne im Portal dein Profile und kopiere den Primary Key des Authentic-Data-Abonnements in NBB_CBSO_SUBSCRIPTION_KEY (der Secondary Key geht auch; nur Buchstaben und Ziffern). Der Connector sendet ihn im Header NBB-CBSO-Subscription-Key.
4. Installiere den Connector und prüfe die Verbindung mit nbb_cbso_list_annual_accounts für die Unternehmensnummer 0203201340, die NBB selbst.

Cloud und Self-Hosting funktionieren gleich: Der Connector braucht nur den Subscription Key, sonst ist nichts einzurichten.

Unternehmens- und Referenznummern: Die Unternehmensnummer ist die 10-stellige Nummer in der Zentralen Datenbank der Unternehmen (KBO/BCE), ohne Punkte und ohne das Präfix BE: 0203201340 für BE 0203.201.340. Jede Hinterlegung hat eine eigene Referenznummer wie 2023-00123456, im Feld ReferenceNumber der Liste. year ist das Jahr, in dem das Geschäftsjahr endet, und darf nicht nach dem laufenden Jahr liegen.

Berichtigungen ersetzen die erste Hinterlegung: Zu einem Geschäftsjahr kann es eine erste Hinterlegung und eine Berichtigung geben (DepositType). Nimm die neueste Hinterlegung eines Geschäftsjahres und prüfe, welchen Zeitraum die Zahlen abdecken.

Zahlen nur für standardisierte Abschlüsse: nbb_cbso_get_annual_account_data liefert standardmäßig JSON-XBRL, alternativ XBRL, mit den Rubrikcodes des belgischen Schemas: etwa 10/15 Eigenkapital, 70 Umsatz, 9904 Gewinn oder Verlust des Geschäftsjahres und 9087 durchschnittliche Zahl der Arbeitnehmer in Vollzeitäquivalenten. Nicht standardisierte Abschlüsse gibt es nur als PDF; nbb_cbso_get_annual_account_pdf funktioniert für beide.

Angehängte Dateien: JSON-XBRL und XBRL können als angehängte Datei statt als Text kommen, das PDF kommt immer so. Große Hinterlegungen können das Anhangslimit von 10 MB überschreiten.

Request-IDs: Jeder Aufruf trägt eine X-Request-Id, eine UUID der Version 4 zur Nachverfolgung. Die Tools setzen eine ein; mit request_id gibst du eine eigene mit.

Häufige Fehler: Die NBB antwortet mit Problem-JSON (title, status, violations). 400 heißt, dass die Unternehmens- oder Referenznummer falsch aufgebaut ist oder das Jahr in der Zukunft liegt, 401 ein fehlender oder falscher Subscription Key, 403 ein Key, dessen Abonnement das Produkt Authentic Data nicht abdeckt oder noch nicht freigegeben ist, 404, dass nichts gefunden wurde, und 429 zu viele Aufrufe.

Nicht enthalten: Archiv, Extrakte (tägliche Pakete als ZIP) und die Produkte mit aufbereiteten Daten (improved data) der NBB brauchen eigene Abonnements und sind hier nicht verfügbar. Von der Veröffentlichung befreite Unternehmen haben keine öffentlichen Dokumente.

Was der Connector liest: die Jahresabschlüsse, die belgische Unternehmen und Vereinigungen bei der Bilanzzentrale hinterlegt haben und die die NBB angenommen hat. Pro Hinterlegung: Hinterlegungsdatum, Beginn und Ende des Geschäftsjahres, Modell (vollständig, verkürzt, Mikro oder ein Modell für Vereinigungen), Art der Hinterlegung, Sprache und Währung sowie Name, Adresse, Rechtsform, Rechtslage, Tätigkeitscode und Datum der Generalversammlung des Unternehmens. Dazu die Abschlussdaten selbst (Bilanz, Gewinn- und Verlustrechnung, Anhang und Sozialbilanz) als JSON-XBRL oder XBRL und den veröffentlichten Jahresabschluss als PDF.

Nur lesend: Alle vier Tools lesen nur. Bei der NBB wird nichts hinterlegt, berichtigt oder geändert.

Voraussetzungen: NBB_CBSO_SUBSCRIPTION_KEY

Connector lokal installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Öffne http://localhost:3000/connectors/store, wähle NBB Central Balance Sheet Office und trage die unter Voraussetzungen aufgelisteten Variablen ein.

Verfügbare Tools

Beispiel-Prompts

• „Liste alle Jahresabschlüsse auf, die das Unternehmen 0203.201.340 hinterlegt hat, mit Geschäftsjahr, Hinterlegungsdatum und Modell.“
• „Wie hoch waren Eigenkapital, Umsatz und Gewinn oder Verlust im neuesten Jahresabschluss des Unternehmens 0203201340, und welches Geschäftsjahr deckt er ab?“
• „Welche Rechtsform, Adresse und welchen Tätigkeitscode zeigt die neueste Hinterlegung, und wann war die Generalversammlung?“
• „Wie hat sich die durchschnittliche Zahl der Arbeitnehmer in Vollzeitäquivalenten in den letzten drei Jahresabschlüssen dieses Unternehmens entwickelt?“
• „Hol mir das veröffentlichte PDF des neuesten Jahresabschlusses des Unternehmens.“

Nächste Schritte

• Mit Claude verbinden
• Mit ChatGPT verbinden