app.wishpool/global-logistics-mcp MCP Server

This MCP server provides global shipping labels for AI agents via AfterShip, using your own carrier accounts. It is available as an HTTP MCP endpoint (https://logi-global.wishpool.app/mcp) and is intended to be configured in an MCP-capable client.

🛠️ Key Features

Generates global shipping labels through AfterShip
Uses your own carrier accounts
Tool set size: 4 tools
Topics: aftership, ai-agent, aramex, claude, global, logistics, mcp, mcp-server, shipping, wishpool

🚀 Use Cases

Request shipping labels from an AI agent for global logistics workflows
Integrate label creation into Claude or other MCP-capable agents

⚡ Developer Benefits

“Nothing to install” for hosted use
Credentials, when needed, are sent as HTTP headers on each request and are never stored
Includes a referenced trust/threat model at https://mcp.wishpool.app/trust

⚠️ Limitations

To avoid sharing production credentials, you must run it yourself (self-deploy option mentioned but not detailed)

Global Logistics MCP

Use it in 60 seconds

Paste this into your MCP client config (Claude Desktop, Cursor, Windsurf, or any MCP-capable agent):

json

{
  "mcpServers": {
    "global-logistics": {
      "type": "http",
      "url": "https://logi-global.wishpool.app/mcp"
    }
  }
}

Nothing to install. Credentials, when you need them, travel as HTTP headers on each request and are never stored — see the threat model.

Or run it yourself

Would you rather not send production credentials to a server you do not control? Deploy this identical code to your own account and point your agent at your own URL:

bash

git clone https://github.com/junter1989k-ai/global-logistics-mcp && cd global-logistics-mcp && npx vercel --prod

MIT-licensed. Self-hosting removes us from the picture entirely, at no cost and with no loss of function.

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. Stateless, bring-your-own API key, never stored.

Endpoint: https://logi-global.wishpool.app/mcp (MCP Streamable HTTP, stateless JSON)
Credential header: x-aftership-key (your AfterShip key; forwarded upstream as as-api-key)
Environment header: x-aftership-env = sandbox (default — real labels at zero cost) or production

The aggregation model (the honest core)

This server owns no carrier accounts. AfterShip is an aggregation layer: the merchant binds their own carrier accounts (their contracts and rates) inside AfterShip (admin.postmen.com) and passes that shipper_account_id on each call. This is exactly how an agent reaches carriers that do not issue self-serve API keys — J&T, Ninja Van, Aramex — the curve-around is the merchant's AfterShip-bound account. The sandbox can be tested with a fake shipper account at zero cost.

Tools & capability matrix

Tool	AfterShip endpoint	Supported	Notes
`quote_rates`	`POST /postmen/v3/rates`	✅ yes	Compare live rates across the carriers on `shipper_account_id`. Read-only, buys nothing. Returns `service_type` + `total_charge`.
`create_label`	`POST /postmen/v3/labels` (pre-quoted via `/rates`)	✅ yes	Buy a chosen `service_type`. Re-quotes the exact charge and applies owner policy guardrails before buying. Returns `label_url` + `tracking_number`.
`cancel_label`	`POST /postmen/v3/cancel-labels`	✅ yes	Void an unused label by `label_id`. `cancel_status`: cancelled / pending / failed. Idempotent.
`query_tracking`	—	❌ not supported	The Shipping (Postmen) API has no tracking endpoint. Tracking is a separate product: the AfterShip Tracking API. Returns a structured `not_supported` result (never errors).

Addresses use ISO 3166-1 alpha-3 country codes (USA, GBR, JPN). Weight and dimension are {value, unit} (unit kg|lb|oz|g and cm|in|m).

Owner policy guardrails

Set by the human owner in the MCP client config; the agent cannot relax them. The label charge is gated before any purchase.

x-agentpay-max-amount — hard cap; over it, POLICY_BLOCKED.
x-agentpay-approval-above — over it, returns an unsigned draft (rate quoted, no label bought).
x-agentpay-allowed-tools — tool allow-list.

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.

Develop

bash

npm run dev    # local server on http://localhost:3242
npm test       # e2e: protocol + validation + units + fake-key real 401 fingerprint

The e2e suite includes a live probe: a fake key really hits sandbox-api.aftership.com and must receive the native 401 "The API key is invalid." fingerprint (proving the endpoint is alive).

Sister servers

US domestic labels via EasyPost — usa-logistics-mcp · Taiwan CVS pickup & home delivery — taiwan-logistics-mcp · local payments in 81 countries — mcp.wishpool.app · electronic-invoice servers across nine countries (Mexico CFDI, Brazil NF-e, Chile DTE, Peru CPE, India GST).

MIT.

shipper_account_id	string	required	The MERCHANT'S AfterShip shipper-account id — the carrier account (UPS/FedEx/DHL/Ninja Van...) THEY bound in AfterShip, with their own contract & rates. Not owned by this server. List them via AfterShip / admin.postmen.com shipper accounts.
to_name	string	required	Recipient contact full name.
to_company	string	optional	Optional Recipient company name.
to_street1	string	required	Recipient street address line 1.
to_street2	string	optional	Optional Recipient street address line 2.
to_city	string	required	Recipient city.
to_state	string	optional	Optional Recipient state / province / region.
to_postal_code	string	optional	Recipient postal / ZIP code (required by most carriers).
to_country	string	required	Recipient country as an ISO 3166-1 ALPHA-3 code (3 letters, e.g. USA, GBR, JPN, SGP, HKG). Required.
to_phone	string	optional	Optional Recipient phone (some carriers/services require it).
to_email	string	optional	Optional Recipient email.
to_type	string	optional	Optional address type: "residential" or "business" (default residential).
from_name	string	required	Sender contact full name.
from_company	string	optional	Optional Sender company name.
from_street1	string	required	Sender street address line 1.
from_street2	string	optional	Optional Sender street address line 2.
from_city	string	required	Sender city.
from_state	string	optional	Optional Sender state / province / region.
from_postal_code	string	optional	Sender postal / ZIP code (required by most carriers).
from_country	string	required	Sender country as an ISO 3166-1 ALPHA-3 code (3 letters, e.g. USA, GBR, JPN, SGP, HKG). Required.
from_phone	string	optional	Optional Sender phone (some carriers/services require it).
from_email	string	optional	Optional Sender email.
from_type	string	optional	Optional address type: "residential" or "business" (default residential).
weight_value	number	required	Parcel weight value. Required. Pair with weight_unit.
weight_unit	string	optional	Weight unit: kg \| lb \| oz \| g. Default kg.
width	number	optional	Parcel width. Provide width+height+depth together (with dimension_unit), or omit all three.
height	number	optional	Parcel height.
depth	number	optional	Parcel depth / length.
dimension_unit	string	optional	Dimension unit: cm \| in \| m. Default cm.
box_type	string	optional	Parcel box type. Default "custom" (uses your dimensions). Some carriers accept named flat-rate boxes.
parcel_description	string	optional	Optional human description of the parcel contents.
items	array	optional	Optional line items for customs (required for most INTERNATIONAL shipments). Each: {description, quantity, price_amount, price_currency, origin_country (alpha-3), weight_value, weight_unit, sku, hs_code}.
is_document	boolean	optional	Optional: true if the shipment is documents only (no customs value). Default false.

shipper_account_id	string	required	The MERCHANT'S AfterShip shipper-account id (same one used in quote_rates).
service_type	string	required	The carrier service to buy — a service_type value returned by quote_rates (e.g. "fedex_international_priority").
paper_size	string	optional	Optional label paper size: default \| 4x6 \| a4 \| a5 ... Default "default".
is_document	boolean	optional	Optional: true for documents-only shipments. Default false.
customs_purpose	string	optional	Optional customs purpose for international parcels: gift \| merchandise \| sample \| return \| repair. Sent as customs.purpose when provided.
to_name	string	required	Recipient contact full name.
to_company	string	optional	Optional Recipient company name.
to_street1	string	required	Recipient street address line 1.
to_street2	string	optional	Optional Recipient street address line 2.
to_city	string	required	Recipient city.
to_state	string	optional	Optional Recipient state / province / region.
to_postal_code	string	optional	Recipient postal / ZIP code (required by most carriers).
to_country	string	required	Recipient country as an ISO 3166-1 ALPHA-3 code (3 letters, e.g. USA, GBR, JPN, SGP, HKG). Required.
to_phone	string	optional	Optional Recipient phone (some carriers/services require it).
to_email	string	optional	Optional Recipient email.
to_type	string	optional	Optional address type: "residential" or "business" (default residential).
from_name	string	required	Sender contact full name.
from_company	string	optional	Optional Sender company name.
from_street1	string	required	Sender street address line 1.
from_street2	string	optional	Optional Sender street address line 2.
from_city	string	required	Sender city.
from_state	string	optional	Optional Sender state / province / region.
from_postal_code	string	optional	Sender postal / ZIP code (required by most carriers).
from_country	string	required	Sender country as an ISO 3166-1 ALPHA-3 code (3 letters, e.g. USA, GBR, JPN, SGP, HKG). Required.
from_phone	string	optional	Optional Sender phone (some carriers/services require it).
from_email	string	optional	Optional Sender email.
from_type	string	optional	Optional address type: "residential" or "business" (default residential).
weight_value	number	required	Parcel weight value. Required. Pair with weight_unit.
weight_unit	string	optional	Weight unit: kg \| lb \| oz \| g. Default kg.
width	number	optional	Parcel width. Provide width+height+depth together (with dimension_unit), or omit all three.
height	number	optional	Parcel height.
depth	number	optional	Parcel depth / length.
dimension_unit	string	optional	Dimension unit: cm \| in \| m. Default cm.
box_type	string	optional	Parcel box type. Default "custom" (uses your dimensions). Some carriers accept named flat-rate boxes.
parcel_description	string	optional	Optional human description of the parcel contents.
items	array	optional	Optional line items for customs (required for most INTERNATIONAL shipments). Each: {description, quantity, price_amount, price_currency, origin_country (alpha-3), weight_value, weight_unit, sku, hs_code}.

Global Logistics (AfterShip labels with your own carrier accounts)

app.wishpool/global-logistics-mcp MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

quote_rates

create_label

cancel_label

query_tracking