NACEBridge API & MCP

NACEBridge fait correspondre EU NACE Rev 2.1 jusqu'aux sous-classes nationales à 5 chiffres utilisées par 27 États membres de l'UE, le Royaume-Uni et la Suisse (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). Les quatre utilitaires web sont aussi disponibles programmatiquement :

• search — recherche par mots-clés globale + locale
• decode — déployer un code national vers sa hiérarchie EU complète
• cousins — sous-classes équivalentes transfrontalières
• grid — pivot multi-pays pour une division NACE

Chaque requête vers /api/v1/* porte un header X-API-Key. Connectez-vous et générez vos clés dans votre tableau de bord des clés API. Les clés sont hachées au repos — nous ne stockons jamais le texte clair.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

L'endpoint MCP utilise exactement le même header, exactement les mêmes limites de débit par palier et exactement le même journal de requêtes que la passerelle REST — la seule différence est l'URL (/mcp au lieu de /api/v1/…) et l'enveloppe JSON-RPC. Le trafic web anonyme est autorisé pour les utilitaires UI mais est limité en douceur via un compteur de tentatives par IP (voir Limites de débit).

Les pics au-delà du plafond de la fenêtre renvoient HTTP 429 avec Retry-After.

Cinq ressources sous https://nacebridge.dev/api/v1/*. Chaque endpoint accepte GET avec query params ou POST avec corps JSON. Les réponses sont { ok, tier, data } avec les headers X-RateLimit-* attachés.

# 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 parle la spécification MCP Streamable HTTP transport . Pointez n'importe quel client MCP vers :

https://nacebridge.dev/mcp

POST JSON-RPC 2.0 avec les deux content-types dans 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) : à ajouter comme Connector personnalisé avec la même URL — les outils search et fetch sont exposés pour Deep Research.

Cursor : à ajouter à ~/.cursor/mcp.json avec la même URL.

Instructions clé-en-main qui apprennent à votre assistant IA quand et comment appeler NACEBridge. Téléchargez, installez dans l'assistant de votre choix, et la prochaine fois qu'un utilisateur colle un code NACE / CAE / NAF / WZ / SBI, l'assistant ira vers le serveur MCP plutôt que de deviner.

Les trois ne référencent que les URL MCP et REST publiques. Ils ne contiennent aucune clé API — les utilisateurs fournissent la leur depuis le tableau de bord des clés API.

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

Le wrapper open source vit dans public-wrappers/mcp/. C'est un proxy httpx léger — zéro donnée locale — afin que la passerelle privée reste la source de vérité.

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

Nous publions une site-map lisible par machine à /llms.txt et un index plus riche à /llms-full.txt pour que les assistants IA s'auto-onboardent. Le bloc Ask-an-AI sur la page d'accueil ouvre un chat frais avec ChatGPT, Claude, Gemini, Grok ou Perplexity — amorcé avec un prompt NACEBridge qui dit à l'assistant d'utiliser le serveur MCP plutôt que de deviner.

• 401 — X-API-Key manquant ou invalide
• 402 — quota du palier épuisé, upgrade requis
• 422 — entrée n'a pas passé la validation Zod ; la réponse contient les détails par champ
• 429 — limite de débit atteinte, respecter Retry-After
• 5xx — incident ; les retries sont sûrs (toutes les opérations sont en lecture seule)

Métadonnées NACE Rev 2.1 © Union européenne, réutilisées sous la politique de réutilisation de la Commission. Métadonnées des sous-classes nationales © instituts statistiques nationaux respectifs (INE, INSEE, DESTATIS, CBS, …). Les correspondances NACEBridge, le schéma normalisé et les wrappers sont distribués par TΣKSOMΛ Holding, Lda., construit par TΣKSOMΛ Technologies et propulsé par TΣKSOMΛ | MΛRKET INTΣLLIGENCE.