Pirate Ship MCP Server

为小型托运人提供标签、费率和追踪服务。

托管 MCP 服务器

npx add-mcp 'https://cotlet.dev/mcp/v1/pirate-ship'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up

Pirate Ship API and MCP server: Let your AI agent run your Pirate Ship shipping.

Pirate Ship has no API, no MCP server and no webhooks (checked 24 Oct 2026). Its help center says "Pirate Ship doesn't offer an API." Cotlet runs 57 Pirate Ship tools hosted, over MCP for agents and REST for scripts.

Read Pirate Ship shipments, tracking and shipping reports with your AI agent, n8n, Make, Zapier or a script. Use MCP or the REST API in your own signed-in account.

Connect an AI agent Use the REST API

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by Pirate Ship. Pirate Ship is a trademark of its owner. If Pirate Ship's own integrations cover what you need, use them first.

What can you automate in Pirate Ship?

  • Buy labels in bulk
  • Refund unused labels
  • Make the SCAN Form
  • Book a USPS or UPS pickup
  • Dispute carrier adjustments
  • Report shipping spend

Does Pirate Ship have an official API or MCP server?

  • The official ways in are 13 store integrations (Shopify, eBay, WooCommerce and 10 more) and spreadsheet upload. They bring orders in and write tracking back. Rates, purchases, refunds and pickups stay buttons in the web app.
  • No Zapier, Make or n8n app and no Claude or ChatGPT connector from Pirate Ship.
  • Open-source wrappers on GitHub call the web app's private GraphQL. Most only quote rates; the rest need a session cookie you copy.
What you needPirate Ship store integrationGitHub wrapperCotlet
Pull unshipped store ordersYes, by handNoYes, on a schedule
Rate and buy a batch of labelsClicks per batchRates, some buyYes, after your OK
Refunds, SCAN Forms and pickupsNoRefunds in oneYes
Runs with your computer offYesNoYes, hosted
Fixed for you when Pirate Ship changesYesNoYes

Checked 24 Oct 2026. Sources: Does Pirate Ship have an API? (help center), How to import from integrations (help center), What integrations does Pirate Ship have? (help center), Pirate Ship Terms of Use

How does Cotlet connect to Pirate Ship?

  1. Log in to Pirate Ship. Once, in a browser we host for you.
  2. Choose MCP or REST. Connect an AI agent or create a Cotlet API key for HTTP requests.
  3. Run your workflow. Ask your agent or call the REST API.

We never save your Pirate Ship password, and no label is bought or refunded without your OK.

Connect Pirate Ship to your AI agent or workflow

Use MCP with ChatGPT, Claude, Cursor or Codex. For n8n, Make or Zapier, use authenticated HTTP or a supported MCP client. The agent setup is below; the REST guide follows.

  1. Enable Pirate Ship for agents. Sign up, log in to Pirate Ship in its Cloud Browser and press Enable for agents.
  2. Add the Pirate Ship address. Paste https://cotlet.dev/mcp/v1/pirate-ship into your agent's MCP or connector settings.
  3. Sign in or paste a key. Chat apps sign you in to Cotlet; editors and scripts take an API key from the console.

The shared address https://cotlet.dev/mcp/v1 works too and carries every app you enabled. Turned Pirate Ship on later? Refresh the connector in your agent.

Claude:

Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet-pirate-ship \
  https://cotlet.dev/mcp/v1/pirate-ship \
  --header "Authorization: Bearer $COTLET_API_KEY"

ChatGPT:

Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth

Cursor:

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet-pirate-ship": {
      "url": "https://cotlet.dev/mcp/v1/pirate-ship",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}

Codex:

# ~/.codex/config.toml
[mcp_servers.cotlet-pirate-ship]
url = "https://cotlet.dev/mcp/v1/pirate-ship"
bearer_token_env_var = "COTLET_API_KEY"

n8n:

MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: pirate_ship_read

Make, Zapier:

Make: MCP Client > Call a tool
Zapier: MCP Client by Zapier > Run Tool
Server URL: https://cotlet.dev/mcp/v1
Token: <your key>
Tool: pirate_ship_write

How to use the Pirate Ship REST API

Create your Cotlet API key

Sign in to Pirate Ship in your Cloud Browser and enable it for agents. Create a Cotlet API key scoped to Pirate Ship; read-only access is enough for this example.

Store the key in your environment as COTLET_API_KEY. Use your Cotlet key, not your Pirate Ship password.

