NACEBridge API & MCP

NACEBridge mapea EU NACE Rev 2.1 hasta las subclases nacionales de 5 dígitos usadas por 27 países de la UE, el Reino Unido y Suiza (CAE-Rev4 PT, NAF FR, WZ DE, SBI NL, …). Las cuatro utilidades web también están disponibles programáticamente:

• search — búsqueda por palabra clave global + local
• decode — expandir un código nacional a su jerarquía EU completa
• cousins — subclases equivalentes transfronterizas
• grid — pivot multipaís para una división NACE

Cada petición a /api/v1/* lleva una cabecera X-API-Key. Inicia sesión y genera claves en tu panel de claves API. Las claves se almacenan hasheadas — nunca guardamos el texto en claro.

X-API-Key: nb_live_XXXXXXXXXXXXXXXXXXXXXXXX

El endpoint MCP usa exactamente la misma cabecera, exactamente los mismos límites por nivel y exactamente el mismo registro de peticiones que la pasarela REST — la única diferencia es la URL (/mcp en vez de /api/v1/…) y el sobre JSON-RPC. El tráfico web anónimo está permitido para las utilidades de UI pero se limita suavemente con un contador de strikes por IP (ver Límites de peticiones).

Picos por encima del tope de ventana devuelven HTTP 429 con Retry-After.

Cinco recursos bajo https://nacebridge.dev/api/v1/*. Cada endpoint acepta GET con query params o POST con cuerpo JSON. Las respuestas son { ok, tier, data } con cabeceras X-RateLimit-* adjuntas.

# 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 habla la especificación MCP Streamable HTTP transport . Apunta cualquier cliente MCP a:

https://nacebridge.dev/mcp

POST JSON-RPC 2.0 con ambos content-types en 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): añadir como Connector personalizado con la misma URL — las herramientas search y fetch están expuestas para Deep Research.

Cursor: añadir a ~/.cursor/mcp.json con la misma URL.

Instrucciones drop-in que enseñan a tu asistente de IA cuándo y cómo llamar a NACEBridge. Descarga, instala en el asistente que prefieras, y la próxima vez que el usuario pegue un código NACE / CAE / NAF / WZ / SBI el asistente irá al servidor MCP en vez de adivinar.

Los tres referencian solo las URL públicas de MCP y REST. No contienen ninguna clave API — los usuarios aportan la suya desde el panel de claves 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"] });

El wrapper open source vive en public-wrappers/mcp/. Es un proxy httpx fino — cero datos locales — para que la pasarela privada siga siendo la fuente de verdad.

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

Publicamos un site map legible por máquina en /llms.txt y un índice más rico en /llms-full.txt para que los asistentes de IA se auto-onboarden. El bloque Ask-an-AI en la página de inicio entrega un chat nuevo a ChatGPT, Claude, Gemini, Grok o Perplexity — sembrado con un prompt NACEBridge que indica al asistente usar el servidor MCP en lugar de adivinar.

• 401 — X-API-Key ausente o inválido
• 402 — cuota de nivel agotada, upgrade requerido
• 422 — entrada falló validación Zod; la respuesta lleva detalles por campo
• 429 — límite de peticiones alcanzado, respetar Retry-After
• 5xx — incidente; los retries son seguros (todas las operaciones son de solo lectura)

Metadatos NACE Rev 2.1 © Unión Europea, reutilizados bajo la política de reutilización de la Comisión. Metadatos de subclases nacionales © respectivos institutos nacionales de estadística (INE, INSEE, DESTATIS, CBS, …). Las correspondencias NACEBridge, el esquema normalizado y los wrappers son distribuidos por TΣKSOMΛ Holding, Lda., construido por TΣKSOMΛ Technologies y propulsado por TΣKSOMΛ | MΛRKET INTΣLLIGENCE.