Easyship — MCP server for Claude Code: setup and features
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.
claude mcp add --transport http mcp https://mcp.easyship.com/mcpWhat Easyship 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.
What it helps with
- 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 for the agent
- Compare delivery options for a 1.5kg parcel from Hong Kong to New York, packed in a 30×20×15 cm box.
- Track shipment
ESSG10006001and report its current status. - Find the earliest available courier pickup date for shipment
ESSG10006001.
How to install Easyship
1Platform CLI: remote server
claude mcp add --transport http mcp https://mcp.easyship.com/mcp2Platform CLI
claude mcp add --env EASYSHIP_API_ACCESS_TOKEN=<EASYSHIP_API_ACCESS_TOKEN> --transport stdio easyship -- uvx easyship-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from easyship-mcp <command>
1Platform CLI: remote server
codex mcp add easyship --url https://mcp.easyship.com/mcp2Platform CLI
codex mcp add easyship --env EASYSHIP_API_ACCESS_TOKEN=<EASYSHIP_API_ACCESS_TOKEN> -- uvx easyship-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from easyship-mcp <command>
Config file
{
"mcpServers": {
"easyship": {
"url": "https://mcp.easyship.com/mcp"
}
}
}{
"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>
Config file
{
"servers": {
"easyship": {
"type": "http",
"url": "https://mcp.easyship.com/mcp"
}
}
}{
"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>
1Platform CLI: remote server
gemini mcp add -t http easyship https://mcp.easyship.com/mcp2Platform CLI
gemini mcp add -e EASYSHIP_API_ACCESS_TOKEN=<EASYSHIP_API_ACCESS_TOKEN> easyship uvx easyship-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from easyship-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Easyship
How do I install Easyship in Claude Code?
Add the marketplace with /plugin marketplace add easyship/easyship-mcp-plugin, then install the plugin with /plugin install easyship@easyship-mcp-plugin. For a direct MCP connection, use claude mcp add --transport http easyship https://mcp.easyship.com/mcp or the local setup command claude mcp add --env EASYSHIP_API_ACCESS_TOKEN=<EASYSHIP_API_ACCESS_TOKEN> --transport stdio easyship -- uvx easyship-mcp.
What does the Easyship MCP server do?
It connects an AI agent to shipping workflows, including rate comparisons, shipment creation, label purchases and parcel tracking. Address validation, courier pickup scheduling and shipping analytics are also supported.
Does Easyship MCP require Python?
Python is required when running easyship-mcp locally through uvx. The hosted option connects over HTTP to https://mcp.easyship.com/mcp without running the package on your machine.
