Douanecode Mcp

io.github.CourougePublished by GitHub account Courougev0.1.2Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinance Business & Commerce

Server details

Identifier: io.github.Courouge/douanecode-mcp
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account Courouge for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.Courouge%2Fdouanecode-mcp.svg)](https://sourceweft.com/mcp/io.github.Courouge%2Fdouanecode-mcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local MCP server that lets an assistant look up EU and French customs codes (HS, NC8, TARIC), duty rates and recent tariff changes via douanecode.fr.

What you can do: Search customs codes by describing a product in natural language and get candidate codes back, with labels, hierarchy and units for each code. Retrieve customs duties and measures for a code, optionally for a given country of origin. Check recent tariff changes for regulatory watch.
When to use it: Useful when classifying goods for import or export, estimating duty costs, or keeping an eye on EU tariff updates, for example in logistics, ERP or e-commerce workflows.
Requirements: Runs as a local process, typically launched with uvx from the PyPI package douanecode-mcp. Requires a DouaneCode API key in the DOUANECODE_API_KEY environment variable, which needs a paid Pro plan. Network access to the douanecode.fr backend.

Before you install

Every call needs the DOUANECODE_API_KEY secret, and the Pro plan is billed at 99 EUR per year. Queries are sent to the douanecode.fr backend, which applies authentication, per-plan rate limiting and analytics. The hosted mode is described as incomplete regarding reading the key from client headers.

Installation

In SourceWeft

Open Douanecode Mcp in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

Outil	Description
`search_customs_code`	Description produit en langage naturel → codes candidats
`get_code_details`	Détail d'un code (libellés, hiérarchie, unités)
`get_duty_rates`	Droits de douane + mesures, option pays d'origine
`get_tariff_changes`	Changements tarifaires récents (veille)

Usage local (Claude Desktop / Claude Code / Cursor)

json

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

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

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

Dev

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)

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

Source: README.md at commit f491f93

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.1.2LatestSep 16, 2026

Score

50% 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 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts