NACEBridge API & MCP

NACEBridge bildet EU NACE Rev 2.1 bis hinunter zu den 5-stelligen nationalen Unterklassen ab, die in 27 EU-Staaten, dem Vereinigten Königreich und der Schweiz verwendet werden (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). Alle vier Web-Utilities sind auch programmatisch verfügbar:

• search — globale + lokale Stichwortsuche
• decode — einen nationalen Code zur vollständigen EU-Hierarchie expandieren
• cousins — grenzüberschreitend äquivalente Unterklassen
• grid — Mehrländer-Pivot für eine NACE-Abteilung

Jede Anfrage an /api/v1/* trägt einen X-API-Key-Header. Melden Sie sich an und erzeugen Sie Schlüssel in Ihrem API-Schlüssel-Dashboard. Schlüssel werden gehasht gespeichert — den Klartext speichern wir nie.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

Der MCP-Endpoint verwendet exakt denselben Header, exakt dieselben Rate Limits pro Stufe und exakt dasselbe Anfrageprotokoll wie das REST-Gateway — der einzige Unterschied ist die URL (/mcp statt /api/v1/…) und der JSON-RPC-Umschlag. Anonymer Web-Traffic ist für die UI-Utilities erlaubt, wird jedoch mit einem IP-Strike-Zähler weich begrenzt (siehe Rate Limits).

Spitzen über dem Fenster-Limit ergeben HTTP 429 mit Retry-After.

Fünf Ressourcen unter https://nacebridge.dev/api/v1/*. Jeder Endpoint akzeptiert GET mit Query-Parametern oder POST mit JSON-Body. Antworten haben die Form { ok, tier, data } mit X-RateLimit-* Headern.

# Decode a Portuguese CAE-Rev4 code
curl -s "https://nacebridge.dev/api/v1/decode?country_iso=PT&code=62010" \
  -H "X-API-Key: $NACEBRIDGE_API_KEY"

# Or POST JSON
curl -s "https://nacebridge.dev/api/v1/cousins" \
  -H "X-API-Key: $NACEBRIDGE_API_KEY" \
  -H "content-type: application/json" \
  -d '{"country_iso":"DE","code":"62.01.0"}'

NACEBridge spricht die MCP Streamable HTTP Transport Spezifikation. Richten Sie jeden MCP-Client auf:

https://nacebridge.dev/mcp

POST JSON-RPC 2.0 mit beiden Content-Types im Accept-Header:

POST /mcp HTTP/1.1
Content-Type: application/json
Accept: application/json, text/event-stream

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "nacebridge": {
      "url": "https://nacebridge.dev/mcp",
      "headers": { "X-API-Key": "nb_live_..." }
    }
  }
}

ChatGPT (Plus / Pro / Team): als benutzerdefinierten Connector mit derselben URL hinzufügen — search- und fetch-Tools sind für Deep Research verfügbar.

Cursor: in ~/.cursor/mcp.json mit derselben URL eintragen.

Drop-in-Anleitungen, die Ihrem KI-Assistenten beibringen, wann und wie NACEBridge aufzurufen ist. Herunterladen, im gewünschten Assistenten installieren — und beim nächsten NACE / CAE / NAF / WZ / SBI-Code greift der Assistent auf den MCP-Server statt zu raten.

Alle drei verweisen nur auf die öffentlichen MCP- und REST-URLs. Sie enthalten keinen API-Schlüssel — Nutzer liefern ihren eigenen aus dem API-Schlüssel-Dashboard.

npm i @nacebridge/sdk

import { NACEBridge } from "@nacebridge/sdk";
const nb = new NACEBridge({ apiKey: process.env.NACEBRIDGE_API_KEY });

const cousins = await nb.cousins({ country_iso: "NL", code: "6201" });
const grid    = await nb.grid({ division: "62", countries: ["PT","FR","DE","NL"] });

Der Open-Source-Wrapper liegt in public-wrappers/mcp/. Er ist ein schlanker httpx-Proxy — keinerlei lokale Daten —, damit das private Gateway die einzige Wahrheitsquelle bleibt.

pip install -e ./public-wrappers/mcp

# Then in your MCP client config:
{
  "mcpServers": {
    "nacebridge-local": {
      "command": "python",
      "args": ["-m", "nacebridge_mcp"],
      "env": {
        "NACEBRIDGE_API_KEY": "nb_live_...",
        "NACEBRIDGE_URL": "https://nacebridge.dev"
      }
    }
  }
}

Wir veröffentlichen eine maschinenlesbare Site-Map unter /llms.txt und einen reichhaltigeren Index unter /llms-full.txt, damit KI-Assistenten sich selbst einarbeiten können. Der Ask-an-AI-Block auf der Startseite öffnet einen frischen Chat in ChatGPT, Claude, Gemini, Grok oder Perplexity — vorbereitet mit einem NACEBridge-Prompt, der den Assistenten anweist, den MCP-Server zu nutzen statt zu raten.

• 401 — fehlender oder ungültiger X-API-Key
• 402 — Stufen-Kontingent erschöpft, Upgrade erforderlich
• 422 — Eingabe hat Zod-Validierung nicht bestanden; Antwort enthält Felddetails
• 429 — Rate Limit erreicht, Retry-After beachten
• 5xx — Störung; Wiederholungen sind sicher (alle Operationen sind nur lesend)

NACE-Rev-2.1-Metadaten © Europäische Union, weiterverwendet unter der Wiederverwendungsrichtlinie der Kommission. Nationale Unterklassen-Metadaten © der jeweiligen nationalen statistischen Ämter (INE, INSEE, DESTATIS, CBS, …). Die NACEBridge-Zuordnungen, das normalisierte Schema und die Wrapper werden vertrieben von TΣKSOMΛ Holding, Lda., entwickelt von TΣKSOMΛ Technologies und bereitgestellt von TΣKSOMΛ | MΛRKET INTΣLLIGENCE.