Make your first Pirate Ship API request

This GET /shipments request reads bought labels and their tracking details. Listing shipments buys nothing.

cURL: list_shipments:

curl "https://cotlet.dev/api/v1/pirate-ship/shipments?limit=10&offset=0" \
  -H "Authorization: Bearer $COTLET_API_KEY"

Read the response and page through shipments

A successful REST call returns status: "success" with the tool output in result. This JSON excerpt uses example data and omits call IDs, messages and credit details.

Example response excerpt:

{
  "status": "success",
  "app": "pirate-ship",
  "tool": "list_shipments",
  "result": {
    "total": 1,
    "shipments": [
      {
        "shipment_id": "1234567890",
        "tracking_number": "9400100000000000000000",
        "status": "Printed",
        "tracking_status": "In Transit",
        "carrier": "USPS",
        "cost_usd": 6.86
      }
    ]
  }
}

Read result.shipments and result.total. Increase offset by the same limit while offset + limit < total; there is no cursor. Keep filters unchanged. from_date and to_date filter label creation dates in your workspace timezone, not shipping or delivery dates. Costs are in USD.

Pirate Ship workflows with n8n, Make and Zapier

ToolConnect throughExample workflow
n8nHTTP RequestCompare shipment snapshots and notify your team when tracking status changes. Keep shipment ID to suppress repeated notices.
MakeHTTP > Make a requestRead shipping stats for a weekly label-spend and carrier-mix report, then save the selected metrics through your reporting steps.
ZapierWebhooks by Zapier > GET or Custom RequestRead shipment tracking numbers into external order-sheet reconciliation steps. Configure order matching in the sheet workflow.

Send Authorization: Bearer <your Cotlet API key> in the request headers. Configure the schedule and destination in your chosen tool. Cotlet reads the app data; your destination steps perform any spreadsheet, email or team-channel writes.

These are workflows you configure, not native connectors or prebuilt templates. Read periodically and track handled IDs to avoid duplicates; these workflows do not depend on outgoing app event webhooks.

In get_shipping_stats, some fields, including auto_refunded, are not scoped to the requested date window. Select the metrics your report needs. Label purchases, refunds and pickups are separate operations with their existing approval and billing rules.

Python or Node.js can make the same REST calls without an AI agent or an SDK. Use your own signed-in account and its permissions.

The API and MCP reference lists every method, path and input. The REST API guide covers request format, errors and approvals.

Pirate Ship API endpoints and MCP tools

Rates, labels and batches

Drafts and rates are free. A purchase takes the Account Balance first, then your card; up to 500 recipients a batch.

  • Get rates (get_rates, read): USPS and UPS services with price for one package, cheapest first.
  • Parse address (parse_address, read): Splits a pasted address into name, street, city, state, ZIP and country.
  • Search recipients (search_recipients, read): Past recipients' addresses matching a name, email or phone.
  • List package types (list_package_types, read): Packaging types per carrier (box, envelope, flat rate) and the size and weight limits.
  • Create shipment (create_shipment, write): Unpaid draft label for one package with every rate; buy it with buy_label.
  • Create batch (create_batch, write): Unpaid draft batch for many packages with the rates of each rate group; buy it with buy_label.
  • Get batch (get_batch, read): A draft or bought batch: shipments, tracking, rates to buy, what can be refunded.
  • List batches (list_batches, read): Latest batches and single labels, newest first, with status and tracking counts.
  • Rename batch (rename_batch, write): Change the title of a batch or single label.
  • Change ship date (change_ship_date, write): Moves a draft batch to another ship date and returns its new rates.
  • Buy label (buy_label, write, asks first): Buys the labels of a draft batch at the chosen rates; costs real money.
  • Download labels (download_labels, read): A download link for the printable labels of a batch or of chosen shipments.
  • Delete batch (delete_batch, write, asks first): Deletes an unpaid draft batch or single shipment.

Store orders

Only stores you connected in Pirate Ship yourself. Pirate Ship writes tracking back to them.

  • List store connections (list_store_connections, read): Stores and marketplaces connected to Pirate Ship for order import, with their status.
  • Sync store orders (sync_store_orders, write): Pulls new orders from every connected store into Pirate Ship's Import list.
  • List import orders (list_import_orders, read): Unshipped orders from your connected store integrations, as in the Import grid.
  • Create batch from orders (create_batch_from_orders, write): Turns store orders into a batch of shipments with one saved package; nothing is bought.
  • Ignore orders (ignore_orders, write): Hides store orders from the Import list without shipping them.
  • Unignore orders (unignore_orders, write): Put ignored store orders back on the Import list.

