CodeClassify MCP server

Give any MCP-compatible AI assistant (Claude Desktop, Cursor, and others) the ability to validate, convert, classify and screen product & business codes — straight from a conversation, computed from official public standards (no AI guessing).

Wraps the CodeClassify API. Tools included:

| Tool | What it does | |------|--------------| | detect_identifier | "What is this code, and is it valid?" — auto-detects type + checks the check digit | | repair_identifier | Fix a code that fails validation — checksum-proven correction | | validate_iban | IBAN validity + bank name (17 countries) | | validate_barcode | GTIN/UPC/EAN check digits (up to 100) | | check_vat | Live EU VAT check via official VIES (GB via UK HMRC; Northern Ireland XI via VIES) with registered name | | screen_sanctions | Name screening against 7 lists (OFAC/EU/UK/UN/Canada/Switzerland/Australia). A hit is a possible fuzzy name match to review, not a legal/compliance determination; absence is not confirmation of non-listing. | | sanctions_divergence | Cross-regime comparison: which of the 7 lists carry a matching name and which do not (present/possible/absent), with scores + references. Facts only, not a determination. | | bank_enrich | Resolve a bank by BIC/LEI/name → GLEIF identity + accounting-consolidation group (Level-2, not ownership/50%-rule) + a dated, scoped name-match against the 7 lists. | | lookup_bic | SWIFT/BIC structure + registered bank name where listed (21-country directory) | | decode_vin | VIN check digit + make/model/year (NHTSA vPIC) | | validate_lei | LEI (ISO 17442) check digits | | search_hs_code | Product description → HS customs codes | | lookup_unlocode | UN/LOCODE → location name + country |

Setup

1. Get a free API key (250 calls/month, no card) at https://code-classify.com/api/.
2. Add the server to your MCP client. For Claude Desktop, edit claude_desktop_config.json:

{
  "mcpServers": {
    "codeclassify": {
      "command": "npx",
      "args": ["-y", "codeclassify-mcp"],
      "env": { "CODECLASSIFY_API_KEY": "ccl_your_key_here" }
    }
  }
}

3. Restart the client. Ask it things like "is DE89370400440532013000 a valid IBAN and which bank?", "screen 'Vladimir Putin' against sanctions lists", or "what HS code is a cotton t-shirt?".

Notes

• Beyond the free 250 calls/month the API is pay-per-use (€0.01/call) or a plan — see https://code-classify.com/api/.
• Every answer is deterministic and computed from official registers/standards; nothing you send is stored.
• Env vars: CODECLASSIFY_API_KEY (required for full functionality), CODECLASSIFY_BASE_URL (optional, defaults to https://api.code-classify.com).

MIT licensed. Not affiliated with S.W.I.F.T. SCRL, OFAC, or the European Commission — reference data from official public sources.