Global Logistics (AfterShip labels with your own carrier accounts)

Official4 toolsLive

by junter1989k-ai · JavaScript

Global shipping labels for AI agents via AfterShip with your own carrier accounts.

Topics

aftershipai-agentaramexclaudegloballogisticsmcpmcp-servershippingwishpool

Captured live from the server via tools/list.

quote_rates

Compare live shipping rates across the carriers bound to a merchant AfterShip shipper account (UPS / USPS / FedEx / DHL / Ninja Van / J&T and more). IMPORTANT: shipper_account_id is the MERCHANT'S OWN carrier account (their own contract/rates), which they bound inside AfterShip / admin.postmen.com — this server never owns carrier accounts. Pass a to/from address and a parcel (weight + optional dimensions); returns a list of available service_type values with each total_charge (amount + currency), delivery_date and transit_time. Feed the service_type you want into create_label. Bring-your-own key via header x-aftership-key; x-aftership-env sandbox (default, free) or production. This call never buys anything.

Parameters33

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.

Raw schema

{
  "type": "object",
  "properties": {
    "shipper_account_id": {
      "type": "string",
      "description": "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": {
      "type": "string",
      "description": "Recipient contact full name."
    },
    "to_company": {
      "type": "string",
      "description": "Optional Recipient company name."
    },
    "to_street1": {
      "type": "string",
      "description": "Recipient street address line 1."
    },
    "to_street2": {
      "type": "string",
      "description": "Optional Recipient street address line 2."
    },
    "to_city": {
      "type": "string",
      "description": "Recipient city."
    },
    "to_state": {
      "type": "string",
      "description": "Optional Recipient state / province / region."
    },
    "to_postal_code": {
      "type": "string",
      "description": "Recipient postal / ZIP code (required by most carriers)."
    },
    "to_country": {
      "type": "string",
      "description": "Recipient country as an ISO 3166-1 ALPHA-3 code (3 letters, e.g. USA, GBR, JPN, SGP, HKG). Required."
    },
    "to_phone": {
      "type": "string",
      "description": "Optional Recipient phone (some carriers/services require it)."
    },
    "to_email": {
      "type": "string",
      "description": "Optional Recipient email."
    },
    "to_type": {
      "type": "string",
      "description": "Optional address type: \"residential\" or \"business\" (default residential)."
    },
    "from_name": {
      "type": "string",
      "description": "Sender contact full name."
    },
    "from_company": {
      "type": "string",
      "description": "Optional Sender company name."
    },
    "from_street1": {
      "type": "string",
      "description": "Sender street address line 1."
    },
    "from_street2": {
      "type": "string",
      "description": "Optional Sender street address line 2."
    },
    "from_city": {
      "type": "string",
      "description": "Sender city."
    },
    "from_state": {
      "type": "string",
      "description": "Optional Sender state / province / region."
    },
    "from_postal_code": {
      "type": "string",
      "description": "Sender postal / ZIP code (required by most carriers)."
    },
    "from_country": {
      "type": "string",
      "description": "Sender country as an ISO 3166-1 ALPHA-3 code (3 letters, e.g. USA, GBR, JPN, SGP, HKG). Required."
    },
    "from_phone": {
      "type": "string",
      "description": "Optional Sender phone (some carriers/services require it)."
    },
    "from_email": {
      "type": "string",
      "description": "Optional Sender email."
    },
    "from_type": {
      "type": "string",
      "description": "Optional address type: \"residential\" or \"business\" (default residential)."
    },
    "weight_value": {
      "type": "number",
      "description": "Parcel weight value. Required. Pair with weight_unit."
    },
    "weight_unit": {
      "type": "string",
      "description": "Weight unit: kg | lb | oz | g. Default kg."
    },
    "width": {
      "type": "number",
      "description": "Parcel width. Provide width+height+depth together (with dimension_unit), or omit all three."
    },
    "height": {
      "type": "number",
      "description": "Parcel height."
    },
    "depth": {
      "type": "number",
      "description": "Parcel depth / length."
    },
    "dimension_unit": {
      "type": "string",
      "description": "Dimension unit: cm | in | m. Default cm."
    },
    "box_type": {
      "type": "string",
      "description": "Parcel box type. Default \"custom\" (uses your dimensions). Some carriers accept named flat-rate boxes."
    },
    "parcel_description": {
      "type": "string",
      "description": "Optional human description of the parcel contents."
    },
    "items": {
      "type": "array",
      "description": "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}.",
      "items": {
        "type": "object",
        "properties": {
          "description": {
            "type": "string"
          },
          "quantity": {
            "type": "number"
          },
          "price_amount": {
            "type": "number"
          },
          "price_currency": {
            "type": "string"
          },
          "origin_country": {
            "type": "string",
            "description": "ISO 3166-1 alpha-3."
          },
          "weight_value": {
            "type": "number"
          },
          "weight_unit": {
            "type": "string"
          },
          "sku": {
            "type": "string"
          },
          "hs_code": {
            "type": "string"
          }
        }
      }
    },
    "is_document": {
      "type": "boolean",
      "description": "Optional: true if the shipment is documents only (no customs value). Default false."
    }
  },
  "required": [
    "shipper_account_id",
    "to_name",
    "to_street1",
    "to_city",
    "to_country",
    "from_name",
    "from_street1",
    "from_city",
    "from_country",
    "weight_value"
  ]
}

create_label

Buy a shipping label for a chosen service_type through the merchant's AfterShip shipper account, and return the printable label file url + tracking_number. First call quote_rates to see available service_type values, then pass that service_type here with the SAME shipper_account_id, addresses and parcel. Before purchasing, this server re-quotes the exact charge and applies the owner policy guardrails (x-agentpay-max-amount / x-agentpay-approval-above) — over the approval threshold returns an unsigned draft and buys nothing. Default env is sandbox (x-aftership-env), which generates real labels at ZERO cost; send x-aftership-env: production to buy real postage. The cost lands on the merchant's own carrier contract, not this server.

Parameters36

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}.

Raw schema

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

cancel_label

Cancel / void a shipping label created via create_label, by its label_id. If the label was never used, the carrier voids it so the merchant is not charged (voidability and windows depend on the carrier). Returns cancel_status: cancelled, pending (carrier still processing) or failed. Idempotent — cancelling an already-cancelled label is safe.

Parameters1

label_id

string

required

The label_id returned by create_label (AfterShip label id).

Raw schema

{
  "type": "object",
  "properties": {
    "label_id": {
      "type": "string",
      "description": "The label_id returned by create_label (AfterShip label id)."
    }
  },
  "required": [
    "label_id"
  ]
}

query_tracking

NOT SUPPORTED by this server. AfterShip's Shipping (Postmen) API — which powers this server's rate/label/cancel tools — has no parcel-tracking endpoint. Live parcel tracking is a SEPARATE AfterShip product: the AfterShip Tracking API (https://www.aftership.com/docs/tracking). To follow a parcel, use the carrier's own tracking or the AfterShip Tracking API with the tracking_number that create_label returned. This tool returns a structured not_supported result explaining that (it never errors).

Parameters1

tracking_number

string

optional

Optional tracking number (echoed back with guidance). Tracking itself is not served here.

Raw schema

{
  "type": "object",
  "properties": {
    "tracking_number": {
      "type": "string",
      "description": "Optional tracking number (echoed back with guidance). Tracking itself is not served here."
    }
  }
}

README.md5 KBView on GitHub

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.

Install

Tools (4)

quote_ratescreate_labelcancel_labelquery_tracking

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://logi-global.wishpool.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "global-logistics-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://logi-global.wishpool.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.