# Easyship

Easyship lets coding agents work with shipping operations, from comparing carrier quotes to creating shipments and tracking parcels. It fits workflows that need delivery management inside an AI client.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: easyship
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/easyship/easyship-mcp-plugin
- Updated: 2026-06-23
- HTML: https://affpapa.org/en/nevibecode/mcp/easyship

## What it does

Easyship exposes shipping operations to AI agents through MCP. Agents can compare carrier prices, estimated delivery windows and expected taxes, then create or cancel shipments and obtain shipping labels or documents. Address checks cover US domestic and international destinations. Pickup scheduling and billing records are available through the same connection.

The server also provides shipment analytics, including destination patterns, carrier usage and delivery-status breakdowns. You can connect to the hosted MCP endpoint over HTTP or run the `easyship-mcp` package locally with `uvx`. The local setup requires Python, and API access requires an Easyship token.

Easyship supports Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed and Gemini CLI. The hosted connection avoids running the package on your own machine. There is no separate MCP test environment, so operations that spend credits, such as label purchases, incur real charges. A token with limited permissions is recommended for initial checks.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://mcp.easyship.com/mcp`
- Environment variables: `EASYSHIP_API_ACCESS_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.easyship.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env EASYSHIP_API_ACCESS_TOKEN=<EASYSHIP_API_ACCESS_TOKEN> --transport stdio easyship -- uvx easyship-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from easyship-mcp <command>

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add easyship --url https://mcp.easyship.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add easyship --env EASYSHIP_API_ACCESS_TOKEN=<EASYSHIP_API_ACCESS_TOKEN> -- uvx easyship-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from easyship-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "easyship": {
            "url": "https://mcp.easyship.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "easyship": {
            "command": "uvx",
            "args": [
                "easyship-mcp"
            ],
            "env": {
                "EASYSHIP_API_ACCESS_TOKEN": "<EASYSHIP_API_ACCESS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from easyship-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "easyship": {
            "type": "http",
            "url": "https://mcp.easyship.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "easyship": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "easyship-mcp"
            ],
            "env": {
                "EASYSHIP_API_ACCESS_TOKEN": "<EASYSHIP_API_ACCESS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from easyship-mcp <command>

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http easyship https://mcp.easyship.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e EASYSHIP_API_ACCESS_TOKEN=<EASYSHIP_API_ACCESS_TOKEN> easyship uvx easyship-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from easyship-mcp <command>

## When to use it
- Compare carrier quotes for an international parcel
- Create a shipment and purchase its shipping label
- Check a recipient address before dispatch
- Arrange a courier pickup for an existing shipment
- Review destination trends and shipment status distribution

## Example prompts
- Compare delivery options for a 1.5kg parcel from Hong Kong to New York, packed in a 30×20×15 cm box.
- Track shipment `ESSG10006001` and report its current status.
- Find the earliest available courier pickup date for shipment `ESSG10006001`.

## Similar
- [Shippo](https://affpapa.org/en/nevibecode/mcp/shippo.md) — MCP server · ★ 3
- [mcp-skydropx](https://affpapa.org/en/nevibecode/mcp/mcp-skydropx.md) — MCP server · ★ 275
- [mcp-correios](https://affpapa.org/en/nevibecode/mcp/mcp-correios.md) — MCP server · ★ 275
- [ProShip Thailand Post](https://affpapa.org/en/nevibecode/mcp/proship-thailand-post.md) — MCP server
- [ecommerce-shipping-rates](https://affpapa.org/en/nevibecode/skills/ecommerce-shipping-rates.md) — skill · 1100 installs
- [tiktok-shop-shipping](https://affpapa.org/en/nevibecode/skills/tiktok-shop-shipping.md) — skill · 995 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md