Shipments, refunds and adjustments

A refund request cannot be taken back, a scanned label cannot be refunded, and each label gets one dispute.

  • List shipments (list_shipments, read): Labels bought in Pirate Ship with recipient, tracking, cost and status, newest first.
  • Get shipment (get_shipment, read): One shipment with tracking, service, cost, recipient and carrier adjustments.
  • Export shipments (export_shipments, read): A CSV of the shipments report with every column, as a download link.
  • Refund label (refund_label, write, asks first): Requests a refund of one unused label.
  • Refund batch (refund_batch, write, asks first): Requests a refund of every unused label in a batch.
  • List refunds (list_refunds, read): Label refunds with their status and amount, newest request first.
  • List return labels (list_return_labels, read): List the account's pay-on-use return labels and whether each was used.
  • List carrier adjustments (list_carrier_adjustments, read): Extra charges or credits the carrier made after a label was used, with old and actual package.
  • Dispute adjustment (dispute_adjustment, write, asks first): Disputes the carrier adjustments of one label with your reason.

SCAN Forms and pickups

SCAN Forms are USPS only and final. USPS pickups are free; UPS charges your card.

  • List SCAN forms (list_scan_forms, read): USPS SCAN Forms per Ship From Address, with their PDF links and labels still without one.
  • Create SCAN Form (create_scan_form, write): USPS End of Day SCAN Form for the labels of one Ship Date, as a PDF link.
  • Get pickup quote (get_pickup_quote, read): What a USPS or UPS pickup would cost; USPS pickups are free. Nothing is booked.
  • Schedule pickup (schedule_pickup, write, asks first): Ask USPS or UPS to collect your packages, like Schedule a Pickup.
  • List pickups (list_pickups, read): Your scheduled and past USPS and UPS pickups with confirmation numbers.
  • Cancel pickup (cancel_pickup, write, asks first): Cancels a scheduled USPS or UPS pickup that can still be cancelled.

Balance, receipts and reports

Read only. Add Funds and payment methods stay with you.

  • Get account balance (get_account_balance, read): Account Balance, Pending Refunds and Pending Returns from the Reports page.
  • List transactions (list_transactions, read): Every charge, payment and refund on the Pirate Ship balance, newest first.
  • List receipts (list_receipts, read): Payments made to Pirate Ship, newest first; get_receipt shows one.
  • Get receipt (get_receipt, read): One payment to Pirate Ship with its billing address and the labels it paid for.
  • Get shipping stats (get_shipping_stats, read): Labels, spend, savings, tracking and where packages went for a date range, as on Reports.
  • Export report (export_report, read): A CSV of the transactions, refunds, receipts, return labels or carrier adjustments report.

Packages, addresses and tracking emails

The default Ship From Address cannot be deleted. Label format and tracking emails change for the whole account.

  • List saved packages (list_saved_packages, read): Your Saved Packages from Settings: size, weight and the extra services stored with each.
  • Create saved package (create_saved_package, write): Saves a package (type, size, weight, extra services) for reuse on labels.
  • Update saved package (update_saved_package, write): Changes a Saved Package; fields you leave out keep their values.
  • Delete saved package (delete_saved_package, write): Delete a Saved Package (box size and weight preset) from the account.
  • List ship-from addresses (list_ship_from_addresses, read): Your Ship From Addresses with their return addresses; one is the default.
  • Create ship-from address (create_ship_from_address, write): Adds a US Ship From Address, optionally with a separate return address.
  • Update ship-from address (update_ship_from_address, write): Changes a Ship From Address: its name, origin or return address.
  • Set default ship-from address (set_default_ship_from_address, write): Makes one Ship From Address the default for new shipments and rate quotes.
  • Delete ship-from address (delete_ship_from_address, write, asks first): Removes a saved Ship From Address. The default address cannot be removed.
  • Get label settings (get_label_settings, read): Read the account's label settings from Settings, General.
  • Update label settings (update_label_settings, write): Changes label size, file format, packing list, logo, QR codes, address correction or export format.
  • Get tracking email settings (get_tracking_email_settings, read): Read whether label recipients get a tracking email, when, and with which template.
  • Update tracking email settings (update_tracking_email_settings, write): Turns default tracking emails on or off and sets their delay after purchase.
  • List email templates (list_email_templates, read): List the templates of the tracking emails sent to label recipients.
  • Create email template (create_email_template, write): Adds a tracking email template for the emails recipients get with their tracking link.
  • Update email template (update_email_template, write): Changes a tracking email template; fields you leave out keep their values.
  • Delete email template (delete_email_template, write): Delete one tracking email template from the account.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/pirate-ship-api-mcp-server#tools

