easyship-mcp 0.4.0

MCP server for Easyship — get shipping rates and track shipments

Easyship MCP Server

MCP server for Easyship — get shipping rates and track shipments.

Capabilities

Tools across 6 categories:

• Rates — Compare 550+ courier options with prices, delivery times, and duty estimates
• Shipments — Create, update, track, cancel, and manage shipments end-to-end including label purchase and document retrieval
• Pickups — Check available slots, schedule courier pickups, and manage existing pickups
• Address Validation — Validate shipping addresses
• Billing — View transactions and billing documents
• Analytics — Shipment volume trends, top destinations, courier usage, status breakdowns, and sales channel performance

Installation

Get your API token from Easyship Dashboard → Connect → API.

Each client below offers two connection methods:

Method	How it works	Requires Python?
Remote	Connects to mcp.easyship.com via Streamable HTTP	No
Local	Runs the easyship-mcp package on your machine via uvx	Yes

---

Claude Desktop

Quit Claude Desktop before editing config, then restart after saving.

OS	Config file
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

Merge into the top-level mcpServers object (create it if missing).

Remote:

{
  "mcpServers": {
    "easyship": {
      "type": "url",
      "url": "https://mcp.easyship.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Local (uvx):

{
  "mcpServers": {
    "easyship": {
      "command": "uvx",
      "args": ["easyship-mcp"],
      "env": {
        "EASYSHIP_API_ACCESS_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Requires uv installed on your machine.

---

Claude Code

Remote:

claude mcp add --transport http easyship \
  https://mcp.easyship.com/mcp \
  --header 'Authorization: Bearer YOUR_TOKEN'

Local (uvx):

export EASYSHIP_API_ACCESS_TOKEN="YOUR_TOKEN"
claude mcp add easyship -- uvx easyship-mcp

---

Cursor

Add to .cursor/mcp.json in your project (or ~/.cursor/mcp.json for global):

Remote:

{
  "mcpServers": {
    "easyship": {
      "url": "https://mcp.easyship.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Local (uvx):

{
  "mcpServers": {
    "easyship": {
      "command": "uvx",
      "args": ["easyship-mcp"],
      "env": {
        "EASYSHIP_API_ACCESS_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

---

VS Code

Add to .vscode/mcp.json in your project:

Remote:

{
  "servers": {
    "easyship": {
      "type": "http",
      "url": "https://mcp.easyship.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Local (uvx):

{
  "servers": {
    "easyship": {
      "type": "stdio",
      "command": "uvx",
      "args": ["easyship-mcp"],
      "env": {
        "EASYSHIP_API_ACCESS_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

---

Gemini CLI

gemini mcp add --transport http easyship \
  https://mcp.easyship.com/mcp \
  --header 'Authorization: Bearer YOUR_TOKEN'

---

Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.easyship]
url = "https://mcp.easyship.com/mcp"
http_headers = { "Authorization" = "Bearer YOUR_TOKEN" }

---

Other clients

For any MCP client that supports Streamable HTTP, point it at:

URL:    https://mcp.easyship.com/mcp
Header: Authorization: Bearer YOUR_TOKEN

For stdio-based clients, run uvx easyship-mcp with EASYSHIP_API_ACCESS_TOKEN set in the environment.

Usage examples

Get shipping rates:

"What are the shipping options for a 1.5kg package (30×20×15 cm) from Hong Kong to New York?"

Track a shipment:

"Track shipment ESSG10006001"

Schedule a pickup:

"Schedule a pickup for shipment ESSG10006001 on the earliest available date"

Validate an address:

"Validate this address: 215 Clayton St, San Francisco, CA 94117"

Analyze shipping data:

"What are my top shipping destinations this quarter?"

"Which courier do I use the most?"

API version

This server targets the Easyship API v2024-09.

License

MIT