# France Logistics MCP

> A remote MCP server that lets any AI agent buy France shipping labels — Mondial Relay relay-point delivery and more — with automatic cheapest-rate selection, track parcels and refund unused labels via the Shippo 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.

- MCP endpoint (Streamable HTTP): https://logi-fr.wishpool.app/mcp
- Credential header: x-shippo-token (your Shippo API token). Prefix shippo_test_… = TEST (free, runs the full flow end-to-end, nothing ships); shippo_live_… = production (buys real labels). Same server; the token prefix auto-selects the environment. No shared demo merchant — get a free test token (no card) at apps.goshippo.com/join -> API.
- Recommended carrier: Mondial Relay relay-point (point relais) delivery via the Shippo master account — an AI agent can print a Mondial Relay label with no Mondial Relay contract. Mondial Relay is a relay-point network (parcels dropped at / collected from points relais). The carrier parameter is open, so a merchant with its own carrier account on Shippo (Mondial Relay, Colissimo, etc.) can select it instead.
- Flow: create_shipment (to_address + from_address + parcel; dimensions in centimetres, weight in grams -> fetches rates, buys cheapest, returns label_url + tracking_number + price in EUR) -> open label_url to print -> query_tracking (status by tracking_number + carrier). refund_label refunds a label only if it was never used/scanned.

## Tools

- create_shipment: Buy a France shipping label. Required: to_name/to_street1/to_city/to_zip, from_name/from_street1/from_city/from_zip, weight (grams by default; set mass_unit for kg/oz/lb). Parcel size via length+width+height (centimetres by default; set distance_unit for m/in/ft). région/state is optional for French addresses. Optional carrier / service to restrict (e.g. Mondial Relay / Point Relais); default is the cheapest rate across all available carriers. Mondial Relay is relay-point delivery. Returns shipment_id, transaction_id, tracking_number, label_url, carrier, service and the rate amount (EUR).
- query_tracking: Track by tracking_number plus carrier token (default mondial_relay; for TEST tokens use carrier=shippo with mock numbers SHIPPO_TRANSIT / SHIPPO_DELIVERED). Status enum: UNKNOWN, PRE_TRANSIT, TRANSIT, DELIVERED, RETURNED, FAILURE — each with a plain-English hint; non-terminal statuses include next_steps. Raw carrier scan details always included.
- refund_label: Refund an unused label by transaction_id (the id create_shipment returned). refund_status: QUEUED / PENDING (accepted, carrier processing), SUCCESS (money returned), ERROR (not eligible, e.g. already scanned). An already-shipped label cannot be refunded.
- Owner policy guardrails: x-agentpay-max-amount (hard cap), x-agentpay-approval-above (returns an unsigned draft for human review — the shipment/rates are prepared but no label is bought), x-agentpay-allowed-tools (tool allow-list) — set by the human owner in the MCP client config; the agent cannot relax them. The label price is gated before any purchase.

## Safety

Stateless translation layer. The Shippo API token travels per-request in a header and is never stored; labels are generated and served by Shippo/the carrier, never held here. Parcels flow sender <-> carrier <-> recipient directly. Privacy policy: https://logi-fr.wishpool.app/privacy

## Sister servers

UK labels (Royal Mail) live in uk-logistics-mcp: https://logi-uk.wishpool.app/mcp . Germany labels (Deutsche Post) in germany-logistics-mcp: https://logi-de.wishpool.app/mcp . Australia labels (Aramex) in australia-logistics-mcp: https://logi-au.wishpool.app/mcp . US labels (USPS/UPS/FedEx) in usa-logistics-mcp: https://logi-us.wishpool.app/mcp . Taiwan CVS pickup + home delivery in taiwan-logistics-mcp: https://logi-tw.wishpool.app/mcp . One family of stateless BYO local-commerce MCP servers: local payments in 81 countries (https://mcp.wishpool.app/llms.txt), plus electronic-invoice servers across nine countries including Mexico CFDI, Brazil NF-e, Chile DTE, Peru CPE and India GST.