How do I install Easyship?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Easyship need an API key?

The publisher lists these environment variables: EASYSHIP_API_ACCESS_TOKEN.

When was Easyship last checked?

Last checked 2026-10-23. Connect Easyship to compare rates, create shipments, buy labels, and track packages globally.

Easyship MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://mcp.easyship.com/mcp

Credentials from the publisher

EASYSHIP_API_ACCESS_TOKEN — Your Easyship API access token. Get it from https://app.easyship.com/connect/api

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http com.easyship-mcp https://mcp.easyship.com/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.easyship-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://mcp.easyship.com/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 0.6.8

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Easyship MCP — AI Agent Plugin For Shipping & Logistics Automation

Connect all your AI tools to Easyship’s global shipping platform and manage your entire shipping operation through natural language.

The plugin gives your agent access to shipping rates, shipment creation, label purchasing, package tracking, pickup scheduling, address validation, billing, and analytics. For more info, see the API docs.

Access 550+ courier services across 200+ countries — including UPS, FedEx, DHL Express, USPS, Canada Post, Australia Post, and Royal Mail — directly from Cursor, Claude, Gemini, Codex, and more.

Install

For Cursor: Search for "easyship" in Settings -> Marketplace, or add manually via Settings -> Tools & MCP."

For Claude Code: Run these two commands in a chat:

/plugin marketplace add easyship/easyship-mcp-plugin
/plugin install easyship@easyship-mcp-plugin

For Gemini CLI: Run this command in your terminal:

gemini extensions install https://github.com/easyship/easyship-mcp-plugin

For OpenAI Codex: In the Codex CLI, Add to ~/.codex/config.toml:

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

For VS Code: Open the Command Palette (CMD+SHIFT+P) and run Chat: Install Plugin From Source. Then paste:
```
https://github.com/easyship/easyship-mcp-plugin
```

What you get

Rate comparison: Compare 550+ courier options with discounted rates, estimated delivery times, and tax and duty estimates
Shipment management: Create, update, track, cancel, and manage shipments end-to-end including label purchase and document retrieval
Pickup scheduling: Check available slots, schedule courier pickups, and manage existing pickups
Address validation: Validate shipping addresses for US domestic and international destinations
Billing: View transactions and billing documents
Analytics: Shipment volume trends, top destinations, courier usage, status breakdowns, and sales channel performance

Other install methods

If your platform doesn't support plugins, you can install the MCP server directly.

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

Tip: Copy .env.example to .env and add your API token. Some local setups will read from this file automatically.

⚠️ Security Note: Never share your API token in the chat window. If you accidentally paste it in a prompt, revoke and rotate your API key immediately in the Easyship Dashboard.

Note: There is no separate test environment for MCP actions. Any action that consumes credits (such as generating labels) will incur real charges. We recommend using a test API token with limited scopes for your first run.

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": {
      "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?"

Need help?

Privacy Policy

The Easyship MCP Connector acts as a stateless proxy — it stores no user data, credentials, or shipment information on its own servers. All data processed through this connector is subject to Easyship's data handling practices.

What this connector does with your data:

Data collection: No personal data or shipment content is collected. Operational request metadata (endpoint, status code, session ID) is logged for monitoring purposes.
Usage & storage: Access tokens are held by your MCP client (e.g. Claude) and are never written to disk or logged by this server.
Third-party sharing: Your data is sent to Easyship's API solely to fulfill your requests, governed solely by Easyship's systems.
Retention: This connector retains no personal data or shipment content. Operational request metadata logs are retained for monitoring purposes. Any retention of shipment or personal data is governed solely by Easyship's systems.
Contact: For questions about how your data is handled, see the Easyship Privacy Policy or contact [email protected].

API version

This server targets the Easyship API v2024-09.

License

MIT

Easyship

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Easyship?

Does Easyship need an API key?

What transport does Easyship use?

When was Easyship last checked?

Documentation

Easyship MCP — AI Agent Plugin For Shipping & Logistics Automation

Install

What you get

Other install methods

Claude Desktop

Claude Code

Cursor

VS Code

Gemini CLI

Codex CLI

Other clients

Usage examples

Need help?

Privacy Policy

API version

License