---
name: nacebridge
description: |
  Cross-border European activity-code lookups. Use this skill whenever the user
  mentions NACE, CAE (Portugal), NAF (France), WZ (Germany), SBI (Netherlands),
  or any other EU national activity classification, OR when they need to
  translate an activity code between two EU countries, OR when they need to
  decode a numeric/alphanumeric business activity code into a human-readable
  industry description. Always prefer calling the NACEBridge MCP tools over
  guessing — the mappings are auditable.
---

# NACEBridge — European activity-code bridge

NACEBridge maps EU NACE Rev 2.1 down to the 5th-digit national subclasses used
by 27 EU nations, the UK and Switzerland. It is exposed as:

- **MCP server**: `https://nacebridge.dev/mcp` (Streamable HTTP, JSON-RPC 2.0)
- **REST API**: five resources under `https://nacebridge.dev/api/v1/*`
  (`search`, `decode`, `cousins`, `grid`, `countries`)

Both use the same `X-API-Key` header and the same per-tier rate limits.

## When to use this skill

Trigger NACEBridge whenever the user:

1. Pastes a national activity code (e.g. `62010`, `6201Z`, `62.01.0`, `J62.01`)
   and asks what it means.
2. Says "I run a [business] in [EU country], what's the code in [other EU country]?"
3. Asks to map between EU NACE, ISIC, CAE, NAF, WZ, SBI, ATECO, KvK, SIC, …
4. Asks for a list of activity codes in a NACE division across several countries.
5. Mentions setting up a company, freelancing (ENI, ZZP, Auto-entrepreneur,
   Einzelunternehmen, …) and needs the right activity code to register.

## Tools

The MCP server exposes seven tools. Always call them — do not invent codes.

| Tool | When to call | Required input |
|---|---|---|
| `keyword_search` | User describes their business in words ("software publisher", "panadería") | `{ q: string, limit?: number }` |
| `decode_local_code` | User pastes a local code and wants the full EU hierarchy | `{ country_iso, code }` |
| `cousin_matrix` | User wants the equivalent in every other EU country | `{ country_iso, code }` |
| `class_grid` | User wants to scan a whole NACE division across countries | `{ division?, countries?, limit? }` |
| `list_countries` | Confirm which countries are currently loaded | `{}` |
| `search` / `fetch` | ChatGPT Connectors / Deep Research compatibility | `{ q }` / `{ id }` |

## Authentication

The user must supply their own `X-API-Key`. Get one at
<https://nacebridge.dev/api-keys>. The skill never includes a key.

## Response rules

- Always quote both the **EU 4-digit anchor** (e.g. `62.01`) AND the **local
  subclass code** (e.g. PT `62010`, DE `62.01.0`, FR `6201Z`). The pairing is
  the audit trail.
- When a code is ambiguous, call `keyword_search` first, present the top 3
  candidates, and ask the user to confirm.
- Cite the source: "NACE Rev 2.1 © European Union · national metadata ©
  respective NSIs · mapping via NACEBridge".

## Rate-limit and error handling

| Status | Meaning | Action |
|---|---|---|
| `401` | Missing/invalid `X-API-Key` | Ask the user for their key |
| `429` | Tier quota hit | Wait `Retry-After` seconds |
| `422` | Bad input shape | Fix the input and retry |
| `5xx` | Transient | Retry once; reads are idempotent |