Who can see my Pirate Ship session, and how do I revoke it?

  • What we store. Your logged-in Pirate Ship profile, AES-256-GCM, in Finland. No password.
  • What your agent gets. Pirate Ship tools only. No cookie, no card number.
  • What the session sees. What your login sees: recipients, labels, balance, receipts.
  • What no tool touches. Payment methods, Add Funds, email, password, two-factor and team users.
  • If Pirate Ship logs you out. Its session lasts a day and we renew it. If it ends, you get a sign-in link.
  • How to cut access. Disable for agents, reset the browser or delete the key. The next call stops.

A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).

Approvals, undo and mistakes

  1. Lists 28 days of labels. The window in which Pirate Ship still refunds.
  2. Flags duplicates. Same recipient and Order ID, or a cancelled order.
  3. Waits for your OK. Each refund shows up in your Cotlet console.
  4. Reports the money. Refunded at once, pending with USPS, skipped.
ActionUndo
Buy labelsRefund unused ones within 28 days
Request a refundNo, Pirate Ship cannot cancel it
Create a SCAN FormNo, make a second one for late labels
Book a pickupCancel while it allows, UPS fee back
Dispute an adjustmentNo, one per label

8 of 57 tools ask first: every purchase, refund, pickup and dispute, and the deletes. Drafts and rates never do, since they cost nothing.

MCP call:

{
  "name": "create_shipment",
  "arguments": {
    "to": {
      "full_name": "Megan Price",
      "address1": "1 Infinite Loop",
      "city": "Cupertino",
      "state": "CA",
      "zip": "95014"
    },
    "packaging": "FlatRateEnvelope",
    "weight_oz": 8
  }
}

REST:

curl -X POST https://cotlet.dev/api/v1/pirate-ship/shipments \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":{"full_name":"Megan Price","address1":"1 Infinite Loop","city":"Cupertino","state":"CA","zip":"95014"},"packaging":"FlatRateEnvelope","weight_oz":8}'

Tool output:

{
  "status": "rated",
  "batch_id": "632577575",
  "ship_date": "2026-10-21",
  "shipment_count": 1,
  "rates": [
    {
      "rate_id": "domestic_light_and_small_business:144-6-0",
      "carrier": "USPS",
      "service": "Priority Mail Flat Rate Envelope",
      "price_usd": 9.92,
      "retail_usd": 13.9
    }
  ]
}

For read-only onboarding, see the REST API guide on this page. When Pirate Ship refuses a purchase, say with no balance and no card, the call fails and costs no credits.

How much do the Pirate Ship API and MCP server cost?

About $24 a month for a store that ships every weekday, 4,120 credits. Postage is still paid in Pirate Ship.

JobCallsCredits
Batch and buy the day's store orders7 × 221,540
SCAN Form and USPS pickup3 × 22660
Refund unused labels, weekly7 × 4280
Check carrier adjustments, weekly3 × 4120
Shipping spend report, monthly2 × 120
Cloud Browser, 30 days1,500
Total4,120
  • Free 7-day trial, no card
  • 10 credits per successful call, MCP or REST
  • 50 credits a day for the Cloud Browser
  • Pirate Ship itself stays free

Order count barely moves the bill: a batch of 10 or 400 orders is the same 7 calls. The month assumes 22 shipping days, our example, since no public figure exists. Dollars at the $29 pack rate.

Pirate Ship MCP server on GitHub, another platform or hosted: which to use

OptionWhat it doesWhere it stops
taciturnaxolotl/pirateship-apiTyped TypeScript wrapper for rate quotes, 19 stars, MIT.Rates only, a library and not an MCP server; last commit 19 Oct 2026.
christianobora/pirateship-apiGo client that also buys and refunds single labels.You bring the session cookie and run it; its README says Pirate Ship "does not publish or support" the API it calls.
Minimal AICustomer support agent that says it creates, voids and tracks Pirate Ship labels.Made for support tickets, not shipping runs; price only on a demo.
Shippo or EasyPostShipping platforms with their own official MCP servers.You leave Pirate Ship. Shippo is free up to 30 labels a month, then from $17 a month.

