# Pirate Ship by Cotlet (remote · cotlet.dev)

Labels, rates and tracking for small shippers.

- Trust score: 68/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-24

## Components

- remote · `cotlet.dev`: 68/100 (this document), [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)

## Channel facts

- Endpoint: `https://cotlet.dev/mcp/v1/pirate-ship`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, 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-10-24.

- **Endpoint Security**: 66/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation check failed: no authorisation is required to call this server, and it exposes a tool marked destructive (cotlet_browser_click).
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 80/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 9898 tokens (~131/item across 75 items; 74 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability check failed: schema churn in the 1 day we've observed: 3 tool removals, 0 breaking changes, 0 auth/transport breaks, 0 additions.
- **Tool Coverage**: 92/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 76% 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 6 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 76 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

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

Pirate Ship by Cotlet is a hosted endpoint at https://cotlet.dev/mcp/v1/pirate-ship, so there is nothing to install locally. 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 --transport http dev-cotlet-pirate-ship 'https://cotlet.dev/mcp/v1/pirate-ship'
```

### Cursor

```json
{
  "mcpServers": {
    "dev-cotlet-pirate-ship": {
      "url": "https://cotlet.dev/mcp/v1/pirate-ship"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "dev-cotlet-pirate-ship": {
      "type": "http",
      "url": "https://cotlet.dev/mcp/v1/pirate-ship"
    }
  }
}
```

### Codex

```toml
[mcp_servers.dev-cotlet-pirate-ship]
url = "https://cotlet.dev/mcp/v1/pirate-ship"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "dev-cotlet-pirate-ship": {
      "type": "remote",
      "url": "https://cotlet.dev/mcp/v1/pirate-ship",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add dev-cotlet-pirate-ship --url 'https://cotlet.dev/mcp/v1/pirate-ship' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  dev-cotlet-pirate-ship:
    url: "https://cotlet.dev/mcp/v1/pirate-ship"
```

### Netclaw

```json
{
  "McpServers": {
    "dev-cotlet-pirate-ship": {
      "Transport": "http",
      "Url": "https://cotlet.dev/mcp/v1/pirate-ship"
    }
  }
}
```

### Vellum

```bash
assistant mcp add dev-cotlet-pirate-ship -t streamable-http -u 'https://cotlet.dev/mcp/v1/pirate-ship'
```

### Other

```json
{
  "mcpServers": {
    "dev-cotlet-pirate-ship": {
      "type": "http",
      "url": "https://cotlet.dev/mcp/v1/pirate-ship"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## 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-10-24 (score 68, 0)

- [security regression] Stability: unverified → fail
- [security regression] A breaking change shipped without a version bump: still 0.1.0
- [security regression] Tool “cotlet_balance” was removed
- [security regression] Tool “cotlet_browser_connect” was removed
- [security regression] Tool “cotlet_browser_sessions” was removed
- [security] The server rewrote its instructions, which are the text every model session reads
- [security] Tool “cancel_pickup” rewrote its description, which is the text the model reads
- [security] Tool “list_pickups” rewrote its description, which is the text the model reads
- [security] Tool “buy_label” rewrote its description, which is the text the model reads
- [security] Tool “change_ship_date” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_click” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_close” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_navigate” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_open” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_press” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_read” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_screenshot” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_scroll” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_select” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_type” rewrote its description, which is the text the model reads
- [security] Tool “cotlet_browser_upload” rewrote its description, which is the text the model reads
- [security] Tool “create_batch” rewrote its description, which is the text the model reads
- [security] Tool “create_batch_from_orders” rewrote its description, which is the text the model reads
- [security] Tool “create_email_template” rewrote its description, which is the text the model reads
- [security] Tool “create_saved_package” rewrote its description, which is the text the model reads
- [security] Tool “create_scan_form” rewrote its description, which is the text the model reads
- [security] Tool “create_ship_from_address” rewrote its description, which is the text the model reads
- [security] Tool “create_shipment” rewrote its description, which is the text the model reads
- [security] Tool “delete_batch” rewrote its description, which is the text the model reads
- [security] Tool “delete_email_template” rewrote its description, which is the text the model reads
- [security] Tool “delete_saved_package” rewrote its description, which is the text the model reads
- [security] Tool “delete_ship_from_address” rewrote its description, which is the text the model reads
- [security] Tool “dispute_adjustment” rewrote its description, which is the text the model reads
- [security] Tool “download_labels” rewrote its description, which is the text the model reads
- [security] Tool “export_report” rewrote its description, which is the text the model reads
- [security] Tool “export_shipments” rewrote its description, which is the text the model reads
- [security] Tool “get_account_balance” rewrote its description, which is the text the model reads
- [security] Tool “get_batch” rewrote its description, which is the text the model reads
- [security] Tool “get_label_settings” rewrote its description, which is the text the model reads
- [security] Tool “get_pickup_quote” rewrote its description, which is the text the model reads
- [security] Tool “get_rates” rewrote its description, which is the text the model reads
- [security] Tool “get_receipt” rewrote its description, which is the text the model reads
- [security] Tool “get_shipment” rewrote its description, which is the text the model reads
- [security] Tool “get_shipping_stats” rewrote its description, which is the text the model reads
- [security] Tool “get_tracking_email_settings” rewrote its description, which is the text the model reads
- [security] Tool “ignore_orders” rewrote its description, which is the text the model reads
- [security] Tool “list_batches” rewrote its description, which is the text the model reads
- [security] Tool “list_carrier_adjustments” rewrote its description, which is the text the model reads
- [security] Tool “list_email_templates” rewrote its description, which is the text the model reads
- [security] Tool “list_import_orders” rewrote its description, which is the text the model reads
- [security] Tool “list_package_types” rewrote its description, which is the text the model reads
- [security] Tool “list_receipts” rewrote its description, which is the text the model reads
- [security] Tool “list_refunds” rewrote its description, which is the text the model reads
- [security] Tool “list_return_labels” rewrote its description, which is the text the model reads
- [security] Tool “list_saved_packages” rewrote its description, which is the text the model reads
- [security] Tool “list_scan_forms” rewrote its description, which is the text the model reads
- [security] Tool “list_ship_from_addresses” rewrote its description, which is the text the model reads
- [security] Tool “list_shipments” rewrote its description, which is the text the model reads
- [security] Tool “list_store_connections” rewrote its description, which is the text the model reads
- [security] Tool “list_transactions” rewrote its description, which is the text the model reads
- [security] Tool “parse_address” rewrote its description, which is the text the model reads
- [security] Tool “refund_batch” rewrote its description, which is the text the model reads
- [security] Tool “refund_label” rewrote its description, which is the text the model reads
- [security] Tool “rename_batch” rewrote its description, which is the text the model reads
- [security] Tool “schedule_pickup” rewrote its description, which is the text the model reads
- [security] Tool “search_recipients” rewrote its description, which is the text the model reads
- [security] Tool “set_default_ship_from_address” rewrote its description, which is the text the model reads
- [security] Tool “sync_store_orders” rewrote its description, which is the text the model reads
- [security] Tool “unignore_orders” rewrote its description, which is the text the model reads
- [security] Tool “update_email_template” rewrote its description, which is the text the model reads
- [security] Tool “update_label_settings” rewrote its description, which is the text the model reads
- [security] Tool “update_saved_package” rewrote its description, which is the text the model reads
- [security] Tool “update_ship_from_address” rewrote its description, which is the text the model reads
- [security] Tool “update_tracking_email_settings” rewrote its description, which is the text the model reads
- [functional regression] Schema quality: pass → fail
- [functional improvement] Tool coverage: 66% → 76%
- [functional improvement] Stability: unverified → 0.03
- [cosmetic] “export_report” reworded the description of “sort”
- [cosmetic] “export_shipments” reworded the description of “sort”
- [cosmetic] “list_carrier_adjustments” reworded the description of “limit”
- [cosmetic] “list_carrier_adjustments” reworded the description of “offset”
- [cosmetic] “list_carrier_adjustments” reworded the description of “sort”
- [cosmetic] “list_import_orders” reworded the description of “limit”
- [cosmetic] “list_import_orders” reworded the description of “offset”
- [cosmetic] “list_receipts” reworded the description of “limit”
- [cosmetic] “list_receipts” reworded the description of “offset”
- [cosmetic] “list_receipts” reworded the description of “sort”
- [cosmetic] “list_refunds” reworded the description of “limit”
- [cosmetic] “list_refunds” reworded the description of “offset”
- [cosmetic] “list_refunds” reworded the description of “sort”
- [cosmetic] “list_return_labels” reworded the description of “limit”
- [cosmetic] “list_return_labels” reworded the description of “offset”
- [cosmetic] “list_return_labels” reworded the description of “sort”
- [cosmetic] “list_shipments” reworded the description of “limit”
- [cosmetic] “list_shipments” reworded the description of “offset”
- [cosmetic] “list_shipments” reworded the description of “sort”
- [cosmetic] “list_transactions” reworded the description of “limit”
- [cosmetic] “list_transactions” reworded the description of “offset”
- [cosmetic] “list_transactions” reworded the description of “sort”
- [cosmetic] “rename_batch” reworded the description of “batch_id”
- [cosmetic] “rename_batch” reworded the description of “title”

### 2026-10-23 (score 68)

First indexed and scored.

## MCP tools (74)

### `cotlet_whoami` (~63 tokens)

Cotlet: who am I

The Cotlet account this connection acts as: email, workspace, access status, the API key or OAuth client in use with its scope, the apps the workspace may call and its credit balance. Free. Needs the user's Cotlet API key or sign-in.

### `cotlet_apps` (~89 tokens)

Cotlet: apps I can use

The apps of the user's workspace and whether each works now: access granted or requested, the app account in the user's Cloud Browser (connected, signed out, not enabled for agents), and the one step the user has to take, with the console link. Free. Needs the user's Cotlet API key or sign-in.

Input parameters:

- `app` (string): Only this app, e.g. skool.

### `cotlet_request_apps` (~102 tokens)

Cotlet: request access to apps

Requests access to apps for the user's workspace, as Request access in the console: a live app is granted at once, any other goes to the Cotlet team, who answer within 72 hours. Takes app slugs as listed at https://cotlet.dev/api/v1/apps. Free. Needs the user's Cotlet API key or sign-in.

Input parameters:

- `apps` (array, required): App slugs, e.g. ["skool", "substack"].

### `cotlet_get_call` (~76 tokens)

Cotlet: check a call

Status of an earlier Cotlet call, by its call_id: pending (waits for the owner's approval in the Cotlet console), approved, running, success, rejected, expired, blocked or failed. For a call that answered with status pending or running.

Input parameters:

- `call_id` (string, required): call_id from the earlier call

### `cotlet_upload_file` (~115 tokens)

Cotlet: upload a file for a tool

Returns a one-time upload_url and a file_id for a local file (an image for a post, an attachment). The file is sent to upload_url with an HTTP PUT; an argument that takes a file accepts {"file_id": "..."}. Up to 25 MB, the URL works once. Free. Needs the user's Cotlet API key or sign-in.

Input parameters:

- `content_type` (string): MIME type, e.g. image/jpeg.
- `name` (string): File name, e.g. photo.jpg.

### `cotlet_report_issue` (~276 tokens)

Cotlet: report a bug or a missing feature

Sends a report straight to the Cotlet team: a tool that failed or returned wrong data, an error you could not get past, or a tool, field or app the task needed and Cotlet lacks. The report carries the error text and call_id when there is one, never passwords or tokens. Needs the user's Cotlet API key or sign-in.

Input parameters:

- `app`: App slug the report is about, e.g. 'skool'.
- `call_id`: call_id of the call that went wrong, if any.
- `client`: Agent or tool sending this, e.g. 'Claude Code'.
- `description` (string, required): What you tried, what you expected and what happened, with the error text if there was one. No passwords, tokens or other secrets.
- `kind` (string, required): bug: a tool did the wrong thing or returned wrong data. error: a call failed or returned an error you could not get past. feature_request: something new the user wants. missing_feature: an app is her…
- `title` (string, required): One line, e.g. 'skool_list_members stops after 50 members'.
- `tool`: Tool or endpoint name, e.g. 'skool_list_members'.

### `cotlet_browser_open` (~128 tokens)

Open the browser

Wakes the user's Pirate Ship Cloud Browser, a real Chrome hosted on Cotlet and signed in to Pirate Ship as the user. Use it for what the Pirate Ship tools do not cover. Opens `url` when given and returns the page's URL and title. The user watches every step live. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.

Input parameters:

- `url` (string): A public http or https address, e.g. https://example.com. In an app's browser, a page of that app.

### `cotlet_browser_navigate` (~99 tokens)

Go to a page

Opens a public http or https address in the user's Pirate Ship Cloud Browser and returns the URL and title it ended on. Only Pirate Ship pages open. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.

Input parameters:

- `url` (string, required): A public http or https address, e.g. https://example.com. In an app's browser, a page of that app.

### `cotlet_browser_read` (~98 tokens)

Read the page

Returns the current page of the user's Pirate Ship Cloud Browser: its readable text, up to 20,000 characters, and a numbered list of its links, buttons and fields. Field values, cookies and storage are never returned. On a page longer than that, both start near where it is scrolled to. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.

### `cotlet_browser_screenshot` (~76 tokens)

See the page

Returns a JPEG image of the visible part of the current page in the user's Pirate Ship Cloud Browser, with its URL and title: boards, canvases and layouts that the page text does not show. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.

### `cotlet_browser_scroll` (~176 tokens)

Scroll the page

Scrolls the current page in the user's Pirate Ship Cloud Browser with the mouse wheel, as a person does: down or up by `screens` viewport heights (default 0.8), to the top or the bottom, or until element `element` is in view. Content that loads on scroll appears, and the next read lists it. Returns the URL, title and scroll position (at_top, at_bottom). Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.

Input parameters:

- `direction` (string): Where to scroll. Default: down.
- `element` (integer): Scroll until this element of the element list is in view.
- `screens` (number): How far, in viewport heights, for down and up. Default: 0.8.

### `cotlet_browser_click` (~120 tokens)

Click on the page

Clicks a link, button or other element of the current page in the user's Pirate Ship Cloud Browser, by its number in the page's element list, and returns the URL and title after the click. It acts as the user on that site. Buttons that pay or buy and buttons on account or sign-in pages are refused. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.

Input parameters:

- `element` (integer, required): The element's number in the element list of the current page.

### `cotlet_browser_type` (~149 tokens)

Type on the page

Types text into a field of the current page in the user's Pirate Ship Cloud Browser, by the field's number in the page's element list, and with `submit` presses Enter. Returns the URL and title after it. Password, card and one-time code fields and sign-in pages are refused: the user fills those in themselves. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.

Input parameters:

- `element` (integer, required): The element's number in the element list of the current page.
- `submit` (boolean): Press Enter after typing, e.g. to search.
- `text` (string, required): The text to type.

### `cotlet_browser_select` (~123 tokens)

Choose from a list

Chooses an option of a drop-down list on the current page in the user's Pirate Ship Cloud Browser, by the list's number in the element list and the option's label as read lists it (or its value). Returns the URL and title after it. Card fields and account pages are refused. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.

Input parameters:

- `element` (integer, required): The element's number in the element list of the current page.
- `option` (string, required): The option.

### `cotlet_browser_press` (~109 tokens)

Press a key

Presses one key on the current page in the user's Pirate Ship Cloud Browser, on the element that has focus: Tab to the next field, Enter to send, Escape to close a dialog or pop-up, arrows to move through a suggestion list. Returns the URL and title after it. Enter on account pages is refused. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.

Input parameters:

- `key` (string, required): The key.

### `cotlet_browser_upload` (~152 tokens)

Upload a file

Puts files into a file field of the current page in the user's Pirate Ship Cloud Browser, or into the file picker that an upload button opens, by its number in the element list. A file is given as {"url": "https://..."} for a file online or {"file_id": "..."} for one uploaded to Cotlet first; up to 10 files, 20 MB each. Returns the URL and title after it. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.

Input parameters:

- `element` (integer, required): The element's number in the element list of the current page.
- `files` (array, required): The files.

### `cotlet_browser_close` (~45 tokens)

Close the browser

Ends the session in the user's Pirate Ship Cloud Browser: the browser keeps its cookies, goes to sleep and the per-minute charge stops. Returns the session's minutes and credits.

### `download_labels` (~106 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` (~153 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): Order by date.
- `to_date` (string): Last day, YYYY-MM-DD, included.

### `export_shipments` (~233 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): Order by date.
- `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` (~81 tokens)

Get label settings

Read the account's label settings from Settings, General. Returns 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. Read it before update_label_settings, which changes them.

### `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` (~215 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` (~89 tokens)

Get tracking email settings

Read whether label recipients get a tracking email, when, and with which 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. update_tracking_email_settings changes these.

### `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` (~219 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): Rows per page, 1 to 100.
- `offset` (integer): Rows to skip: the next page starts at offset + limit while it is below total.
- `search` (string): Free text, as in the report's search box.
- `sort` (string): Order by date.
- `status` (array): Adjustment status as the table shows it.
- `to_date` (string): Last day, YYYY-MM-DD, included.

### `list_email_templates` (~89 tokens)

List email templates

List the templates of the tracking emails sent to label recipients. Returns every template with its id, name, subject, sender name, reply-to email, BCC address and HTML body with placeholders such as [Tracking #]; default marks the one used for new labels. Use the id in update_email_template or delete_email_template. Whether emails go out at all and when is in get_tracking_email_settings.

### `list_import_orders` (~153 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): Rows per page, 1 to 100.
- `offset` (integer): Rows to skip: the next page starts at offset + limit while it is below total.
- `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` (~184 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): Rows per page, 1 to 100.
- `offset` (integer): Rows to skip: the next page starts at offset + limit while it is below total.
- `search` (string): Free text, as in the report's search box.
- `sort` (string): Order by date.
- `status` (array): Payment status as the table shows it.
- `to_date` (string): Last day, YYYY-MM-DD, included.

### `list_refunds` (~204 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): Rows per page, 1 to 100.
- `offset` (integer): Rows to skip: the next page starts at offset + limit while it is below total.
- `search` (string): Free text, as in the report's search box.
- `sort` (string): Order by date.
- `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` (~213 tokens)

List return labels

List the account's pay-on-use return labels and whether each was used. Returns total and a page of return_labels, newest first: shipment_id, created_at, status, the address the parcel goes back to and amount_usd, what Pirate Ship charged when a customer used it (an unused label costs nothing). Filter by date, status or search text and page with limit and offset. For the outgoing labels themselves use list_shipments.

Input parameters:

- `from_date` (string): First day, YYYY-MM-DD, in your timezone.
- `limit` (integer): Rows per page, 1 to 100.
- `offset` (integer): Rows to skip: the next page starts at offset + limit while it is below total.
- `search` (string): Free text, as in the report's search box.
- `sort` (string): Order by date.
- `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` (~295 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): Rows per page, 1 to 100.
- `offset` (integer): Rows to skip: the next page starts at offset + limit while it is below total.
- `search` (string): Free text, as in the report's search box.
- `sort` (string): Order by date.
- `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` (~207 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): Rows per page, 1 to 100.
- `offset` (integer): Rows to skip: the next page starts at offset + limit while it is below total.
- `search` (string): Free text, as in the report's search box.
- `sort` (string): Order by date.
- `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` (~86 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.

### `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)

### `buy_label` (~236 tokens)

Buy label

Buys the labels of a draft batch at the chosen rates; costs real money. Pirate Ship's Buy Label button: buys every label in the batch at the rate chosen for each rate group. The account balance pays first; what it does not cover is charged to the default payment method, at least $1 or the account's set charge amount, as on the buy page. Without a payment method or balance the purchase is refused. max_total_usd guards against a price change. Afterwards the labels are ready for download_labels and the answer has each shipment's tracking number. Waits for the owner's approval.

Input parameters:

- `batch_id` (string, required): A draft from create_shipment, create_batch or create_batch_from_orders.
- `label_type` (string): Printed label or a code the carrier prints at drop-off, when the service offers both.
- `max_total_usd` (number): Refuse when the labels together cost more than this.
- `rate_ids` (array, required): One rate_id from get_batch per rate group (a single shipment has one group).
- `ship_date` (string): Default: the batch's ship date.

### `cancel_pickup` (~64 tokens)

Cancel pickup

Cancels a scheduled USPS or UPS pickup that can still be cancelled. Only pickups with can_cancel true in list_pickups; a UPS pickup charge is refunded by Pirate Ship. Waits for the owner's approval.

Input parameters:

- `pickup_id` (string, required): id from list_pickups.

### `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` (~267 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` (~182 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` (~103 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` (~325 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` (~66 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. Waits for the owner's approval.

Input parameters:

- `batch_id` (string, required)

### `delete_email_template` (~70 tokens)

Delete email template

Delete one tracking email template from the account. Removes the template for good; it cannot be restored. Tracking emails already sent are not changed. To change a template's text instead, use update_email_template. Returns the deleted template's id.

Input parameters:

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

### `delete_saved_package` (~71 tokens)

Delete saved package

Delete a Saved Package (box size and weight preset) from the account. Removes it for good; labels already made with it are not affected. To change its size or weight instead, use update_saved_package. Returns the deleted package's id.

Input parameters:

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

### `delete_ship_from_address` (~80 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. Waits for the owner's approval.

Input parameters:

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

### `dispute_adjustment` (~152 tokens)

Dispute adjustment

Disputes the carrier adjustments of one label with your reason. Sends Pirate Ship a dispute of every carrier adjustment on one label (list_carrier_adjustments shows which are disputable), with the reason you give: the package's real weight and size, a photo you can share, the scale you used. Pirate Ship passes it to the carrier; the answer shows up later as dispute_processed_at in list_carrier_adjustments. A label can be disputed once. Waits for the owner's approval.

Input parameters:

- `reason` (string, required): Why the adjustment is wrong, as you would write it to Pirate Ship support.
- `shipment_id` (string, required): shipment_id of the adjusted label, from list_carrier_adjustments.

### `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.

### `refund_batch` (~71 tokens)

Refund batch

Requests a refund of every unused label in a batch. Pirate Ship's Refund Batch: voids all labels of a bought batch that the carrier has not scanned. Refunds land in the account balance, USPS ones after a couple of weeks. Waits for the owner's approval.

Input parameters:

- `batch_id` (string, required)

### `refund_label` (~90 tokens)

Refund label

Requests a refund of one unused label. Pirate Ship's Refund Label: voids one label that was not used. USPS refunds usually take a couple of weeks and land in the account balance (pending until then); some UPS labels refund at once. A label already scanned by the carrier cannot be refunded. Waits for the owner's approval.

Input parameters:

- `shipment_id` (string, required): From get_batch or list_shipments.

### `rename_batch` (~89 tokens)

Rename batch

Change the title of a batch or single label. Sets the title Pirate Ship shows on the Ship page and in reports; nothing else about the batch changes and calling it again with the same title changes nothing. Returns batch_id and the new title.

Input parameters:

- `batch_id` (string, required): batch_id from list_batches or create_batch.
- `title` (string, required): The new title, up to 100 characters.

### `schedule_pickup` (~204 tokens)

Schedule pickup

Ask USPS or UPS to collect your packages, like Schedule a Pickup. Books a carrier pickup at a Ship From Address. USPS is free and comes on the next delivery day. UPS comes on date between ready_time and close_time and charges the price of get_pickup_quote to the account's default payment method. Cancel with cancel_pickup. Waits for the owner's approval.

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)

### `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` (~83 tokens)

Unignore orders

Put ignored store orders back on the Import list. Reverses ignore_orders: the orders show in list_import_orders again and create_batch_from_orders can ship them. Up to 500 order ids per call; ids that are not ignored are skipped. Returns how many orders came back and their ids.

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` (~162 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: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/dev-cotlet-pirate-ship/mcp-v1-pirate-ship#diagnostics

## Score history

- 2026-10-24: 68
- 2026-10-23: 68

## 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 hosted endpoint (https://cotlet.dev/mcp/v1/pirate-ship).

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

Pirate Ship by Cotlet scores 68 out of 100 on VerifyMCP. 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 74 tools: cotlet_whoami, cotlet_apps, cotlet_request_apps, cotlet_get_call, cotlet_upload_file, and 69 more. Their descriptions and schemas cost roughly 9,711 tokens of context every time the server is loaded.

### Does the Pirate Ship by Cotlet MCP server require authentication?

No. We connected to Pirate Ship by Cotlet without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### 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 24 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://cotlet.dev/mcp/v1/pirate-ship
- Authorisation metadata: https://cotlet.dev/.well-known/oauth-protected-resource/mcp/v1/pirate-ship
- 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/mcp-v1-pirate-ship.xml
- Changelog JSON feed: https://verifymcp.io/servers/dev-cotlet-pirate-ship/mcp-v1-pirate-ship.json
- HTML version of this page: https://verifymcp.io/servers/dev-cotlet-pirate-ship/mcp-v1-pirate-ship