# EasyPost MCP

> EasyPost MCP handles everything related to e-commerce logistics. Your AI agent uses this connector to quote real-time shipping rates from major carriers like FedEx and UPS, generate labels, manage full shipments, and track packages across multiple services, all through natural conversation.

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

## Description

Managing physical goods means dealing with complex carrier rules and fluctuating costs. With this MCP, your AI client handles the entire logistics pipeline. You can ask it to pull up every active tracker or find out which carriers are connected to your account. Need to quote a rate? Just tell your agent the package dimensions, origin, and destination, and it pulls available rates from multiple services instantly. It doesn't just list data; it lets you manage full shipments and get high-level summaries of delivery success rates. Because this MCP is hosted on Vinkius, you connect once to access all shipping capabilities. You can monitor carrier account limits, see the most recent labels created, or even audit your whole fleet’s performance without opening a single website. It gives your AI agent total visibility over your outbound flow.

## Tools

### get_easypost_account_metadata
Retrieves usage limits and metadata for your EasyPost account.

### list_carrier_accounts
Lists every connected carrier you use, such as UPS, FedEx, or USPS.

### quick_delivery_health_audit
Pulls a high-level summary of your shipment activity and overall delivery success rates.

### get_shipment_details
Retrieves detailed information, including available rates and options for a specific shipment.

### get_tracking_details
Provides real-time tracking events and the current status for any given package code.

### list_in_transit_packages
Identifies all shipments that are currently moving through a carrier network.

### list_latest_shipments
Shows you the details of the most recently created labels and shipments in your account.

### list_shipping_shipments
Lists every shipment record that has been created within your EasyPost account.

### list_active_trackers
Gives you a list of all tracking objects currently marked as active in the system.

### search_by_tracking_code
Searches for package status and details using a specific, known 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

### Quote real-time shipping rates
Get detailed rate comparisons and options for a specific shipment using multiple carriers.

### Track package progress instantly
Retrieve the current status, checkpoints, and estimated delivery date for any known tracking code.

### Manage carrier accounts
List connected carriers (like USPS or FedEx) and check overall account usage limits.

### Audit delivery health
Get a quick summary of how many shipments are in transit and the overall success rate for your recent orders.

## Use Cases

### Auditing Fulfillment Failure
A logistics coordinator notices a spike in returns. They ask their agent to run 'quick_delivery_health_audit' and instantly see the success rate dropped below 95%, allowing them to immediately contact carrier support.

### Quoting for New Inventory
An e-commerce manager needs a shipping cost from Texas to Florida. They ask their agent, which then uses 'get_shipment_details' to compare rates from UPS and FedEx in real time before listing the lowest option.

### Handling Customer Inquiries
A customer service specialist receives a query for an old tracking number. The agent runs 'search_by_tracking_code', retrieves the full event log, and responds to the customer with precise details in seconds.

### Checking Account Capacity
Before running a large batch of labels, the fulfillment team asks their agent to check account limits using 'get_easypost_account_metadata', ensuring they won't exceed their monthly quota.

## Benefits

- Stop checking multiple carrier websites. Your agent handles rate comparisons for a single shipment using the 'get_shipment_details' tool, showing you rates from all connected carriers at once.
- Never lose track of your fleet. Use 'list_in_transit_packages' to generate an immediate list of every package that is currently on the road, giving you total visibility into fulfillment status.
- Boost customer service efficiency by running a quick search using 'search_by_tracking_code'. You get instant updates and event logs without needing manual lookup.
- Monitor your account health before shipping. The 'quick_delivery_health_audit' tool provides immediate stats on success rates, helping you spot carrier underperformance fast.
- Keep track of what’s new. Use 'list_latest_shipments' to instantly review the details and status of every label created within the last hour.
- Stay aware of limits. The 'get_easypost_account_metadata' tool checks your usage boundaries, stopping you from accidentally running into paid overages.

## How It Works

The bottom line is you tell your AI client what needs doing—from quoting rates to checking status—and it executes the logistics task directly.

1. Connect EasyPost via Vinkius to your AI client using your API key.
2. Your agent accesses carrier data by asking natural language questions, such as 'What rates are available for a box from NY to CA?'
3. The MCP processes the request and returns actionable shipping details, including tracking numbers or rate comparisons.

## Frequently Asked Questions

**How do I find out which carriers I use with EasyPost MCP?**
You run the 'list_carrier_accounts' tool. This instantly provides a list of all connected services, including their current active status.

**Can I check rates for multiple services with EasyPost MCP?**
Yes, you use the 'get_shipment_details' function. You give it package specs, and the tool returns a rate comparison across all your connected carriers.

**What is the easiest way to track packages with EasyPost MCP?**
Use the 'search_by_tracking_code' tool. This allows you to search for status updates using any specific tracking code, regardless of which carrier owns it.

**How does EasyPost MCP help me audit my shipments?**
The 'quick_delivery_health_audit' tool runs a high-level summary showing your overall delivery success rates and shipment activity in one go.

**I need to see all the packages currently moving. Which EasyPost MCP tool should I use?**
Use 'list_in_transit_packages'. This function identifies every single package that is actively moving with a carrier right now, saving you from checking multiple tracking pages.