Pirate Ship MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Pirate Ship MCP list my recent shipments and flag any delayed packages"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpTools: 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 connectOr 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
Start free: https://cotlet.dev/signup?app=pirate-ship&utm_source=github&utm_medium=readme&utm_campaign=pirate-ship
Available Tools
7 toolspirate_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
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.
Related MCP Connectors
Pirate Ship MCP server for ChatGPT, Claude and any AI agent: get rates, buy labels in bulk, import orders, track shipment and refund labels in your own Pirate Ship account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Pirate Ship yourself; Cotlet does not store your password and you need no Pirate Ship API key. About the official Pirate Ship API: Pirate Ship has no API (checked 11 Oct 2026). Its help center says so and points to store integrations and spreadsheet uploads instead. Setup and FAQ: https://cotlet.dev/integrations/pirate-ship-api-mcp-server
Multi-carrier shipping for AI agents: compare rates, buy labels, track packages, validate addresses
Connect AI agents to 1000+ apps with managed authentication and tool-calling.
Connect AI to store orders, products and inventory with scoped access and human approvals.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to create shipments, track packages, get rates, validate addresses, schedule pickups, and find UPS locations via the UPS API.910 npm2MIT

Easyship MCPofficial
AlicenseNot gradedqualityDmaintenanceEnables AI agents to manage global shipping operations, including rate comparison, shipment creation, label purchasing, tracking, pickup scheduling, address validation, billing, and analytics, via natural language.MIT- AlicenseAqualityDmaintenanceEnables AI clients to quote, ship, track, void, and manage shipments via the Deftship multi-carrier shipping API using natural language commands.32MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to buy US shipping labels (USPS, UPS, FedEx) with automatic cheapest-rate selection, track parcels, and refund unused labels via the EasyPost API. Stateless, bring-your-own API key, free test keys available.MIT