Easyship (Official)

v0.4.0 — 25 tools across shipping, tracking, pickups, billing, address validation, and analytics.

Shipping rates#

get_rates#

Use when the user asks about shipping costs, delivery times, courier options, or the cheapest/fastest way to ship.

Required inputs: origin country, destination country, parcel weight, dimensions (length/width/height).

Optional (improves accuracy): city, state, postal code, street address for origin and destination. Item category or HS code for duty estimates.

Presenting results:

• Show a comparison table: courier name, price, currency, estimated delivery days.
• Sort by price (lowest first) unless the user asks for fastest.
• If you used assumed/estimated data (e.g. generic postal codes), tell the user the rates are estimates.

Shipments#

create_shipment#

The primary tool for creating shipments and buying labels.

For "ship this" / "buy a label": set buy_label: true and buy_label_synchronous: true with format: "url" in printing options. Extract the label URL from shipping_documents in the response and present it as a clickable link.

For a specific courier (e.g. "buy a label with UPS Ground"): call get_rates first to find the courier_id, then pass it in courier_settings.

Without a specific courier: omit courier_service_id — the API auto-selects best value. Do NOT call get_rates first.

Required inputs: complete origin and destination addresses (contact name, email, phone, street, city, country code, and company name for origin), parcel weight, item description and customs value.

update_shipment / get_shipment / list_shipments / delete_shipment / cancel_shipment#

• get_shipment — retrieves full shipment details. Also use this to get label/document download URLs (pass format="URL").
• list_shipments — filter by state, date range, country, etc. Supports label_state, delivery_state, shipment_state filters.
• delete_shipment — removes a shipment that hasn't shipped yet.
• cancel_shipment — cancels a shipped shipment (only if label failed or shipment not yet in transit).

create_label#

The preferred way to buy a label for an existing shipment. Use this instead of passing buy_label via update_shipment.

Required input: easyship_shipment_id.

Optional: courier_service_id (omit to auto-select), format (url/pdf/png/zpl, default "url"), label/ commercial_invoice/ packing_slip page sizes, remarks.

After calling: Find the shipping_documents entry with "category": "label" and present its URL as a clickable link. Include packing slip and commercial invoice URLs if present.

get_shipment_documents#

Returns metadata only (content type, size). For actual document downloads, use get_shipment with format="URL" instead.

Tracking#

track_shipment#

Use when the user asks to track a package, check delivery status, or says "where's my shipment."

Required input: either easyship_shipment_id or platform_order_number — at least one must be provided.

Presenting results:

• Current status, last known location, estimated delivery date.
• List recent tracking checkpoints.

Pickups#

get_pickup_slots → create_pickup#

Workflow for scheduling a pickup:

1. Get the courier_service_id from the shipment via get_shipment
2. Call get_pickup_slots to find available dates and time windows
3. Present options to the user (or pick the earliest if they want the closest)
4. Call create_pickup with the chosen slot, date, and shipment IDs

All shipments in a pickup must use the same courier and have labels pending or generated.

list_pickups / get_pickup / cancel_pickup / list_pickup_shipments#

Standard CRUD for managing existing pickups.

Address validation#

validate_address#

Validates both US domestic and international addresses in a single tool. Omit country_alpha2 or pass "US" for domestic; any other country code routes to international validation.

Requires an updated contract with Easyship.

Billing#

list_transactions / list_billing_transactions#

View transaction history filtered by type (shipment, pickup, claim, policy, payment), date range, or shipment ID.

Analytics#

Six analytics tools, all defaulting to a 90-day lookback if the user doesn't specify a date range:

ToolUse forReturnsanalytics_shipmentsShipment volume and trendsTotal count + daily time seriesanalytics_shippedPast shipping activity confirmationWhether account has ever shippedanalytics_shipment_statusStatus distributionCounts by status (in-progress breakdown)analytics_top_destinationsWhere shipments goCountries/zones ranked by volumeanalytics_top_couriersCourier usage breakdownCouriers ranked by shipment countanalytics_sale_channelsSales channel breakdownChannels ranked by shipment count

General#

• Easyship supports 550+ couriers across 200+ countries/territories.
• An API token is required. If not configured, direct the user to: https://app.easyship.com/connect
• All prices are returned in the user's Easyship account currency unless specified otherwise.
• Always confirm destructive actions (delete/cancel) with the user before executing.