Skip to main content

Easyship MCP Server

MCP server for Easyship. Connect your AI tools to Easyship’s shipping platform and manage shipping operations through natural language.

The MCP server 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.

Capabilities

Tools across 6 categories:

  • Rates: Retrieve available courier options with prices, 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 over time, volume by destination, courier usage, status breakdowns, and sales channel volume

Installation

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.

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

⚠️ 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.


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

Need help?

API version

This server targets the Easyship API v2024-09.

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 stored by this connector. 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 support@easyship.com.

License

MIT

Metadata

Release files for easyship-mcp 0.6.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for easyship-mcp 0.6.8
File Size Uploaded Provenance Actions
easyship_mcp-0.6.8.tar.gz 259.3 kB Without provenance Details for easyship_mcp-0.6.8.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for easyship-mcp 0.6.8
File Interpreter ABI Platform Actions
easyship_mcp-0.6.8-py3-none-any.whl Python 3 none any Details for easyship_mcp-0.6.8-py3-none-any.whl

Total release size: 300.2 kB

Release files / easyship_mcp-0.6.8.tar.gz

Download URL easyship_mcp-0.6.8.tar.gz
Size 259.3 kB
Tags Source
SHA-256 checksum
How to use checksums
89cb4737856e9180a564f63857f3448e65d034b76ad0cfbbdff66524091ed9e7
BLAKE2b-256 checksum
How to use checksums
493a8dc16aaec93ac7ef95de5523006d13373a85779de59e1f3406449325f465
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / easyship_mcp-0.6.8-py3-none-any.whl

Download URL easyship_mcp-0.6.8-py3-none-any.whl
Size 40.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fffd837b37d1b7f31b4a8ff255a906c66760ae3d55151135dda0155506b4d540
BLAKE2b-256 checksum
How to use checksums
4cdf33b185335d705dc2b4c54b0e7346e3732b72610fdac2a5cb8a00c8a360a8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for easyship-mcp 0.6.8

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page