# EasyPost MCP MCP

> EasyPost manages your entire logistics pipeline, letting your AI agent handle everything from real-time package tracking across carriers like UPS and FedEx to calculating optimal shipping rates for any shipment. You can list all active trackers, audit delivery health, and monitor connected carrier accounts instantly.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** carrier-integration, package-tracking, shipping-rates, address-verification, logistics-api, fulfillment

## Description

This MCP connects the complexities of e-commerce fulfillment directly into your workflow. Instead of jumping between carrier websites or maintaining dozens of spreadsheets to check status updates, you give your agent one connection. It handles listing every shipment created in your account, pulling detailed rates for new orders, and tracking down exactly where a package is right now. Because logistics requires handling sensitive credentials—like API keys for UPS or USPS—your payment information passes through Vinkius' zero-trust proxy. This means the AI client uses those keys only while transferring data; they never sit on a disk. The result is secure, immediate insight into your entire shipping operation.

## Tools

### get_easypost_account_metadata
Checks your EasyPost account limits and usage details.

### get_shipment_details
Pulls specific rate options and full information for one shipment label.

### get_tracking_details
Retrieves the detailed event history and current status for a single tracking number.

### list_active_trackers
Lists all package trackers that are currently in motion or awaiting delivery.

### list_carrier_accounts
Displays a list of every carrier account you've set up (e.g., FedEx, USPS).

### list_in_transit_packages
Identifies which packages are currently moving with the carrier.

### list_latest_shipments
Shows the most recently created or labeled shipments in your account.

### list_shipping_shipments
Retrieves a comprehensive list of all past and current shipments you've processed.

### quick_delivery_health_audit
Runs a quick check to give a high-level summary of overall delivery success rates.

### search_by_tracking_code
Finds and pulls details for any tracker using just the tracking code.

## Prompt Examples

**Prompt:** 
```
List all active package trackers.
```

**Response:** 
```
I've found several active trackers, including codes for FedEx and UPS. 3 packages are 'In Transit' and 1 is 'Out for Delivery'. Would you like to see the details for the package out for delivery?
```

**Prompt:** 
```
Show me the details for shipment 'shp_998877'.
```

**Response:** 
```
Shipment 'shp_998877' is currently 'Label Purchased'. It has 3 available rates from USPS and UPS. The lowest rate is $7.50 via USPS Ground Advantage. Should I pull the full carrier rate list?
```

**Prompt:** 
```
Which carrier accounts are connected to my account?
```

**Response:** 
```
Your account has 4 connected carrier accounts: 'USPS' (Active), 'FedEx' (Active), 'UPS' (Active), and 'DHL Express' (Pending Configuration). Would you like to see the account credentials for any of these?
```

## Capabilities

### List all active package trackers
Retrieves a list of every ongoing shipment that needs monitoring.

### Get detailed rates and info for shipments
Calculates the best available shipping options and costs for specific packages.

### Search package status by tracking code
Provides real-time delivery events and status updates using a single tracking number.

### Audit overall delivery success rates
Generates a high-level summary of how well your packages are getting delivered right now.

### List all connected carrier accounts
Shows which shipping carriers (like FedEx or UPS) are linked to the account for use.

## Use Cases

### Handling an urgent customer inquiry
A customer texts asking where their item is. You don't need to wait for them to type the code; you ask your agent to use `search_by_tracking_code` immediately, and it returns the real-time location and estimated delivery date.

### Quarterly performance review
Your boss asks how well we shipped last quarter. Instead of pulling reports from five different carriers, you run `list_shipping_shipments` and then use the audit tools to get a clear picture of overall success rates.

### Pricing a new product line
You're setting up shipping for a new zone. You tell your agent to run `get_shipment_details` and ask it to pull rates from three different carriers for various dimensions, finding the absolute best pricing.

### Inventory cleanup after a sale
You need to confirm which packages are still out there. You run `list_in_transit_packages` to get a list of items that have left the warehouse but haven't been delivered yet.

## Benefits

- You can instantly check all connected services using `list_carrier_accounts`, so your agent always knows what shipping options are available for a customer. This eliminates guesswork when calculating rates.
- Never waste time manually checking statuses across multiple websites; running the `quick_delivery_health_audit` gives you an immediate, high-level view of delivery success rates for your entire operation.
- When a customer asks about a specific package, using `search_by_tracking_code` or `get_tracking_details` pulls the exact event history—from label creation to final checkpoint.
- Need to quote a new order? Use `get_shipment_details` to pull multiple carrier rates (like USPS vs. FedEx) in one call, letting you recommend the cheapest and fastest option immediately.
- Want to see everything that's happened without knowing the exact ID? Running `list_shipping_shipments` gives you a clean list of all past activity for quick review.

## How It Works

The bottom line is that your AI agent talks to all your shipping systems through one place, so you don't have to.

1. You ask your AI agent to check on shipments, giving it either a specific tracking number or a general request like 'show me all packages moving right now.'
2. The MCP runs the necessary checks against EasyPost's system and pulls data from multiple carriers.
3. Your agent gets back actionable data—like a list of active trackers or the lowest rate for a new package.

## Frequently Asked Questions

**How do I get an EasyPost API Key?**
Log in to your EasyPost dashboard, navigate to **Account Settings > API Keys**, and you can find your Live and Test API keys there. Ensure you use the appropriate key for the data you want to access.

**Can the agent purchase shipping labels?**
This integration currently focuses on listing and auditing shipments, trackers, and carrier accounts. Purchasing labels or generating labels should be managed via the EasyPost web portal or specific creation API endpoints.

**Which carriers are supported?**
EasyPost supports over 100 carriers globally, including USPS, FedEx, UPS, DHL, and many regional carriers. You can use the list_carrier_accounts tool to see which ones are connected to your account.

**How can I check my usage limits using the `get_easypost_account_metadata` tool?**
You retrieve your account's full metadata and current usage boundaries directly with this tool. It shows you exactly how many API calls or credits you have left, preventing overspending before it happens.

**What is the best way to audit my delivery success rates using `quick_delivery_health_audit`?**
The tool provides an instant, high-level summary of your overall shipment activity and success rate. It gives you a quick pulse check on carrier performance without needing individual package lookups.

**If I need to find a specific package status, should I use `search_by_tracking_code` or `list_active_trackers`?**
Use `search_by_tracking_code` when you have the exact code you want to track. If you just want a list of everything currently moving, run `list_active_trackers` first.

**How do I get detailed rate information for an existing shipment using `get_shipment_details`?**
This tool fetches comprehensive data and available rates for a specific shipment ID. It shows you multiple carrier options, including the lowest cost per service level.

**Can I use `list_shipping_shipments` to pull bulk data about my orders?**
Yes, this tool lists all shipments associated with your account. You can then process that list to build out batch reports or update large sets of records.