CustomsBridge TARIC Engine

io.github.Une-educationPublished by GitHub account Une-educationv1.0.0Updated Nov 2, 2026

Deterministic HS6/TARIC customs resolution engine and bilingual FTS5 nomenclature API (UNE Node 04).

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingFinanceBusiness & Commerce

Overview

AI-generated overview

Remote MCP server for EU customs work: searches TARIC nomenclature, resolves HS codes, and calculates duties, VAT and import restrictions.

What you can do
  • Search the EU TARIC nomenclature in English or French by keyword and get ranked commodity descriptions
  • Resolve an HS6 or TARIC code prefix into its tariff tree and official designation
  • Calculate EU Common Customs Tariff (MFN) duties and import VAT on a CIF value in EUR
  • Check mandatory import restrictions, required certificates and SAD document codes for a code and origin country
  • Compute anti-dumping duties and CBAM carbon obligations for steel, aluminium and sensitive goods
  • Provision a free sandbox API key with 50 credits for advanced CBAM and factory-specific duty codes
When to use it
Useful for procurement, freight forwarding and cross-border trade agents that need to classify goods, estimate landed cost, or check EU import compliance from a Chinese or other origin proforma. It suits quick lookups where a deterministic, tariff-based answer is preferred over general web search.
Requirements
A remote streamable HTTP endpoint; no local package or runtime is needed. No authentication, environment variables or headers are declared for the base tools. Network access to the hosted service is required.
Before you install
The server offers to provision a free sandbox API key with 50 credits, which may be a step toward paid or metered use; confirm terms before relying on it. Duty, VAT and CBAM figures are estimates for planning, not binding customs rulings, and should be verified against official sources before declarations or payments.

Installation

In SourceWeft

  1. Open CustomsBridge TARIC Engine in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Une-education%2Fcustoms-bridge/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "customsbridge-taric-engine": {
      "type": "http",
      "url": "https://customs.une.education/mcp.php"
    }
  }
}

README

CustomsBridge — AtoA Customs & TARIC Resolution Engine

[Smithery] [Node] [Latency]

High-throughput, deterministic customs classification, duty simulation, and import restriction engine built for autonomous procurement, freight forwarding, and cross-border trade agents.

Operated under the Unified Norms Engine (UNE) infrastructure.

🚀 Live Endpoints

  • Live Hub: https://customs.une.education
  • MCP Endpoint: https://customs.une.education/mcp.php
  • OpenAPI 3.1 Spec: https://customs.une.education/openapi.json
  • Agent Specification: https://customs.une.education/llms.txt

📦 Capabilities & MCP Tools

1. search_customs_nomenclature

Performs BM25 sub-5ms full-text search across 25,800+ official statutory commodity descriptions (English & French).

  • Parameters:
    • query (string, required): Commodity description or keyword (e.g. electric motors, accumulateurs lithium, drones).
    • limit (integer, optional): Maximum results (1-50, default 5).

2. resolve_hs_code

Traverses the customs tariff tree starting from an international 6-digit Harmonized System (HS6) pivot code or exact TARIC 10-digit code prefix.

  • Parameters:
    • code (string, required): 2 to 10-digit code prefix (e.g. 850440 for static converters/inverters).

3. calculate_customs_duties

Calculates official EU Common Customs Tariff (TDC/MFN) and import VAT (20%) on CIF value.

  • Parameters:
    • taric_code (string, required): 6-digit HS code or 10-digit TARIC code.
    • cif_value_eur (number, required): Declared CIF customs value in EUR.
    • origin_country (string, optional): 2-letter ISO country code (default CN).

4. check_import_restrictions

Checks mandatory EU regulatory restrictions, required certificates (CE, RoHS, CBAM, REACH, CHED), and official document codes for SAD customs declaration (Box 44).

  • Parameters:
    • taric_code (string, required): 6-digit HS or 10-digit TARIC code (e.g. 850440, 7208, 8541).
    • origin_country (string, optional): 2-letter ISO origin country code (default CN).

🌐 Sino-European HS6 Pivot

The 6-digit Harmonized System (HS6) is universally shared between China's GACC export nomenclature and the European Union's TARIC system. CustomsBridge uses HS6 as a deterministic cross-border pivot to resolve European import tariffs directly from Chinese commercial proformas.

🛠️ Architecture

  • Engine: Stateless PHP 8.1 CLI / JSON-RPC 2.0.
  • Database: SQLite 3 with FTS5 unicode61 tokenizer.
  • Data Source: European Commission DG TAXUD / TARIC consolidation.
  • State Proof: SHA-256 sealed cryptographic payload with eIDAS Art. 41 timestamping.

Source: README.md at commit 3739cfe

Tools

6

calculate_customs_duties

Calculates official EU customs duties (Common Customs Tariff / MFN) and import VAT for a given HS code and CIF customs value in EUR.

Parametershs_coderequiredorigin_countrycustoms_value_eurrequired

search_customs_nomenclature

Recherche textuelle bilingue (FR/EN) dans la nomenclature TARIC via indexation FTS5.

Parameterslanglimitqueryrequired

resolve_hs_code

Resout l arborescence hierarchique et la designation officielle d un code SH6 ou TARIC.

Parameterscodehs_code

check_import_restrictions

Checks mandatory EU import restrictions, document codes (CE, REACH, CBAM, CHED), and compliance directives.

Parameterstaric_coderequiredorigin_country

resolve_cbam_and_antidumping

Computes definitive EU anti-dumping duties and CBAM carbon financial obligations for steel, aluminium, and sensitive imports.

Parametersapi_keyhs_coderequiredweight_kgcif_value_eurrequiredorigin_country

provision_free_api_key

Provisions a free sandbox API key (50 credits) for agents to unlock advanced CBAM carbon calculations and factory-specific anti-dumping duty codes.

Parametersuse_casedeveloper_emailrequired

Version history

1
  1. v1.0.0LatestSep 27, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.