# USA Logistics MCP

> A remote MCP server that lets any AI agent buy US shipping labels — USPS, UPS, FedEx and more — with automatic cheapest-rate selection, track parcels and refund unused labels via the EasyPost API. Stateless, bring-your-own API key, never stores anything. Free EasyPost test keys give zero-cost end-to-end labels.

- MCP endpoint (Streamable HTTP): https://logi-us.wishpool.app/mcp
- Credential header: x-easypost-api-key (your EasyPost API key). Prefix EZTK… = TEST (free, real USPS test labels end-to-end, nothing ships); EZAK… = production (buys real postage). Same server; the key prefix auto-selects the environment. No shared demo merchant — get a free test key at easypost.com -> API Keys.
- Flow: create_shipment (to_address + from_address + parcel; dimensions in inches, weight in ounces -> fetches rates, buys cheapest, returns label_url + tracking_code + price) -> open label_url to print -> query_tracking (status by tracking_code). refund_label refunds a label only if it was never used/scanned.

## Tools

- create_shipment: Buy a US shipping label. Required: to_name/to_street1/to_city/to_state/to_zip, from_name/from_street1/from_city/from_state/from_zip, weight (ounces). Parcel size via length+width+height (inches) or predefined_package. Optional carrier / service to restrict; default is the cheapest rate across all enabled carriers. Returns shipment_id, tracking_code, label_url, carrier, service and the rate amount (USD).
- query_tracking: Track by tracking_code (optional carrier hint). Status enum: unknown, pre_transit, in_transit, out_for_delivery, delivered, available_for_pickup, return_to_sender, failure, cancelled, error — 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 shipment_id (preferred) or tracking_code (+carrier, default USPS). refund_status: submitted (accepted, carrier processing), refunded, rejected (not eligible, e.g. already scanned), not_applicable. USPS: within 30 days of creation and only if never scanned.
- 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 EasyPost API key travels per-request in a header and is never stored; labels are generated and served by EasyPost/the carrier, never held here. Parcels flow sender <-> carrier <-> recipient directly. Privacy policy: https://logi-us.wishpool.app/privacy

## Sister servers

Taiwan CVS pickup + home delivery live 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.