# Germany Logistics MCP

> A remote MCP server that lets any AI agent buy Germany shipping labels — Deutsche Post parcels and more — with automatic cheapest-rate selection, track parcels and refund unused labels via the Shippo API. Deutsche Post runs on Shippo's master account, so no Deutsche Post 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-de.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: Deutsche Post parcels via the Shippo master account — an AI agent can print a Deutsche Post label with no Deutsche Post contract. The carrier parameter is open, so a merchant with its own carrier account on Shippo (Deutsche Post, DHL, 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 Germany 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). Bundesland/state is optional for German addresses. Optional carrier / service to restrict (e.g. Deutsche Post / Paket); default is the cheapest rate across all available carriers. 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 deutsche_post; 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-de.wishpool.app/privacy

## Sister servers

UK labels (Royal Mail) live in uk-logistics-mcp: https://logi-uk.wishpool.app/mcp . France labels (Mondial Relay) in france-logistics-mcp: https://logi-fr.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.