Skip to main content
Glama

Pirate Ship API and MCP server

Yes, Claude, ChatGPT and other AI agents can work with your Pirate Ship account. Pirate Ship has no official public API or MCP server. Cotlet.dev connects your own signed-in Pirate Ship account so you can review shipments, compare rates and prepare labels with plain-language requests.

What you can ask

List my recent shipments and flag delayed packages.

Compare USPS and UPS rates for these packages.

Prepare labels for the approved orders and show me the totals.

Which labels were refunded this month?

Draft tracking updates for customers with delayed shipments.

Related MCP server: Easyship MCP

Connect in 2 minutes

Get your API key at https://cotlet.dev/app and export it as COTLET_API_KEY.

Claude Code

claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"

ChatGPT

Settings → Apps → add connector URL https://cotlet.dev/mcp/v1, then sign in with Cotlet.dev. No API key needed.

Cursor

Copy .cursor/mcp.json from this repo into your project:

{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${COTLET_API_KEY}"
      }
    }
  }
}

Run it locally (stdio)

This repo is a real MCP server. It speaks MCP over stdio, lists its Pirate Ship tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.

{"mcpServers":{"pirate-ship":{"command":"uvx","args":["pirate-ship-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}

Or with Docker:

docker build -t pirate-ship-mcp .
docker run -i --rm -e COTLET_API_KEY pirate-ship-mcp

Tools: pirate_ship_guide, pirate_ship_status, pirate_ship_open, pirate_ship_read, pirate_ship_click, pirate_ship_type, pirate_ship_close. Without COTLET_API_KEY a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".

Command line

Python 3.10+, nothing else to install. From PyPI:

pip install pirate-ship-mcp        # or run it once: uvx pirate-ship-mcp connect
pirate-ship-mcp connect

Or straight from this repo:

export COTLET_API_KEY="your-key"
python3 pirate_ship_agent.py connect   # ready config for Claude Code, Cursor, ChatGPT
python3 pirate_ship_agent.py status    # is Pirate Ship ready in your Cotlet.dev account
python3 pirate_ship_agent.py guide     # Pirate Ship screens and sign-in link
python3 pirate_ship_agent.py read      # open Pirate Ship, read the page, close the browser
python3 pirate_ship_agent.py tools     # list Cotlet.dev tools
python3 pirate_ship_agent.py serve     # start the stdio MCP server (same as no argument)

Questions from Pirate Ship users

Does Pirate Ship have an official API?

Pirate Ship does not publish a self-service public API or official MCP server. Cotlet.dev works in your own Pirate Ship account through its hosted connection.

How do I connect Pirate Ship to ChatGPT?

Add Cotlet.dev as an app in ChatGPT with connector URL https://cotlet.dev/mcp/v1, sign in to Pirate Ship in your Cotlet.dev Cloud Browser, and ask ChatGPT in plain words.

Can Claude work with Pirate Ship?

Yes. Add https://cotlet.dev/mcp/v1 as a custom connector in Claude, or use the Claude Code command shown in the repository README.

Can the AI buy postage automatically?

The hosted connection can prepare and review shipping workflows. Review postage purchases, refunds and address changes before confirming them.

Find it on

Also works with


More: https://cotlet.dev/integrations/pirate-ship-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=pirate-ship

Start free: https://cotlet.dev/signup?app=pirate-ship&utm_source=github&utm_medium=readme&utm_campaign=pirate-ship

Available Tools

7 tools
pirate_ship_clickB

Click a numbered element on the current Pirate Ship page.

Inputs: element (required).

pirate_ship_closeA

Close the Pirate Ship browser session when the work is done, so credits stop running.

Inputs: no named parameters.

pirate_ship_guideA

How to work in Pirate Ship (shipments, rates and labels): its screens and the sign-in link. Call this first.

Inputs: task.

pirate_ship_openB

Open a Pirate Ship page in your signed-in Cloud Browser (default https://www.pirateship.com) to work with shipments, rates and labels.

Inputs: url.

pirate_ship_readB

Read the current Pirate Ship page: its text and numbered buttons, links and fields.

Inputs: element.

pirate_ship_statusA

Check that your Cotlet.dev account and Pirate Ship are ready: account, credits and Pirate Ship connection.

Inputs: no named parameters.

pirate_ship_typeB

Type text into a numbered field on the current Pirate Ship page.

Inputs: text (required), element (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool maps to a distinct phase of browser work: onboarding (guide, status), session lifecycle (open, close), observation (read), and interaction (click, type). The boundaries between them are crisp, and the descriptions explicitly state when each should be used (e.g. guide says 'call this first').

    Naming Consistency4/5

    All seven tools share the pirate_ship_ snake_case prefix, which makes them trivially groupable. The suffix mixes nouns (guide, status) with verbs (open, read, close, click, type), a minor deviation from a pure verb_noun pattern but still highly readable.

    Tool Count5/5

    Seven tools is well-scoped for a single-site browser automation surface, with no filler. Each tool corresponds to an operation an agent actually needs: prepare, connect, observe, act, disconnect.

    Completeness4/5

    The surface covers the full session lifecycle plus read/click/type, which is enough to complete most shipment, rate, and label flows. Minor gaps remain (no explicit navigate-to-URL, scroll, or wait/press-enter tool), though open takes a URL and clicking handles most navigation.

    Related MCP Connectors

    Related MCP Servers