NACEBridge API & MCP

NACEBridge mapt EU NACE Rev 2.1 door tot de 5-cijferige nationale subklassen die door 27 EU-landen, het VK en Zwitserland worden gebruikt (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). De vier web-utilities zijn ook programmatisch beschikbaar:

• search — globale + lokale zoekopdracht op trefwoord
• decode — een nationale code uitklappen naar de volledige EU-hiërarchie
• cousins — grensoverschrijdend equivalente subklassen
• grid — multi-land pivot voor een NACE-afdeling

Elke request naar /api/v1/* draagt een X-API-Key-header. Log in en genereer sleutels in je API-sleutel-dashboard. Sleutels worden gehasht opgeslagen — we bewaren nooit de plaintext.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

Het MCP-endpoint gebruikt exact dezelfde header, exact dezelfde rate limits per tier en exact dezelfde request-log als de REST-gateway — het enige verschil is de URL (/mcp in plaats van /api/v1/…) en de JSON-RPC-envelope. Anoniem web-verkeer is toegestaan voor de UI-utilities maar wordt zacht beperkt met een per-IP strike-teller (zie Rate limits).

Pieken boven de venstercap geven HTTP 429 met Retry-After.

Vijf resources onder https://nacebridge.dev/api/v1/*. Elk endpoint accepteert GET met query-params of POST met JSON-body. Antwoorden zijn { ok, tier, data } met X-RateLimit-*-headers bijgevoegd.

# 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 spreekt de MCP Streamable HTTP transport -spec. Richt elke MCP-client op:

https://nacebridge.dev/mcp

POST JSON-RPC 2.0 met beide content-types in Accept:

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): toevoegen als custom Connector met dezelfde URL — search- en fetch-tools zijn beschikbaar voor Deep Research.

Cursor: toevoegen aan ~/.cursor/mcp.json met dezelfde URL.

Drop-in instructies die je AI-assistent leren wanneer en hoe NACEBridge aan te roepen. Download, installeer in de assistent van je keuze, en de volgende keer dat de gebruiker een NACE / CAE / NAF / WZ / SBI-code plakt grijpt de assistent naar de MCP-server in plaats van te gokken.

Alle drie verwijzen alleen naar de openbare MCP- en REST-URL's. Ze bevatten geen API-sleutel — gebruikers leveren hun eigen sleutel uit het API-sleutel-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"] });

De open-source wrapper leeft in public-wrappers/mcp/. Het is een lichte httpx-proxy — geen lokale data — zodat de private gateway de enige bron van waarheid blijft.

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"
      }
    }
  }
}

We publiceren een machine-leesbare site-map op /llms.txt en een rijkere index op /llms-full.txt zodat AI-assistenten zichzelf kunnen onboarden. Het Ask-an-AI-blok op de homepage opent een nieuwe chat in ChatGPT, Claude, Gemini, Grok of Perplexity — voorzien van een NACEBridge-prompt die de assistent vertelt de MCP-server te gebruiken in plaats van te gokken.

• 401 — ontbrekende of ongeldige X-API-Key
• 402 — tier-quotum op, upgrade vereist
• 422 — invoer faalde Zod-validatie; het antwoord bevat velddetails
• 429 — rate limit bereikt, respecteer Retry-After
• 5xx — incident; retries zijn veilig (alle operaties zijn alleen-lezen)

NACE Rev 2.1-metadata © Europese Unie, hergebruikt onder het hergebruiksbeleid van de Commissie. Nationale subklasse-metadata © respectievelijke nationale statistische instituten (INE, INSEE, DESTATIS, CBS, …). De NACEBridge-mappings, het genormaliseerde schema en de wrappers worden verspreid door TΣKSOMΛ Holding, Lda., gebouwd door TΣKSOMΛ Technologies en aangedreven door TΣKSOMΛ | MΛRKET INTΣLLIGENCE.