# Easyship MCP

> Easyship MCP connects your AI agent directly to global shipping data. Get real-time package tracking, request instant cross-border rates from multiple couriers, and manage all logistics operations through natural conversation.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** global-shipping, carrier-rates, package-tracking, logistics-automation, cross-border-trade, supply-chain

## Description

Managing international e-commerce shipments used to mean jumping between carrier websites, copying tracking numbers, and manually comparing quotes—a nightmare for any operation relying on speed. Now, you can let your AI client handle the entire process. This MCP lets your agent look up detailed information about all your global logistics shipments. You can request instant shipping quotes by giving it basic parcel details; it pulls rates from various couriers so you can compare costs and delivery times instantly. Need to know what's happening with a specific package? Your agent tracks active shipments, resolving real-time transit statuses and showing the last checkpoint recorded. If you’re running into issues or need an overview of your account limits, this MCP handles it. It just adds another powerful toolset to your existing AI workflow via Vinkius, letting your team focus on selling goods instead of tracking boxes.

## Tools

### quick_shipping_volume_audit
Generates a quick summary of your overall shipment activity and success rates for the period.

### get_shipment_details
Pulls all detailed information, including status updates and tracking history, for one specific package.

### list_available_couriers
Lists every courier you can use and details what services they offer.

### list_failed_deliveries
Identifies shipments that failed delivery or ran into some kind of issue.

### list_in_transit_shipments
Finds all the packages currently moving through a courier's network.

### get_shipping_rates
Requests and compares live shipping rates based on package size and destination.

### list_latest_shipments
Retrieves a list of the most recently added or updated shipments in your account.

### list_logistics_shipments
Provides a comprehensive list of all current and historical shipments under your account.

### search_shipments_by_reference
Searches for any shipment using its reference ID or keyword search term.

### get_easyship_account_metadata
Retrieves important information about your Easyship account, like usage limits and metadata.

## Prompt Examples

**Prompt:** 
```
List the most recent global shipments.
```

**Response:** 
```
I've found 5 recent shipments, including deliveries to Hong Kong and the United Kingdom. 2 are 'In Transit' and 3 are 'Delivered'. Would you like the tracking number for the Hong Kong shipment?
```

**Prompt:** 
```
Get shipping rates from USA to France for a 1kg parcel.
```

**Response:** 
```
I've retrieved 3 rates for this route: FedEx International Connect ($25.00, 5 days), UPS Worldwide Saver ($42.00, 2 days), and DHL Express ($38.00, 3 days). Would you like to see the full JSON parameters for these rates?
```

**Prompt:** 
```
Check the status of shipment 'ES-12345678'.
```

**Response:** 
```
Shipment 'ES-12345678' is currently 'In Transit'. The last checkpoint was 'Arrived at Sorting Facility' in Singapore. ETA is March 20th. Should I pull the full delivery history?
```

## Capabilities

### Check Shipment Status
The agent finds and reports the current status and detailed history for any specified shipment.

### Get Shipping Rates
It pulls real-time quotes from multiple couriers based on package dimensions, weight, and destination.

### List All Shipments
The system provides comprehensive lists of all shipments in the account, or filters them by status (in transit, failed, etc.).

### Identify Couriers
It lists every available courier and details their specific service boundaries and capabilities.

## Use Cases

### A new product needs pricing for three countries.
The E-commerce Manager asks their agent: 'What are the rates for a 1kg item to France, Germany, and Japan?' The agent calls `get_shipping_rates` multiple times, returns three full rate breakdowns, allowing the manager to set accurate final product pricing instantly.

### Customer asks where their package is.
A customer support agent needs details for 'ES-9876'. Instead of asking the customer for a tracking number and waiting, the agent uses `search_shipments_by_reference` to pull up all current status updates and last known locations.

### Need to know if shipments are stalled.
The Logistics Coordinator asks: 'Show me everything that failed delivery.' The agent runs `list_failed_deliveries`, providing a clean list of IDs, allowing the coordinator to quickly follow up with carriers and correct the shipment.

### Checking overall account health.
The operations lead uses the MCP to run a status check: 'What are our total shipments right now?' The agent calls `list_in_transit_shipments` combined with `quick_shipping_volume_audit`, giving them an immediate, high-level report.

## Benefits

- Stop manual rate comparison. By calling `get_shipping_rates`, your agent automatically checks multiple couriers, giving you a clear, comparative list of costs and estimated delivery times in one response.
- Never lose track of an order again. Whether you use `list_logistics_shipments` or search with `search_shipments_by_reference`, all package status data is instantly accessible through conversation.
- Improve customer service speed. Instead of checking a website, your agent pulls the latest delivery event and checkpoint details for any package using `get_shipment_details`—fast enough to answer on the spot.
- Audit performance easily. Run a quick volume check with `quick_shipping_volume_audit` or see which packages are stuck by running `list_failed_deliveries`. It gives you immediate operational visibility.
- Plan better routes and save money. Before selling something, your agent can use `get_shipping_rates` to ensure the final cost estimate is accurate across borders.

## How It Works

The bottom line is that your AI agent treats logistics like another piece of software, handling all the API calls you used to manage manually.

1. Authorize the MCP using your Easyship API Key.
2. Tell your AI client what you need—for example, 'What are the rates for a 2kg box to Germany?'
3. The agent executes the necessary tools and returns structured data with quotes or tracking details.

## Frequently Asked Questions

**Does Easyship MCP handle tracking for every courier?**
Yes. The tool accesses data from multiple global carriers. You can check which partners are available by calling `list_available_couriers` to see their specific service boundaries.

**How do I find the rates using Easyship MCP?**
You prompt your agent with the package details (weight, size) and destination. The agent uses `get_shipping_rates` to pull comparative quotes from several carriers at once.

**Can I check if an address failed delivery using Easyship MCP?**
Yes. If you suspect a problem, the agent runs `list_failed_deliveries` to pinpoint shipments that have encountered issues or were returned.

**Is there a way to list all my past orders with Easyship MCP?**
You can use `list_logistics_shipments` for an overall view of your account, or if you know the reference ID, use `search_shipments_by_reference` for precise targeting.

**Does Easyship MCP only work with my main API key?**
The system requires authorization via your existing Easyship API Key. Running `get_easyship_account_metadata` confirms the connection and shows you account limits immediately.

**How do I get an Easyship API Key?**
Log in to your Easyship dashboard, navigate to **Connect > API**, and you can create a new API token or retrieve an existing one from there.

**Can the agent generate labels?**
This integration currently focuses on listing and auditing shipments, tracking, and rates. Purchasing and printing shipping labels should be managed via the Easyship web portal or dedicated creation API endpoints.

**Does it support international shipping?**
Yes, Easyship is designed specifically for global logistics. The agent can retrieve rates and tracking for both domestic and international shipments.