France Logistics MCP 🇫🇷 — How can my AI agent buy a Mondial Relay / French shipping label?
Use it in 60 seconds
Paste this into your MCP client config (Claude Desktop, Cursor, Windsurf, or any MCP-capable agent):
{
"mcpServers": {
"france-logistics": {
"type": "http",
"url": "https://logi-fr.wishpool.app/mcp"
}
}
}
Nothing to install. Credentials, when you need them, travel as HTTP headers on each request and are never stored — see the threat model.
Or run it yourself
Would you rather not send production credentials to a server you do not control? Deploy this identical code to your own account and point your agent at your own URL:
git clone https://github.com/junter1989k-ai/france-logistics-mcp && cd france-logistics-mcp && npx vercel --prod
MIT-licensed. Self-hosting removes us from the picture entirely, at no cost and with no loss of function.
Remote MCP server that lets any AI agent buy France shipping labels (étiquettes d'expédition) — Mondial Relay relay-point delivery and more — with automatic cheapest-rate selection, track parcels, and refund unused labels via the Shippo shipping API. Mondial Relay runs on Shippo's master account, so no Mondial Relay contract or merchant courier account is needed. Stateless, bring-your-own API token, never stores anything. Free Shippo test tokens give zero-cost end-to-end labels.
Live endpoint: https://logi-fr.wishpool.app/mcp · Registry: app.wishpool/france-logistics-mcp
Quick start
{
"mcpServers": {
"france-logistics": {
"type": "http",
"url": "https://logi-fr.wishpool.app/mcp",
"headers": {
"x-shippo-token": "shippo_test_your_test_or_shippo_live_prod_token"
}
}
}
}
No shared demo — but test tokens are free. Shippo issues free TEST tokens (prefix shippo_test_…) that run the full flow end-to-end at no cost: sign up with no card at apps.goshippo.com/join → API. Production tokens (prefix shippo_live_…) buy real labels. The same server auto-selects the environment from the token prefix.
Mondial Relay without a Mondial Relay contract
Mondial Relay runs on Shippo's master carrier account, so an AI agent can print a Mondial Relay label with no Mondial Relay contract and no merchant courier account — just a free Shippo token. Mondial Relay is a relay-point (point relais) delivery network — parcels are dropped at and collected from relay points. The carrier parameter stays open, so a merchant with its own carrier account on Shippo (Mondial Relay, Colissimo, etc.) can select it instead.
| Tool | What it does |
|---|
create_shipment | Buy a France label. to_* + from_* address fields (région/state optional), parcel weight (grams by default, required) and length/width/height (centimetres by default). Optional carrier/service restrict the choice (e.g. Mondial Relay / Point Relais) — default is the cheapest rate across all available carriers. Mondial Relay is relay-point delivery. Fetches rates, buys the chosen rate, returns shipment_id, transaction_id, tracking_number, printable label_url, carrier, service and the rate (EUR). |
query_tracking | Track by tracking_number + carrier token (default mondial_relay; use shippo with SHIPPO_TRANSIT/SHIPPO_DELIVERED for TEST tokens). Returns status from the Shippo enum — UNKNOWN / PRE_TRANSIT / TRANSIT / DELIVERED / RETURNED / FAILURE — plus a plain-English hint; non-terminal statuses carry next_steps. Raw carrier scans always included. |
refund_label | Refund an unused label by transaction_id. Returns refund_status: QUEUED / PENDING / SUCCESS / ERROR. Only labels never scanned by the carrier are eligible — an already-shipped label cannot be refunded. |
Owner policy guardrails ride optional headers (x-agentpay-max-amount, x-agentpay-approval-above, x-agentpay-allowed-tools) — set by the human owner in client config; the agent cannot relax them. The label price is gated before any purchase: approval-above returns an unsigned draft with the shipment/rates prepared but no label bought.
Develop
node test/serve.js
node test/e2e.js
How it talks to Shippo
create_shipment is two server-to-server REST calls: POST /shipments/ (to/from address + parcel → rates[]) then POST /transactions/ (chosen rate object_id → label_url + tracking_number). query_tracking is GET /tracks/{carrier}/{tracking_number}. refund_label is POST /refunds/ (by transaction id). Auth is the header Authorization: ShippoToken <token>; the token prefix (shippo_test_… / shippo_live_…) selects test vs production on the same base URL https://api.goshippo.com.
Safety
Pure stateless translation layer. The label is generated and served by Shippo/the carrier; the Shippo API token travels per-request in a header, nothing is stored. Parcels flow sender ↔ carrier ↔ recipient directly. Privacy policy.
Sister servers
UK labels (Royal Mail) live in uk-logistics-mcp; Germany (Deutsche Post) in germany-logistics-mcp; Australia (Aramex) in australia-logistics-mcp; US labels (USPS/UPS/FedEx) in usa-logistics-mcp; Taiwan CVS pickup + home delivery in taiwan-logistics-mcp. One family of stateless BYO local-commerce MCP servers: local payments in 81 countries at mcp.wishpool.app, plus electronic-invoice servers across nine countries including Mexico CFDI, Brazil NF-e, Chile DTE, Peru CPE and India GST.
MIT licensed.