# Australia Logistics MCP

> A remote MCP server that lets any AI agent buy Australia shipping labels — Aramex Australia parcels and more — with automatic cheapest-rate selection, track parcels and refund unused labels via the Shippo API. Aramex runs on Shippo's master account, so no Aramex 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-au.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: Aramex Australia parcels via the Shippo master account — an AI agent can print an Aramex label with no Aramex contract. The carrier parameter is open, so a merchant with its own carrier account on Shippo (Aramex, Australia Post, 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 AUD) -> 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 an Australia 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). state is optional for Australian addresses. Optional carrier / service to restrict (e.g. Aramex / Parcel); default is the cheapest rate across all available carriers. Returns shipment_id, transaction_id, tracking_number, label_url, carrier, service and the rate amount (AUD).
- query_tracking: Track by tracking_number plus carrier token (default aramex; 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-au.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 . France labels (Mondial Relay) in france-logistics-mcp: https://logi-fr.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.