mcpField
D
douanecode-mcp

douanecode-mcp

Local
github.com/CourougeLegal & Government0Updated 14w ago
Repository

About douanecode-mcp

douanecode-mcp is an MCP server for AI agents that need to search EU and French HS, NC8 and TARIC customs codes. It provides code details, duty rates and recent tariff changes through the DouaneCode API, with a Pro API key required.

Key features

  1. 01Natural-language customs code search
  2. 02HS, NC8 and TARIC code details
  3. 03Duty rates and measures by origin
  4. 04Recent tariff change monitoring

Use cases

  1. 01Classifying a product for customs
  2. 02Checking duties for a country of origin
  3. 03Reviewing recent tariff changes

MCP support

Exposes four tools to MCP clients: search_customs_code, get_code_details, get_duty_rates and get_tariff_changes. Calls require a DouaneCode API key.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "courouge-douanecode": {
      "command": "uvx",
      "args": [
        "douanecode-mcp"
      ],
      "env": {
        "DOUANECODE_API_KEY": "<DOUANECODE_API_KEY>"
      }
    }
  }
}
Run commanduvx douanecode-mcp
Environment variables to set
DOUANECODE_API_KEYSecretDouaneCode API key (Pro plan) — get one at https://douanecode.fr/compte

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypidouanecode-mcp0.1.2

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

douanecode-mcp

mcp-name: io.github.Courouge/douanecode-mcp

EU/French customs code search (HS, NC8, TARIC) for AI agents — natural-language tariff classification, duty rates and regulatory watch, powered by douanecode.fr. Requires a DouaneCode API key (Pro plan).

Serveur MCP officiel de DouaneCode.fr : donne aux agents IA (Claude, Cursor, agents logistique/ERP/e-commerce) un accès outillé à la recherche de codes douaniers HS/NC8/TARIC, aux taux de droits et à la veille tarifaire.

Modèle économique : chaque appel exige une clé API DouaneCode (plan Pro, 99 €/an — tier Cabinet à venir). Le serveur est un wrapper mince ; le backend existant applique authentification, rate limiting par plan et analytics.

Outils exposés

OutilDescription
search_customs_codeDescription produit en langage naturel → codes candidats
get_code_detailsDétail d'un code (libellés, hiérarchie, unités)
get_duty_ratesDroits de douane + mesures, option pays d'origine
get_tariff_changesChangements tarifaires récents (veille)

Usage local (Claude Desktop / Claude Code / Cursor)

{
  "mcpServers": {
    "douanecode": {
      "command": "uvx",
      "args": ["douanecode-mcp"],
      "env": { "DOUANECODE_API_KEY": "dc_..." }
    }
  }
}

Clé API : https://douanecode.fr/compte (plan Pro requis).

Dev

pip install -e ".[dev]"
pytest

Déploiement hébergé

Dockerfile + deploy/k8s.yaml (mcp.douanecode.fr, transport streamable-http). Voir la note dans le manifeste : le mode hébergé nécessite de lire la clé API depuis les headers client (TODO) ; le mode stdio publié sur PyPI fonctionne sans cela.

Distribution (go-to-market)

  1. Publier sur PyPI (douanecode-mcp) → utilisable via uvx immédiatement.
  2. Lister sur les annuaires MCP (mcp.so, Smithery, PulseMCP, Glama) + registre officiel registry.modelcontextprotocol.io.
  3. Page https://douanecode.fr/mcp expliquant l'installation → conversion Pro.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.