Back to Browse

Douanecode MCP Server

Developer ToolsModerate5.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

EU customs code search (HS, NC8, TARIC): tariff classification and duty rates

About

EU customs code search (HS, NC8, TARIC): tariff classification and duty rates

Security Report

5.2
Moderate5.2Moderate Risk

This MCP server is well-designed with proper authentication, secure credential handling, and appropriate permissions for its stated purpose. The code demonstrates good security practices: API keys are read from environment variables only, all requests are properly authenticated, and error handling gracefully manages auth failures. Minor code quality observations (broad exception catching, lack of input length validation) are present but do not constitute security risks. Supply chain analysis found 5 known vulnerabilities in dependencies (0 critical, 5 high severity). Package verification found 1 issue.

5 files analyzed · 10 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

DouaneCode API key (Pro plan) — get one at https://douanecode.fr/compteRequired

Environment variable: DOUANECODE_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-courouge-douanecode-mcp": {
      "env": {
        "DOUANECODE_API_KEY": "your-douanecode-api-key-here"
      },
      "args": [
        "douanecode-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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.

Reviews

No reviews yet

Be the first to review this server!