# Pirate Ship by Cotlet (pypi · pirate-ship-api-mcp)

Labels, rates and tracking for small shippers.

- Trust score: 78/100 (medium)
- Change this week: +15
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- remote · `cotlet.dev`: 73/100, [markdown](https://verifymcp.io/servers/dev-cotlet-pirate-ship/mcp-v1-pirate-ship.md), [page](https://verifymcp.io/servers/dev-cotlet-pirate-ship/mcp-v1-pirate-ship)
- remote · `cotlet.dev`: 40/100, [markdown](https://verifymcp.io/servers/dev-cotlet-pirate-ship/mcp-v1-pirate-ship-connect.md), [page](https://verifymcp.io/servers/dev-cotlet-pirate-ship/mcp-v1-pirate-ship-connect)
- pypi · `pirate-ship-api-mcp`: 78/100 (this document), [markdown](https://verifymcp.io/servers/dev-cotlet-pirate-ship/pirate-ship-api-mcp.md), [page](https://verifymcp.io/servers/dev-cotlet-pirate-ship/pirate-ship-api-mcp)

## Channel facts

- Registry: `pypi`
- Package: `pirate-ship-api-mcp`
- Version: `1.0.3`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - Runs hatchling.build at install time, a recognised build step with no custom scripting around it.
  - 0 of 36 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 84/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to cotletdev/pirate-ship-api-mcp-server).
  - License check failed: the license (PolyForm-Noncommercial-1.0.0) isn't a recognized OSI-approved license.
  - Actively maintained (last published 8 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 78/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 6589 tokens (~124/item across 53 items; 51 tools + 2 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 87/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 60% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 4 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 53 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### How do I install the Pirate Ship by Cotlet MCP server?

Pirate Ship by Cotlet runs locally as a PyPI package, launched with uvx pirate-ship-api-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add dev-cotlet-pirate-ship -- uvx pirate-ship-api-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "dev-cotlet-pirate-ship": {
      "command": "uvx",
      "args": [
        "pirate-ship-api-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "dev-cotlet-pirate-ship": {
      "command": "uvx",
      "args": [
        "pirate-ship-api-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add dev-cotlet-pirate-ship -- uvx pirate-ship-api-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "dev-cotlet-pirate-ship": {
      "type": "local",
      "command": [
        "uvx",
        "pirate-ship-api-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add dev-cotlet-pirate-ship --command uvx --arg pirate-ship-api-mcp
```

### Hermes

```yaml
mcp_servers:
  dev-cotlet-pirate-ship:
    command: "uvx"
    args: ["pirate-ship-api-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "dev-cotlet-pirate-ship": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "pirate-ship-api-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add dev-cotlet-pirate-ship -t stdio -c uvx -a pirate-ship-api-mcp
```

### Other

```json
{
  "mcpServers": {
    "dev-cotlet-pirate-ship": {
      "command": "uvx",
      "args": [
        "pirate-ship-api-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-05 (score 78, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-10-29 (score 63, −15)

- [security regression] Malware scan: pass → unverified

### 2026-10-25 (score 78, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-10-24 (score 63)

First indexed and scored.

## MCP tools (51)

### `change_ship_date` (~91 tokens)

Change ship date

Moves a draft batch to another ship date and returns its new rates.

The ship date on Pirate Ship's buy page: rates are fetched again for that day, so prices and estimated delivery can change. Pick a date from a rate's ship_dates. Works on drafts only.

Input parameters:

- `batch_id` (string, required)
- `ship_date` (string, required): One of the rate's ship_dates (YYYY-MM-DD).

### `create_batch` (~268 tokens)

Create batch

Unpaid draft batch for many packages with the rates of each rate group; buy it with buy_label.

Pirate Ship's spreadsheet upload: one batch for up to 500 recipients from your ship-from address, rated by Pirate Ship. The package (packaging, weight_oz and size, or package_preset_id) applies to every shipment; a recipient's own weight_oz or size overrides it. Pirate Ship splits the batch into rate groups (domestic small, big or heavy, international): buy_label needs one rate_id per group. errors counts rows Pirate Ship could not rate (an address it cannot find); get_batch shows them. Nothing is charged; delete_batch drops the draft.

Input parameters:

- `height_in` (number)
- `insured_value_usd` (number)
- `length_in` (number)
- `package_preset_id` (string): A saved package: its type, size and weight replace the fields above.
- `packaging` (string)
- `ship_from_id` (string): Ship-from address id; default: the account's default.
- `shipments` (array, required)
- `signature` (string)
- `title` (string, required): Batch name.
- `weight_oz` (number): Weight in ounces.
- `width_in` (number)

### `create_batch_from_orders` (~157 tokens)

Create batch from orders

Turns store orders into a batch of shipments with one saved package; nothing is bought.

Creates a Pirate Ship batch from imported orders: recipients come from the orders, size and weight from the saved package. The batch is rated, not paid: no label is bought. Large batches are built in the background (progress in the answer).

Input parameters:

- `order_ids` (array, required): Order ids from list_import_orders.
- `override_multiple` (boolean): Use the saved package also for orders with several items.
- `package_id` (string, required): Saved package id from list_saved_packages.
- `ship_from_id` (string): From list_ship_from_addresses. Default: the default one.
- `title` (string): Batch name. Default: today's date.

### `create_email_template` (~183 tokens)

Create email template

Adds a tracking email template for the emails recipients get with their tracking link.

Saves a new tracking email template. Nothing is sent now: Pirate Ship uses the template when a label is bought with tracking emails on. html takes the placeholders [Recipient First Name], [Ship Date], [Shipping Service], [Recipient Address] and [Tracking #].

Input parameters:

- `bcc_email` (string): A copy of every email goes here. Empty for none.
- `default` (boolean): Use it for new labels.
- `html` (string, required): Body as HTML. Placeholders: [Recipient First Name], [Ship Date], [Shipping Service], [Recipient Address], [Tracking #].
- `name` (string, required): Template name in Settings.
- `sender_email` (string, required): Reply-to address recipients see.
- `sender_name` (string, required)
- `subject` (string, required)

### `create_saved_package` (~224 tokens)

Create saved package

Saves a package (type, size, weight, extra services) for reuse on labels.

Adds a Saved Package in Settings. Parcel, SoftEnvelope and Irregular need length_in and width_in, a box also height_in; flat rate packaging needs none. weight_oz 0 leaves the weight to each label. default true preselects it on new shipments.

Input parameters:

- `default` (boolean): Preselect it on new shipments.
- `hazardous_materials` (boolean)
- `height_in` (number)
- `insured_value_usd` (number)
- `irregular` (boolean)
- `length_in` (number)
- `media_mail` (boolean): Qualifies for USPS Media Mail.
- `packaging` (string, required)
- `return_label` (string): return: return labels only; standard_and_return: an extra return label.
- `signature` (string)
- `title` (string, required): Name shown in Saved Packages.
- `weight_oz` (number): 0 leaves the weight to each label.
- `width_in` (number)

### `create_scan_form` (~153 tokens)

Create SCAN Form

USPS End of Day SCAN Form for the labels of one Ship Date, as a PDF link.

Puts the USPS labels of one Ship Date and Ship From Address (or of one batch) that have no SCAN Form yet on a new SCAN Form and returns its PDF link. The carrier scans that one sheet instead of every package. No labels without a form: Pirate Ship answers with an error.

Input parameters:

- `batch_id` (string): Only the labels of this batch (ignores ship_date).
- `from_address_id` (string): Ship From Address, when you ship from more than one. Default: the default one.
- `ship_date` (string): Labels of this Ship Date. Default: today.

### `create_ship_from_address` (~104 tokens)

Create ship-from address

Adds a US Ship From Address, optionally with a separate return address.

Saves a new Ship From Address in Pirate Ship. Without return_address, returns go to the origin. Pirate Ship completes the ZIP+4. It does not become the default: call set_default_ship_from_address for that.

Input parameters:

- `origin` (object, required)
- `return_address` (object): Where returns go. Default: the origin.
- `title` (string, required): Name in the address list.

### `create_shipment` (~326 tokens)

Create shipment

Unpaid draft label for one package with every rate; buy it with buy_label.

Pirate Ship's Single Shipment form up to Get Rates: makes a draft batch for one package from your ship-from address to the recipient and returns its rates (USPS and UPS services with your price, retail price, estimated delivery, possible ship dates). Nothing is charged; buy_label buys one of the rates, delete_batch drops the draft. Give the package as packaging, weight_oz and size, or package_preset_id of a saved package. When Pirate Ship suggests a corrected address and address_correction is ask, the answer is status address_correction with the suggestion and no draft: call again with accept or skip.

Input parameters:

- `address_correction` (string): When Pirate Ship suggests a corrected address: ask returns the suggestion without a draft, accept ships to the suggestion, skip keeps the address as given.
- `height_in` (number)
- `insured_value_usd` (number)
- `length_in` (number)
- `package_preset_id` (string): A saved package: its type, size and weight replace the fields above.
- `packaging` (string)
- `rubber_stamp_1` (string): Extra text printed on the label.
- `rubber_stamp_2` (string)
- `ship_from_id` (string): Ship-from address id; default: the account's default.
- `signature` (string)
- `to` (object, required)
- `weight_oz` (number): Weight in ounces.
- `width_in` (number)

### `delete_batch` (~60 tokens)

Delete batch

Deletes an unpaid draft batch or single shipment.

Removes a draft from create_shipment (or any batch not yet bought) from Pirate Ship. Bought labels cannot be deleted: refund_label or refund_batch returns their cost.

Input parameters:

- `batch_id` (string, required)

### `delete_email_template` (~28 tokens)

Delete email template

Removes a tracking email template.

Input parameters:

- `template_id` (string, required): id from list_email_templates.

### `delete_saved_package` (~35 tokens)

Delete saved package

Removes a Saved Package. Labels made with it are not affected.

Input parameters:

- `package_id` (string, required): id from list_saved_packages.

### `delete_ship_from_address` (~73 tokens)

Delete ship-from address

Removes a saved Ship From Address. The default address cannot be removed.

Deletes one Ship From Address from Settings. Labels already bought are not affected. Pirate Ship keeps at least one address and never deletes the default: make another one the default first.

Input parameters:

- `address_id` (string, required): id from list_ship_from_addresses.

### `download_labels` (~107 tokens)

Download labels

A download link for the printable labels of a batch or of chosen shipments.

Pirate Ship's Print Labels: builds one file with the bought, printable labels of batch_id or of shipment_ids, in the account's label size and format (Settings, Label Settings), and returns its link. Building takes a few seconds. Refunded labels and return labels that print later are left out.

Input parameters:

- `batch_id` (string): Every printable label of this batch.
- `shipment_ids` (array)

### `export_report` (~151 tokens)

Export report

A CSV of the transactions, refunds, receipts, return labels or carrier adjustments report.

Builds the same spreadsheet as the Export button of the chosen Reports table, with every column of the matching list_ tool, for an optional date range and search. Returns a link to the CSV; no matching rows return empty true and no link. Shipments have their own tool, export_shipments.

Input parameters:

- `from_date` (string): First day, YYYY-MM-DD, in your timezone.
- `report` (string, required)
- `search` (string): Free text, as in the report's search box.
- `sort` (string)
- `to_date` (string): Last day, YYYY-MM-DD, included.

### `export_shipments` (~231 tokens)

Export shipments

A CSV of the shipments report with every column, as a download link.

Builds the same spreadsheet as the Export button of Reports, Shipments: one row per label with every column (recipient and address, tracking, carrier and service, cost, package, batch, ship-from, order id, rubber stamps). Takes the filters of list_shipments. Returns a link to the CSV; a filter with no matching labels returns empty true and no link. Large exports can take up to a minute.

Input parameters:

- `batch` (array): Batch titles.
- `carrier` (array): USPS or UPS.
- `from_date` (string): First day, YYYY-MM-DD, in your timezone.
- `search` (string): Free text, as in the report's search box.
- `sort` (string)
- `status` (array): Label status as the report shows it, e.g. Printed, Refunded.
- `to_date` (string): Last day, YYYY-MM-DD, included.
- `tracking_status` (array): Tracking status as the report shows it, e.g. Delivered, In Transit.

### `get_account_balance` (~82 tokens)

Get account balance

Account Balance, Pending Refunds and Pending Returns from the Reports page.

The Pirate Ship account balance in US dollars (balance_settled_usd leaves out payments still settling), how many payment methods are saved, refunds and return labels still pending, and the last 30 days of labels as the Reports page shows them: label count, total, average and payments.

### `get_batch` (~115 tokens)

Get batch

A draft or bought batch: shipments, tracking, rates to buy, what can be refunded.

One Pirate Ship batch: a single label from create_shipment is a batch of one. A draft (step Rated) lists every rate the packages qualify for, with rate_id for buy_label. A bought batch (Billed) shows each shipment's status, tracking number and link, whether its label can be printed or refunded, and what was paid per service.

Input parameters:

- `batch_id` (string, required): From create_shipment or list_batches.

### `get_label_settings` (~85 tokens)

Get label settings

Label size and file format, packing list, logo, QR codes, address correction, export format.

The account's Settings, General: the size and file format new labels are made in, whether a packing list prints with them, the logo on the label, USPS label-free QR codes, what happens when Pirate Ship finds a better address, and the spreadsheet format of report exports.

### `get_pickup_quote` (~186 tokens)

Get pickup quote

What a USPS or UPS pickup would cost; USPS pickups are free. Nothing is booked.

Prices one pickup without booking it. USPS collects for free on the next delivery day. UPS charges per pickup and needs a date and a ready and close time; surcharges are listed apart.

Input parameters:

- `carrier` (string, required)
- `close_time` (string): UPS only.
- `date` (string): UPS only: pickup day. USPS comes next delivery day.
- `instructions` (string): Where to find the packages, with OTHER.
- `location` (string)
- `overweight` (boolean): UPS: a package over 70 lb.
- `package_count` (integer, required)
- `ready_time` (string): UPS only.
- `ship_from_id` (string): From list_ship_from_addresses. Default: the default one.
- `total_weight_oz` (number, required)

### `get_rates` (~216 tokens)

Get rates

USPS and UPS services with price for one package, cheapest first.

Pirate Ship's Quick Rate Quote: every USPS and UPS service that can carry one package from your default ship-from address to to_zip, with your price and the retail price, the zone and the estimated delivery. Weight in ounces (2 lb = 32). Parcel, SoftEnvelope and Irregular need length_in and width_in, a box also height_in: size changes the price (cubic and dimensional pricing). Flat rate envelopes and boxes need only the weight. Services that cannot carry the package are left out. Nothing is bought.

Input parameters:

- `height_in` (number)
- `length_in` (number)
- `packaging` (string)
- `residential` (boolean): The destination is a home.
- `to_country` (string): Destination country, ISO 3166-1 alpha-2.
- `to_zip` (string, required): Destination ZIP or postcode.
- `weight_oz` (number, required): Weight in ounces.
- `width_in` (number)

### `get_receipt` (~98 tokens)

Get receipt

One payment to Pirate Ship with its billing address and the labels it paid for.

The receipt page of one payment from list_receipts: title, status, total and refunded amount in US dollars, the billing address, the balance before and after, every transaction it covered (labels, refunds, adjustments, with batch_id and shipment_id) and reversals such as chargebacks.

Input parameters:

- `receipt_id` (string, required): receipt_id from list_receipts.

### `get_shipment` (~127 tokens)

Get shipment

One shipment with tracking, service, cost, recipient and carrier adjustments.

The shipment page of a Pirate Ship label: status, carrier and service, zone, tracking number and link, recipient, package, base and total cost with surcharges and insurance in US dollars, estimated delivery, the store order it came from, whether it can be printed or refunded, and carrier adjustments (weight or size the carrier corrected, with the price change and dispute state).

Input parameters:

- `batch_id` (string): Saves one request when known.
- `shipment_id` (string, required): From get_batch or list_shipments.

### `get_shipping_stats` (~147 tokens)

Get shipping stats

Labels, spend, savings, tracking and where packages went for a date range, as on Reports.

Everything the Reports page charts for a date range (default the last 30 days, at most a year): label count, total and average cost (domestic and international), payments, carrier adjustments, savings against retail, pending refunds and returns, tracking states, labels and average cost per day, the carrier split, labels per zone and per US state and country. Money is in US dollars.

Input parameters:

- `from_date` (string): First day, YYYY-MM-DD. Default 30 days ago.
- `to_date` (string): Last day, YYYY-MM-DD, included. Default today.

### `get_tracking_email_settings` (~83 tokens)

Get tracking email settings

Whether recipients get tracking emails by default, how long after purchase, and the template.

enabled: new labels send a tracking email to the recipient by default. delay: when it goes out after the label is bought (delay_label as Pirate Ship shows it). branding: Pirate Ship's branding in the email. default_template_id: the template from list_email_templates used.

### `ignore_orders` (~55 tokens)

Ignore orders

Hides store orders from the Import list without shipping them.

They move to the ignored list (list_import_orders with ignored true); unignore_orders brings them back.

Input parameters:

- `order_ids` (array, required): Order ids from list_import_orders.

### `list_batches` (~117 tokens)

List batches

Latest batches and single labels, newest first, with status and tracking counts.

The batches on Pirate Ship's Ship page, newest first: drafts (RATED), bought (BILLED) and refunded, each with its shipment count, status text, the first shipment's tracking number and how many shipments are delivered, in transit, ready to print, refunded or failed. page 0 is the newest; an empty list means no more pages. get_batch gives one in full.

Input parameters:

- `page` (integer): 0 is the newest page.

### `list_carrier_adjustments` (~190 tokens)

List carrier adjustments

Extra charges or credits the carrier made after a label was used, with old and actual package.

The Reports, Carrier Adjustments table: when USPS or UPS measured a package differently from the label (weight, size, package type, zone, ZIP), the old and actual values, the old and new cost and the adjustment in US dollars, and whether it was disputed. dispute_adjustment disputes one by shipment_id.

Input parameters:

- `carrier` (array): USPS or UPS.
- `from_date` (string): First day, YYYY-MM-DD, in your timezone.
- `limit` (integer)
- `offset` (integer)
- `search` (string): Free text, as in the report's search box.
- `sort` (string)
- `status` (array): Adjustment status as the table shows it.
- `to_date` (string): Last day, YYYY-MM-DD, included.

### `list_email_templates` (~77 tokens)

List email templates

Tracking email templates: subject, sender, HTML body; one is the default.

The templates Pirate Ship uses for the tracking emails it sends to recipients of your labels: name, subject, sender name and reply-to email, BCC address and the HTML body with placeholders such as [Tracking #]. default marks the one used for new labels.

### `list_import_orders` (~127 tokens)

List import orders

Unshipped orders from your connected store integrations, as in the Import grid.

Orders imported from connected stores that still need a label: one row per order with the grid's columns (order number, recipient, items, store). ignored true lists the orders you hid with ignore_orders. Run sync_store_orders first for the newest. Use order ids in create_batch_from_orders.

Input parameters:

- `ignored` (boolean): Show the ignored orders instead.
- `limit` (integer)
- `offset` (integer)
- `search` (string): Free text, as in the report's search box.

### `list_package_types` (~63 tokens)

List package types

Packaging types per carrier (box, envelope, flat rate) and the size and weight limits.

The packaging keys get_rates and saved packages take, per carrier, with which measurements each needs, plus Pirate Ship's limits: maximum weight in ounces and side lengths in inches.

### `list_pickups` (~73 tokens)

List pickups

Your scheduled and past USPS and UPS pickups with confirmation numbers.

Every carrier pickup on the account: carrier, day and time window, status, confirmation number, package count and weight in ounces, where the driver finds them, the price (USPS is free) and whether it can still be cancelled with cancel_pickup.

### `list_receipts` (~155 tokens)

List receipts

Payments made to Pirate Ship, newest first; get_receipt shows one.

The Reports, Receipts table: each payment the account made (card, PayPal, bank) with its status, description and total in US dollars. Pass receipt_id to get_receipt for the labels it paid for.

Input parameters:

- `from_date` (string): First day, YYYY-MM-DD, in your timezone.
- `limit` (integer)
- `offset` (integer)
- `search` (string): Free text, as in the report's search box.
- `sort` (string)
- `status` (array): Payment status as the table shows it.
- `to_date` (string): Last day, YYYY-MM-DD, included.

### `list_refunds` (~175 tokens)

List refunds

Label refunds with their status and amount, newest request first.

The Reports, Refunds table: every label refund the account asked for (or Pirate Ship made automatically for an unused label), when it was requested, approved, declined or reversed, the tracking number, recipient and amount in US dollars. from_date and to_date narrow by the request day.

Input parameters:

- `from_date` (string): First day, YYYY-MM-DD, in your timezone.
- `limit` (integer)
- `offset` (integer)
- `search` (string): Free text, as in the report's search box.
- `sort` (string)
- `status` (array): Refund status as the table shows it, e.g. Pending, Approved, Declined.
- `to_date` (string): Last day, YYYY-MM-DD, included.

### `list_return_labels` (~149 tokens)

List return labels

Pay-on-use return labels and whether a customer used them.

The Reports, Return Labels table: every return label made with a shipment, its status (unused labels cost nothing), the address it goes back to and what was charged in US dollars when it was used.

Input parameters:

- `from_date` (string): First day, YYYY-MM-DD, in your timezone.
- `limit` (integer)
- `offset` (integer)
- `search` (string): Free text, as in the report's search box.
- `sort` (string)
- `status` (array): Return label status as the table shows it.
- `to_date` (string): Last day, YYYY-MM-DD, included.

### `list_saved_packages` (~82 tokens)

List saved packages

Your Saved Packages from Settings: size, weight and the extra services stored with each.

Every Saved Package: packaging type, size in inches, weight in ounces (0 when each label sets its own), signature, insured value, return label setting and flags. default marks the one preselected on new shipments. Use an id in update_saved_package or delete_saved_package.

### `list_scan_forms` (~91 tokens)

List SCAN forms

USPS SCAN Forms per Ship From Address, with their PDF links and labels still without one.

For every Ship From Address with USPS labels: how many labels can still go on a SCAN Form (labels_available) and the SCAN Forms already made, each with ship date, label count and PDF link. A SCAN Form lets the carrier scan all packages at once. Make one with create_scan_form.

### `list_ship_from_addresses` (~86 tokens)

List ship-from addresses

Your Ship From Addresses with their return addresses; one is the default.

Every saved Ship From Address in Pirate Ship: where labels ship from and the return address printed on them (origin_is_return when they are the same). default marks the one new shipments and rate quotes start from. Use an id in update_ship_from_address, delete_ship_from_address or set_default_ship_from_address.

### `list_shipments` (~266 tokens)

List shipments

Labels bought in Pirate Ship with recipient, tracking, cost and status, newest first.

The Reports, Shipments table: every label the account bought, with the recipient's address, carrier and service, tracking number and status, cost in US dollars, package size and weight, batch and ship-from address. search works like the table's search box (name, email, tracking number, order id). from_date and to_date narrow by the day the label was created; status, tracking_status, carrier and batch take the values the table shows. total counts every match, limit and offset page through them.

Input parameters:

- `batch` (array): Batch titles.
- `carrier` (array): USPS or UPS.
- `from_date` (string): First day, YYYY-MM-DD, in your timezone.
- `limit` (integer)
- `offset` (integer)
- `search` (string): Free text, as in the report's search box.
- `sort` (string)
- `status` (array): Label status as the report shows it, e.g. Printed, Refunded.
- `to_date` (string): Last day, YYYY-MM-DD, included.
- `tracking_status` (array): Tracking status as the report shows it, e.g. Delivered, In Transit.

### `list_store_connections` (~85 tokens)

List store connections

Stores and marketplaces connected to Pirate Ship for order import, with their status.

Every connected store (Shopify, Etsy, eBay, WooCommerce, Squarespace and others): its name, platform, whether it is active and still authorised (valid false means reconnect it in Pirate Ship) and whether orders sync on their own. Connecting a store happens in Pirate Ship, not here.

### `list_transactions` (~178 tokens)

List transactions

Every charge, payment and refund on the Pirate Ship balance, newest first.

The Reports, Transaction History table: each label purchase, payment, refund and carrier adjustment with its amount in US dollars (negative takes from the balance) and the balance after it. from_date and to_date narrow by day, type by the table's transaction types, search works like its search box.

Input parameters:

- `from_date` (string): First day, YYYY-MM-DD, in your timezone.
- `limit` (integer)
- `offset` (integer)
- `search` (string): Free text, as in the report's search box.
- `sort` (string)
- `to_date` (string): Last day, YYYY-MM-DD, included.
- `type` (array): Transaction types as the table shows them, e.g. Label, Payment, Refund.

### `parse_address` (~87 tokens)

Parse address

Splits a pasted address into name, street, city, state, ZIP and country.

Pirate Ship's Paste Address: free text such as a line copied from an email or an order becomes the fields create_shipment takes. It only parses; the address is checked when the shipment is created.

Input parameters:

- `text` (string, required): An address as written, lines separated by newlines or commas.

### `rename_batch` (~49 tokens)

Rename batch

Changes a batch's title.

Sets the title Pirate Ship shows for a batch or single label on the Ship page and in reports.

Input parameters:

- `batch_id` (string, required)
- `title` (string, required)

### `search_recipients` (~79 tokens)

Search recipients

Past recipients' addresses matching a name, email or phone.

The suggestions Pirate Ship's Ship To form shows while typing: addresses of people this account shipped to before, matched by the start of their name (or email or phone). Use one as create_shipment's to.

Input parameters:

- `field` (string)
- `query` (string, required)

### `set_default_ship_from_address` (~54 tokens)

Set default ship-from address

Makes one Ship From Address the default for new shipments and rate quotes.

New shipments, get_rates and pickups start from the default Ship From Address.

Input parameters:

- `address_id` (string, required): id from list_ship_from_addresses.

### `sync_store_orders` (~90 tokens)

Sync store orders

Pulls new orders from every connected store into Pirate Ship's Import list.

Starts Refresh Data for all connected stores and waits up to wait_seconds for it to finish; running true means it continues in the background. Then list_import_orders shows the orders. With no store connected nothing is imported.

Input parameters:

- `wait_seconds` (integer): How long to wait for the sync to finish; 0 only starts it.

### `unignore_orders` (~34 tokens)

Unignore orders

Puts ignored store orders back on the Import list.

Input parameters:

- `order_ids` (array, required): Order ids from list_import_orders.

### `update_email_template` (~163 tokens)

Update email template

Changes a tracking email template; fields you leave out keep their values.

Edits the name, subject, sender, BCC address, HTML body or default flag of one template.

Input parameters:

- `bcc_email` (string): A copy of every email goes here. Empty for none.
- `default` (boolean): Use it for new labels.
- `html` (string): Body as HTML. Placeholders: [Recipient First Name], [Ship Date], [Shipping Service], [Recipient Address], [Tracking #].
- `name` (string): Template name in Settings.
- `sender_email` (string): Reply-to address recipients see.
- `sender_name` (string)
- `subject` (string)
- `template_id` (string, required): id from list_email_templates.

### `update_label_settings` (~163 tokens)

Update label settings

Changes label size, file format, packing list, logo, QR codes, address correction or export format.

Saves Settings, General for the whole account. Fields you leave out keep their values. Applies to labels made from now on; get_label_settings shows the current values.

Input parameters:

- `address_correction` (string): What Pirate Ship does when it finds a better address: nothing, ask, or correct it.
- `label_format` (string): PDF, or ZPLII for thermal printers.
- `label_size` (string): Label size in inches.
- `logo_on_label` (boolean)
- `mobile_codes` (boolean): Offer USPS label-free QR codes.
- `packing_list` (string)
- `report_format` (string): Spreadsheet format of exports.

### `update_saved_package` (~232 tokens)

Update saved package

Changes a Saved Package; fields you leave out keep their values.

Edits one Saved Package: name, packaging, size, weight, signature, insurance, return label and flags. Pirate Ship saves an edit as a new version: the answer carries the new id, use it from then on. default true makes it the preselected package.

Input parameters:

- `default` (boolean): Preselect it on new shipments.
- `hazardous_materials` (boolean)
- `height_in` (number)
- `insured_value_usd` (number)
- `irregular` (boolean)
- `length_in` (number)
- `media_mail` (boolean): Qualifies for USPS Media Mail.
- `package_id` (string, required): id from list_saved_packages.
- `packaging` (string)
- `return_label` (string): return: return labels only; standard_and_return: an extra return label.
- `signature` (string)
- `title` (string): Name shown in Saved Packages.
- `weight_oz` (number): 0 leaves the weight to each label.
- `width_in` (number)

### `update_ship_from_address` (~142 tokens)

Update ship-from address

Changes a Ship From Address: its name, origin or return address.

Edits one saved Ship From Address; fields you leave out keep their values. origin_is_return true sends returns to the origin, return_address sets a separate one. Pirate Ship saves an edit as a new version: the answer carries the new id, use it from then on. Labels already bought keep their address.

Input parameters:

- `address_id` (string, required): id from list_ship_from_addresses.
- `origin` (object)
- `origin_is_return` (boolean): true sends returns to the origin.
- `return_address` (object): A separate return address.
- `title` (string)

### `update_tracking_email_settings` (~81 tokens)

Update tracking email settings

Turns default tracking emails on or off and sets their delay after purchase.

Changes only what you pass and returns the settings as get_tracking_email_settings does.

Input parameters:

- `delay` (string): When the email goes out after purchase; +24 hours is next day 9:00 AM.
- `enabled` (boolean): Send tracking emails on new labels by default.

## Diagnostics

Captured diagnostic sections: Provenance, Install scripts, Dependencies. The full working is on the page: https://verifymcp.io/servers/dev-cotlet-pirate-ship/pirate-ship-api-mcp#diagnostics

## Score history

- 2026-11-05: 78
- 2026-11-04: 63
- 2026-11-03: 63
- 2026-11-02: 63
- 2026-11-01: 63
- 2026-10-31: 63
- 2026-10-30: 63
- 2026-10-29: 63
- 2026-10-28: 78
- 2026-10-27: 78
- 2026-10-26: 78
- 2026-10-25: 78
- 2026-10-24: 63

## Common questions

### What is the Pirate Ship by Cotlet MCP server?

Pirate Ship by Cotlet is an MCP server listed in the public MCP registry as dev.cotlet/pirate-ship. Labels, rates and tracking for small shippers. This page covers its PyPI package (pirate-ship-api-mcp).

### Is the Pirate Ship by Cotlet MCP server safe to use?

Pirate Ship by Cotlet scores 78 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 5 November 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Pirate Ship by Cotlet MCP server expose?

Pirate Ship by Cotlet exposes 51 tools: change_ship_date, create_batch, create_batch_from_orders, create_email_template, create_saved_package, and 46 more. Their descriptions and schemas cost roughly 6,473 tokens of context every time the server is loaded.

### Is the Pirate Ship by Cotlet MCP server still maintained?

Pirate Ship by Cotlet is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Pirate Ship by Cotlet MCP server under?

Pirate Ship by Cotlet declares the PolyForm-Noncommercial-1.0.0 licence, which is not on the OSI-approved list. Read the terms before using it at work, and note this covers the source only, not the cost of any service it calls.

## Links

- PyPI project: https://pypi.org/project/pirate-ship-api-mcp/
- Socket report: https://socket.dev/pypi/package/pirate-ship-api-mcp
- Repository: https://github.com/cotletdev/pirate-ship-api-mcp-server
- Website: https://cotlet.dev/integrations/pirate-ship-api-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/dev-cotlet-pirate-ship/pirate-ship-api-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/dev-cotlet-pirate-ship/pirate-ship-api-mcp.json
- HTML version of this page: https://verifymcp.io/servers/dev-cotlet-pirate-ship/pirate-ship-api-mcp