Take a GitHub wrapper if a script needs rate quotes. Move to Shippo or EasyPost if an official API matters more than Pirate Ship's rates. Take Cotlet to keep your Pirate Ship account and let an agent run the batches, refunds and pickups.

Run our Pirate Ship MCP server on your own computer

Our Pirate Ship tools are also on GitHub, as an MCP server and REST API in Python. Run them with your own Chrome, quote rates and draft labels on your account, and read how each tool talks to Pirate Ship. It is a trimmed version of what runs on cotlet.dev, free to use in your own business.

  • Free for personal use, learning and testing
  • Runs while your computer is on, logged in through your own Chrome
  • You update it when Pirate Ship changes its web app
  • License Elastic 2.0: free in your own business; ChatGPT, your phone and 24/7 runs need hosted Cotlet
  • Code: https://github.com/cotletdev/pirate-ship-api-mcp-server

Also listed on: Odel, mcpbeat

Who runs Cotlet

Cotlet is run by Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273), working since 2019. The founders are Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about the Pirate Ship tools go to contact@cotlet.dev.

Pirate Ship API and MCP: frequently asked questions

Can I use Pirate Ship with n8n, Make or Zapier through Cotlet?

Yes. Use authenticated REST requests or a supported MCP client. Configure schedules, destinations and record tracking in your chosen automation tool. The REST section above gives app-specific workflows.

Can I use the Pirate Ship API without an AI agent?

Yes. A script or HTTP step can call the REST endpoints with your Cotlet API key. Sign in to the app in your Cloud Browser first; no agent connection is required.

How do I get access?

Sign up free at https://cotlet.dev, open Pirate Ship under Integrations in the console and log in to Pirate Ship in its Cloud Browser. Your free trial starts when you sign up, no card needed.

How do I connect Pirate Ship to ChatGPT or Claude?

Sign up at cotlet.dev, log in to Pirate Ship once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your Pirate Ship account through Cotlet, in their phone apps too.

What can ChatGPT do in Pirate Ship?

With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in Pirate Ship: buy shipping labels in bulk; ship store orders at the cheapest rate; refund unused shipping labels. You ask in plain words, and anything that reaches other people waits for your OK first.

Do I need money in my Account Balance?

Not if your Pirate Ship account has a payment method. buy_label uses the Account Balance first and charges the default payment method for the rest, at least $1 or your set charge amount, as the buy page does. With neither, Pirate Ship refuses the purchase. Drafts, rates, reports and settings cost nothing in Pirate Ship.

Can the agent add insurance to a whole batch?

Yes. create_batch takes insured_value_usd for every shipment in the batch, or a Saved Package that already carries insurance through package_preset_id. A spreadsheet uploaded by hand cannot carry insurance, which is why Pirate Ship's help center points to Saved Packages.

Does it work with my Shopify or Etsy store?

Yes, once the store is connected in Pirate Ship. Connecting is OAuth or the store's API keys, so you do it once yourself in Pirate Ship's Settings. After that sync_store_orders pulls new orders, list_import_orders lists them and create_batch_from_orders turns them into a batch.

What can it not do yet?

Cotlet never changes your email, password, name, two-factor settings, team users or payment methods, and it does not connect stores: those stay with you in Pirate Ship. Package intercept and return to sender for a shipped label are not built, nor are custom sender domains for tracking emails. Customs forms for international labels are not part of create_shipment and create_batch.

Does Pirate Ship have webhooks?

No. Pirate Ship sends no events out, and its store integrations only pull orders in and push tracking back. To react to new orders, run your agent on a schedule with sync_store_orders and list_import_orders.

Does Pirate Ship charge for this?

No. Pirate Ship is free and you pay only postage, in Pirate Ship, as before. Cotlet credits pay for the agent's calls and the Cloud Browser.

Is the MCP server different from the REST API?

Only the way in. Both have the same 57 tools, inputs and answers, one API key and one price. Agents use MCP; scripts, cron jobs and HTTP steps use REST.

Is Cotlet affiliated with Pirate Ship?

No. Cotlet is independent and not affiliated with Pirate Ship.


Give your AI agents your signed-in browser.

Product: Integrations · How it works · Pricing · Security

Resources: Blog · API docs · Help center · Changelog · GitHub

Solutions: For developers · For automation agencies

Company: About · AI info: company facts · Contact

Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors

Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.