NACEBridge API & MCP

NACEBridge mappar EU NACE Rev 2.1 ner till de femsiffriga nationella underklasser som används av 27 EU-länder, Storbritannien och Schweiz (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). Alla fyra webbverktyg finns också programmässigt:

• search — global + lokal nyckelordssökning
• decode — expandera en nationell kod till hela dess EU-hierarki
• cousins — gränsöverskridande ekvivalenta underklasser
• grid — flerlands-pivot för en NACE-division

Varje anrop till /api/v1/* har en X-API-Key-header. Logga in och generera nycklar i din API-nyckel-panelen. Nycklar hashas i vila — vi lagrar aldrig klartexten.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

MCP-endpointen använder exakt samma header, exakt samma nivåbaserade anropsgränser och exakt samma anropslogg som REST-gatewayen — den enda skillnaden är URL:en (/mcp istället för /api/v1/…) och JSON-RPC-kuvertet. Anonym webbtrafik tillåts för UI-verktygen men mjukbegränsas med en IP-baserad räknare (se Anropsgränser).

Toppar över fönstergränsen returnerar HTTP 429 med Retry-After.

Fem resurser under https://nacebridge.dev/api/v1/*. Varje endpoint accepterar GET med query-parametrar eller POST med en JSON-body. Svar är { ok, tier, data } med X-RateLimit-*-headers bifogade.

# 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 talar MCP Streamable HTTP transport specifikationen. Peka valfri MCP-klient på:

https://nacebridge.dev/mcp

POST JSON-RPC 2.0 med båda innehållstyperna i 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): lägg till som en anpassad Connector med samma URL — search- och fetch-verktyg exponeras för Deep Research.

Cursor: lägg till samma URL i ~/.cursor/mcp.json.

Färdiga instruktioner som lär din AI-assistent när och hur den ska anropa NACEBridge. Ladda ner, installera i valfri assistent, och nästa gång användaren klistrar in en NACE / CAE / NAF / WZ / SBI-kod kommer assistenten att använda MCP-servern istället för att gissa.

Alla tre refererar endast till de offentliga MCP- och REST-URL:erna. De innehåller ingen API-nyckel — användare anger sin egen från API-nyckelpanelen.

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"] });

Open-source-wrappern finns i public-wrappers/mcp/. Den är en tunn httpx-proxy — noll lokala data — så den privata gatewayen förblir sanningskällan.

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

Vi publicerar en maskinläsbar webbplatskarta på /llms.txt och ett rikare index på /llms-full.txt så att AI-assistenter kan onboarda sig själva. Ask-an-AI-blocket på startsidan lämnar över en ny chatt till ChatGPT, Claude, Gemini, Grok eller Perplexity med en NACEBridge-prompt som säger åt assistenten att använda MCP-servern istället för att gissa.

• 401 — saknad eller ogiltig X-API-Key
• 402 — nivåkvoten är förbrukad, uppgradering krävs
• 422 — indata klarade inte Zod-validering; svaret innehåller fältdetaljer
• 429 — anropsgräns nådd, respektera Retry-After
• 5xx — incident; retries är säkra (alla operationer är read-only)

NACE Rev 2.1-metadata © Europeiska unionen, återanvänd enligt kommissionens återanvändningspolicy. Nationella underklassmetadata © respektive nationella statistikmyndigheter (INE, INSEE, DESTATIS, CBS, …). NACEBridge-mappningar, normaliserat schema och wrappers distribueras av TΣKSOMΛ Holding, Lda., byggd av TΣKSOMΛ Technologies och drivs av TΣKSOMΛ | MΛRKET INTΣLLIGENCE.