# Pirate Ship by Cotlet

Connect an AI coding agent to Pirate Ship to check postage prices, prepare label drafts, and retrieve shipment tracking through an authenticated Chrome session.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2
- Author: cotletdev
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cotletdev/pirate-ship-api-mcp-server
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/pirate-ship-by-cotlet

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://cotlet.dev/mcp/v1/pirate-ship/connect`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http pirate-ship https://cotlet.dev/mcp/v1/pirate-ship/connect
```

2. **Platform CLI**
```bash
claude mcp add pirate-ship-by-cotlet -- uvx 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>

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add pirate-ship-by-cotlet --url https://cotlet.dev/mcp/v1/pirate-ship/connect
```

2. **Platform CLI**
```bash
codex mcp add pirate-ship-by-cotlet -- uvx 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>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pirate-ship-by-cotlet": {
            "url": "https://cotlet.dev/mcp/v1/pirate-ship/connect"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "pirate-ship-by-cotlet": {
            "type": "http",
            "url": "https://cotlet.dev/mcp/v1/pirate-ship/connect"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http pirate-ship-by-cotlet https://cotlet.dev/mcp/v1/pirate-ship/connect
```

2. **Platform CLI**
```bash
gemini mcp add pirate-ship-by-cotlet uvx 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>

## When to use it
- 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
- 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.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24271
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18779
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9369
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7548

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md