Pirate Ship by Cotlet — Claude Code MCP server: setup
Connect an AI coding agent to Pirate Ship to check postage prices, prepare label drafts, and retrieve shipment tracking through an authenticated Chrome session.
claude mcp add --transport http pirate-ship https://cotlet.dev/mcp/v1/pirate-ship/connectWhat Pirate Ship by Cotlet does
Pirate Ship by Cotlet exposes shipping operations through MCP, a local REST API, and a Python interface. Agents can retrieve USPS and UPS rates, prepare label drafts, access shipment and tracking details, generate SCAN Forms, and work with reports. The package also includes ready-to-run Python scripts.
Local use requires Python 3.11 or later, Google Chrome 144+ signed in to Pirate Ship, and an account with a Ship From Address. Run pirate-ship-mcp connect to read session cookies through Chrome DevTools Protocol and save them in the user's configuration directory. The tool does not read the account password. Requests follow the GraphQL operations used by Pirate Ship's web app, so changes to those operations can break affected calls until their identifiers are updated.
The self-hosted project is licensed for noncommercial use. Operations that spend or refund money are excluded from this version. Label purchases take place in Pirate Ship itself and require an account balance or payment method. Supported MCP clients include Claude Code, Codex, Cursor, GitHub Copilot, Windsurf, Cline, Zed, and Gemini CLI.
What it helps with
- Compare USPS and UPS postage rates for a shipment
- Prepare a draft shipping label
- Retrieve the current tracking details for a parcel
- Create SCAN Forms for outgoing shipments
- Access shipping reports and order information
Example prompts for the agent
- Compare USPS and UPS rates for a 16-ounce parcel going to ZIP code 10001.
- Prepare a draft shipping label for this shipment.
- Retrieve the parcel's tracking status and prepare SCAN Forms for the outgoing shipments.
How to install Pirate Ship by Cotlet
1Platform CLI: remote server
claude mcp add --transport http pirate-ship https://cotlet.dev/mcp/v1/pirate-ship/connect2Platform CLI
claude mcp add pirate-ship-by-cotlet -- uvx pirate-ship-api-mcpuvx runs the command named after the package; if the README names another one, use uvx --from pirate-ship-api-mcp <command>
1Platform CLI: remote server
codex mcp add pirate-ship-by-cotlet --url https://cotlet.dev/mcp/v1/pirate-ship/connect2Platform CLI
codex mcp add pirate-ship-by-cotlet -- uvx pirate-ship-api-mcpuvx runs the command named after the package; if the README names another one, use uvx --from pirate-ship-api-mcp <command>
Config file
{
"mcpServers": {
"pirate-ship-by-cotlet": {
"url": "https://cotlet.dev/mcp/v1/pirate-ship/connect"
}
}
}{
"mcpServers": {
"pirate-ship-by-cotlet": {
"command": "uvx",
"args": [
"pirate-ship-api-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from pirate-ship-api-mcp <command>
Config file
{
"servers": {
"pirate-ship-by-cotlet": {
"type": "http",
"url": "https://cotlet.dev/mcp/v1/pirate-ship/connect"
}
}
}{
"servers": {
"pirate-ship-by-cotlet": {
"type": "stdio",
"command": "uvx",
"args": [
"pirate-ship-api-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from pirate-ship-api-mcp <command>
1Platform CLI: remote server
gemini mcp add -t http pirate-ship-by-cotlet https://cotlet.dev/mcp/v1/pirate-ship/connect2Platform CLI
gemini mcp add pirate-ship-by-cotlet uvx pirate-ship-api-mcpuvx runs the command named after the package; if the README names another one, use uvx --from pirate-ship-api-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 Pirate Ship by Cotlet
How do I install Pirate Ship by Cotlet in Claude Code?
For local use, run claude mcp add pirate-ship-by-cotlet -- uvx pirate-ship-api-mcp. Install Python 3.11+ and Google Chrome 144+, sign in to Pirate Ship in Chrome, enable remote debugging, then run pirate-ship-mcp connect and approve the browser connection.
What does Pirate Ship by Cotlet do?
It gives AI agents access to Pirate Ship shipping operations through MCP, REST, and Python. Available tasks include rate lookups, label drafts, tracking, SCAN Forms, and reports.
Does Pirate Ship by Cotlet require an API key?
The described connection method reads cookies from an authenticated Chrome session using Chrome DevTools Protocol. Run pirate-ship-mcp connect; the tool does not need to read or save your password.
