Easyship (Official)

Official Easyship Integration. Ship, label, track & pickup across 550+ couriers in 200+ countries. Connects to mcp.easyship.com — no install required

Security Scan

The skill's requirements and runtime instructions align with an Easyship API integration and request only the expected API token — nothing in the package suggests unrelated or excessive access.

Purpose & Capability

Name/description, declared tools, and required env var (EASYSHIP_API_ACCESS_TOKEN) match a shipping/tracking/pickup integration with Easyship's MCP API.

Instruction Scope

SKILL.md describes calling Easyship endpoints, handling rates, shipments, pickups, billing, and analytics. It does not instruct reading unrelated files, accessing other environment variables, or sending data to endpoints outside mcp.easyship.com (aside from returned label/document URLs which are part of the API flow).

Install Mechanism

Instruction-only skill with no install spec and no code files — nothing is written to disk or downloaded during install, minimizing install-time risk.

Credentials

Only one required environment variable (EASYSHIP_API_ACCESS_TOKEN) is declared and used as the primary credential, which is proportionate for a third-party API integration.

Persistence & Privilege

always is false and the skill is user-invocable; it does not request permanent system presence or modify other skills' configurations.

Assessment

This skill appears to be a straightforward Easyship API integration and only asks for your Easyship API token. Before installing: (1) ensure the token you provide has the minimum privileges needed and rotate/revoke it if compromised; (2) be aware the skill will send shipment data (including addresses and contact info) to Easyship — treat that as PII and confirm your privacy requirements; (3) returned label URLs may be accessible if shared, so handle them carefully; (4) because the skill is instruction-only, it doesn’t install code locally, but review your account-level permissions on Easyship and inspect the upstream GitHub repo if you want additional assurance.

v0.3.1 — 24 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).

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:

Tool	Use for	Returns
analytics_shipments	Shipment volume and trends	Total count + daily time series
analytics_shipped	Past shipping activity confirmation	Whether account has ever shipped
analytics_shipment_status	Status distribution	Counts by status (in-progress breakdown)
analytics_top_destinations	Where shipments go	Countries/zones ranked by volume
analytics_top_couriers	Courier usage breakdown	Couriers ranked by shipment count
analytics_sale_channels	Sales channel breakdown	Channels 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.