# Global Logistics MCP

> A remote MCP server that lets any AI agent buy shipping labels worldwide via AfterShip Shipping (Postmen) — UPS, USPS, FedEx, DHL, Ninja Van, J&T and more — using the MERCHANT's OWN bound carrier accounts. Quote rates, create labels, cancel unused labels. Stateless, bring-your-own API key, never stores anything. The free sandbox generates real labels at zero cost.

- MCP endpoint (Streamable HTTP): https://logi-global.wishpool.app/mcp
- Credential header: x-aftership-key (your AfterShip API key; forwarded upstream as as-api-key). Register free, no approval, at admin.postmen.com / AfterShip -> Shipping, and bind your own carrier accounts there.
- Environment header: x-aftership-env = sandbox (DEFAULT — real labels at zero cost) or production (buys real labels on your carrier contract). Same key both.
- Aggregation model: this server owns NO carrier accounts. AfterShip is an aggregation layer; the merchant binds their OWN carrier accounts (their contracts/rates) and passes shipper_account_id per call. This is how an agent reaches carriers that do NOT issue self-serve keys (J&T, Ninja Van, Aramex): via the merchant's AfterShip-bound account.
- Flow: quote_rates (to_address + from_address, ISO alpha-3 countries + parcel weight/optional dimensions -> service_type list with total_charge) -> create_label (pass a service_type + same shipper_account_id -> label_url + tracking_number) -> cancel_label voids an unused label.

## Tools

- quote_rates: Compare live rates across the carriers bound to a merchant AfterShip shipper account. Required: shipper_account_id (the MERCHANT's own carrier account), to_name/to_street1/to_city/to_country, from_name/from_street1/from_city/from_country (countries ISO 3166-1 alpha-3), weight_value. Parcel size via width+height+depth (+dimension_unit) optional. Optional items[] for international customs. Returns rates[] with service_type, service_name, total_charge {amount, currency}, delivery_date, transit_time. Read-only, buys nothing.
- create_label: Buy a label for a chosen service_type through the merchant's shipper account. Required: same shipment fields + service_type (from quote_rates). Optional paper_size, is_document, customs_purpose. The server re-quotes the exact charge and applies owner policy guardrails BEFORE buying; over the approval threshold it returns an unsigned draft and buys nothing. Returns label_id, status, tracking_number, label_url, label_file_type, rate. Sandbox env generates real labels at zero cost.
- cancel_label: Void a label by label_id. Returns cancel_status: cancelled | pending (carrier still processing) | failed. Voidability depends on the carrier; an already-used label may not be cancellable. Idempotent.
- query_tracking: NOT SUPPORTED. AfterShip's Shipping (Postmen) API has no tracking endpoint; tracking is a separate product (AfterShip Tracking API, https://www.aftership.com/docs/tracking). Returns a structured not_supported result (never errors) pointing there. Use the tracking_number from create_label with the carrier or the Tracking API.
- Owner policy guardrails: x-agentpay-max-amount (hard cap), x-agentpay-approval-above (returns an unsigned draft for human review — the rate is quoted 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 AfterShip API key travels per-request in a header and is never stored; labels are generated and served by AfterShip/the carrier, never held here. Parcels flow sender <-> carrier <-> recipient directly. Privacy policy: https://logi-global.wishpool.app/privacy

## Sister servers

US domestic labels via EasyPost: https://logi-us.wishpool.app/mcp . Taiwan CVS pickup + home delivery: 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.