Pirate Ship MCP
# 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.
## Connect in 2 minutes
Get your API key at https://cotlet.dev/app and export it as `COTLET_API_KEY`.
### Claude Code
```bash
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:
```json
{
"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.
```json
{"mcpServers":{"pirate-ship":{"command":"uvx","args":["pirate-ship-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}
```
Or with Docker:
```bash
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:
```bash
pip install pirate-ship-mcp # or run it once: uvx pirate-ship-mcp connect
pirate-ship-mcp connect
```
Or straight from this repo:
```bash
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
- [Pirate Ship on Cotlet.dev](https://cotlet.dev/integrations/pirate-ship-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=pirate-ship&utm_content=find)
- [PyPI package pirate-ship-mcp](https://pypi.org/project/pirate-ship-mcp/)
- [Odel](https://odel.app/modules/cotlet/pirate-ship)
- [mcpbeat](https://mcpbeat.com/mcp-servers/cotlet/pirate-ship/)
- [Step-by-step guide (PDF) on Internet Archive](https://archive.org/details/cotlet-connect-pirate-ship-to-ai-agents-guide)
## Also works with
- [shippo MCP](https://github.com/cotlet-connect/shippo-mcp)
- [easypost MCP](https://github.com/cotlet-connect/easypost-mcp)
- [Mangomint MCP](https://github.com/cotlet-connect/mangomint-mcp)
- [Wanderlog MCP](https://github.com/cotlet-connect/wanderlog-mcp)
- [SmugMug MCP](https://github.com/cotlet-connect/smugmug-mcp)
- [Garmin Connect MCP](https://github.com/cotlet-connect/garmin-mcp)
- [Housecall Pro MCP](https://github.com/cotlet-connect/housecall-pro-mcp)
- [Medium MCP](https://github.com/cotlet-connect/medium-mcp)
- [Crexi MCP](https://github.com/cotlet-connect/crexi-mcp)
- [DistroKid MCP](https://github.com/cotlet-connect/distrokid-mcp)
- [LinkedIn MCP](https://github.com/cotlet-connect/linkedin-mcp)
- [EstimateOne MCP](https://github.com/cotlet-connect/estimateone-mcp)
- [Google Search Console MCP](https://github.com/cotlet-connect/google-search-console-mcp)
- [Lichess MCP](https://github.com/cotlet-connect/lichess-mcp)
- [Strava MCP](https://github.com/cotlet-connect/strava-mcp)
- [StreamElements MCP](https://github.com/cotlet-connect/streamelements-mcp)
- [Meetup MCP](https://github.com/cotlet-connect/meetup-mcp)
- [AccuRanker MCP](https://github.com/cotlet-connect/accuranker-mcp)
- [GetYourGuide MCP](https://github.com/cotlet-connect/getyourguide-mcp)
- [Idealista MCP](https://github.com/cotlet-connect/idealista-mcp)
- [Riverside MCP](https://github.com/cotlet-connect/riverside-mcp)
- [Udemy MCP](https://github.com/cotlet-connect/udemy-mcp)
- [Faire MCP](https://github.com/cotlet-connect/faire-mcp)
- [Teachable MCP](https://github.com/cotlet-connect/teachable-mcp)
- [Vagaro MCP](https://github.com/cotlet-connect/vagaro-mcp)
- [Buildertrend MCP](https://github.com/cotlet-connect/buildertrend-mcp)
- [Zoopla MCP](https://github.com/cotlet-connect/zoopla-mcp)
- [Dribbble MCP](https://github.com/cotlet-connect/dribbble-mcp)
- [Hostelworld MCP](https://github.com/cotlet-connect/hostelworld-mcp)
- [Mashvisor MCP](https://github.com/cotlet-connect/mashvisor-mcp)
- [Rent Manager MCP](https://github.com/cotlet-connect/rent-manager-mcp)
- [ThriveCart MCP](https://github.com/cotlet-connect/thrivecart-mcp)
- [Fresha MCP](https://github.com/cotlet-connect/fresha-mcp)
- [Booksy MCP](https://github.com/cotlet-connect/booksy-mcp)
- [BookingKoala MCP](https://github.com/cotlet-connect/bookingkoala-mcp)
- [Milanote MCP](https://github.com/cotlet-connect/milanote-mcp)
- [Partiful MCP](https://github.com/cotlet-connect/partiful-mcp)
- [Contractor Foreman MCP](https://github.com/cotlet-connect/contractor-foreman-mcp)
- [Pixieset MCP](https://github.com/cotlet-connect/pixieset-mcp)
- [GlossGenius MCP](https://github.com/cotlet-connect/glossgenius-mcp)
- [ZenMaid MCP](https://github.com/cotlet-connect/zenmaid-mcp)
- [AroFlo MCP](https://github.com/cotlet-connect/aroflo-mcp)
- [Simpro MCP](https://github.com/cotlet-connect/simpro-mcp)
- [Workiz MCP](https://github.com/cotlet-connect/workiz-mcp)
- [Kickserv MCP](https://github.com/cotlet-connect/kickserv-mcp)
- [Service Autopilot MCP](https://github.com/cotlet-connect/service-autopilot-mcp)
- [Boulevard MCP](https://github.com/cotlet-connect/boulevard-mcp)
- [Mindbody MCP](https://github.com/cotlet-connect/mindbody-mcp)
- [Meevo MCP](https://github.com/cotlet-connect/meevo-mcp)
- [DaySmart MCP](https://github.com/cotlet-connect/daysmart-mcp)
- [Acuity Scheduling MCP](https://github.com/cotlet-connect/acuity-scheduling-mcp)
- [Jane App MCP](https://github.com/cotlet-connect/jane-app-mcp)
- [FieldEdge MCP](https://github.com/cotlet-connect/fieldedge-mcp)
- [Phorest MCP](https://github.com/cotlet-connect/phorest-mcp)
- [DINGG MCP](https://github.com/cotlet-connect/dingg-mcp)
- [Invoice Simple MCP](https://github.com/cotlet-connect/invoice-simple-mcp)
- [PhotoShelter MCP](https://github.com/cotlet-connect/photoshelter-mcp)
- [RazorSync MCP](https://github.com/cotlet-connect/razorsync-mcp)
- [ShootProof MCP](https://github.com/cotlet-connect/shootproof-mcp)
- [Invoice2go MCP](https://github.com/cotlet-connect/invoice2go-mcp)
- [Appointy MCP](https://github.com/cotlet-connect/appointy-mcp)
- [Contractor+ MCP](https://github.com/cotlet-connect/contractor-plus-mcp)
- [Petpooja MCP](https://github.com/cotlet-connect/petpooja-mcp)
- [Teachers Pay Teachers MCP](https://github.com/cotlet-connect/teachers-pay-teachers-mcp)
- [Bloom MCP](https://github.com/cotlet-connect/bloom-mcp)
- [AestheticsPro MCP](https://github.com/cotlet-connect/aestheticspro-mcp)
- [Club OS MCP](https://github.com/cotlet-connect/club-os-mcp)
- [EZ Lawn Biller MCP](https://github.com/cotlet-connect/ez-lawn-biller-mcp)
- [Eversports Studio Manager MCP](https://github.com/cotlet-connect/eversports-studio-manager-mcp)
- [Exercise.com MCP](https://github.com/cotlet-connect/exercise-com-mcp)
- [Gymdesk MCP](https://github.com/cotlet-connect/gymdesk-mcp)
- [Iris Works MCP](https://github.com/cotlet-connect/iris-works-mcp)
- [CoachingPortal MCP](https://github.com/cotlet-connect/coachingportal-mcp)
- [CrewNest MCP](https://github.com/cotlet-connect/crewnest-mcp)
- [Paired Plus MCP](https://github.com/cotlet-connect/paired-plus-mcp)
- [ClubReady MCP](https://github.com/cotlet-connect/clubready-mcp)
- [Joist MCP](https://github.com/cotlet-connect/joist-mcp)
- [Trainerize MCP](https://github.com/cotlet-connect/trainerize-mcp)
- [Substack MCP](https://github.com/cotlet-connect/substack-mcp)
- [All apps connected through Cotlet.dev](https://github.com/cotlet-connect)
---
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
TDQS
Scored across 7 tools
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').
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.
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.
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.