Pirate Ship by Cotlet
REMOTE · COTLET.DEV · 2 COMPONENTS
Labels, rates and tracking for small shippers.
Available components
Last scanned (3 hours ago)
Scores higher than 57% of remote servers
Reachable. Last reached 24 Oct 2026.
Category E-commerce
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. How we score → Why this is hard to score →
Endpoint Security66
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation check failed: no authorisation is required to call this server, and it exposes a tool marked destructive (cotlet_browser_click). See how to fix → View diagnostics → Fail
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
- DNSSEC is configured correctly; the domain's records validate against the full chain to the root. View diagnostics → Pass
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability80
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (good).Pass
- 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. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability check failed: schema churn in the 1 day we've observed: 3 tool removals, 0 breaking changes, 0 auth/transport breaks, 0 additions. See how to fix → Fail
Tool Coverage92
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 76% of tool parameters carry a description.Partial
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 6 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 76 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 24 Oct 26 0
- Stability: unverified → fail ▼ security
- A breaking change shipped without a version bump: still 0.1.0 ▼ security
- Tool “cotlet_balance” was removed ▼ security
- Tool “cotlet_browser_connect” was removed ▼ security
- 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 security
- Schema quality: pass → fail ▼ functional
- Tool coverage: 66% → 76% ▲ functional
- Stability: unverified → 0.03 ▲ functional
- “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” cosmetic
- 23 Oct 26 68
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 24 Oct 2026 · Probed https://cotlet.dev/mcp/v1/pirate-ship
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=cotlet.dev | CN=YE1,O=Let's Encrypt,C=US | 12 Oct 2026 | 10 Jan 2027 | ECDSA 256 | ECDSA-SHA384 | 6afd7585ee8e24a40f5683c10835ec990a8 |
| SANs: *.cotlet.dev, cotlet.dev | ||||||
| CN=YE1,O=Let's Encrypt,C=US (CA) | CN=Root YE,O=ISRG,C=US | 3 Sept 2025 | 2 Sept 2028 | ECDSA 384 | ECDSA-SHA384 | 5ddd70dd31f801c85c186a7a04b80afe |
| CN=Root YE,O=ISRG,C=US (CA) | CN=ISRG Root X2,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | ECDSA-SHA384 | 872165fc34b6e5fba8add5b3705fb53a |
| CN=ISRG Root X2,O=Internet Security Research Group,C=US (CA) | CN=ISRG Root X1,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | SHA256-RSA | 6c8f1dc727c7117f7baf853ac980f9cd |
Background: What to check on a remote MCP endpoint →
DNSSEC secure
Validation of cotlet.dev. — Secure
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| dev. | present | 60074 | 8 | Verified |
| cotlet.dev. | present | 2371 | 13 | Verified |
| cotlet.dev. | Verified address RRset verified with the apex keys |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
| Header | Value |
|---|---|
| strict-transport-security | max-age=31536000; includeSubDomains |
| x-content-type-options | nosniff |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://cotlet.dev/mcp/v1/pirate-ship | Verified | 200 | |
| http (plaintext) | http://cotlet.dev/mcp/v1/pirate-ship | HTTPS enforced | 301 | https://cotlet.dev/mcp/v1/pirate-ship |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
buy_label Buy label ~236
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.
| Name | Type | Req | Description |
|---|---|---|---|
| batch_id | string | yes | 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 | yes | One rate_id from get_batch per rate group (a single shipment has one group). |
| ship_date | string | – | Default: the batch's ship date. |
No output schema declared.
No examples provided.
cancel_pickup Cancel pickup ~64
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.
| Name | Type | Req | Description |
|---|---|---|---|
| pickup_id | string | yes | id from list_pickups. |
No output schema declared.
No examples provided.
change_ship_date Change ship date ~91
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.
| Name | Type | Req | Description |
|---|---|---|---|
| batch_id | string | yes | – |
| ship_date | string | yes | One of the rate's ship_dates (YYYY-MM-DD). |
No output schema declared.
No examples provided.
cotlet_apps Cotlet: apps I can use ~89
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.
| Name | Type | Req | Description |
|---|---|---|---|
| app | string | – | Only this app, e.g. skool. |
No output schema declared.
No examples provided.
cotlet_browser_click Click on the page ~120
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.
| Name | Type | Req | Description |
|---|---|---|---|
| element | integer | yes | The element's number in the element list of the current page. |
No output schema declared.
No examples provided.
cotlet_browser_close Close the browser ~45
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
cotlet_browser_navigate Go to a page ~99
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.
| Name | Type | Req | Description |
|---|---|---|---|
| url | string | yes | A public http or https address, e.g. https://example.com. In an app's browser, a page of that app. |
No output schema declared.
No examples provided.
cotlet_browser_open Open the browser ~128
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.
| Name | Type | Req | Description |
|---|---|---|---|
| url | string | – | A public http or https address, e.g. https://example.com. In an app's browser, a page of that app. |
No output schema declared.
No examples provided.
cotlet_browser_press Press a key ~109
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.
| Name | Type | Req | Description |
|---|---|---|---|
| key | string | yes | The key. |
No output schema declared.
No examples provided.
cotlet_browser_read Read the page ~98
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
cotlet_browser_screenshot See the page ~76
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
cotlet_browser_scroll Scroll the page ~176
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
No output schema declared.
No examples provided.
cotlet_browser_select Choose from a list ~123
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.
| Name | Type | Req | Description |
|---|---|---|---|
| element | integer | yes | The element's number in the element list of the current page. |
| option | string | yes | The option. |
No output schema declared.
No examples provided.
cotlet_browser_type Type on the page ~149
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.
| Name | Type | Req | Description |
|---|---|---|---|
| element | integer | yes | The element's number in the element list of the current page. |
| submit | boolean | – | Press Enter after typing, e.g. to search. |
| text | string | yes | The text to type. |
No output schema declared.
No examples provided.
cotlet_browser_upload Upload a file ~152
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.
| Name | Type | Req | Description |
|---|---|---|---|
| element | integer | yes | The element's number in the element list of the current page. |
| files | array | yes | The files. |
No output schema declared.
No examples provided.
cotlet_get_call Cotlet: check a call ~76
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.
| Name | Type | Req | Description |
|---|---|---|---|
| call_id | string | yes | call_id from the earlier call |
No output schema declared.
No examples provided.
cotlet_report_issue Cotlet: report a bug or a missing feature ~276
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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 | yes | 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 | yes | One line, e.g. 'skool_list_members stops after 50 members'. |
| tool | – | – | Tool or endpoint name, e.g. 'skool_list_members'. |
No output schema declared.
No examples provided.
cotlet_request_apps Cotlet: request access to apps ~102
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.
| Name | Type | Req | Description |
|---|---|---|---|
| apps | array | yes | App slugs, e.g. ["skool", "substack"]. |
No output schema declared.
No examples provided.
cotlet_upload_file Cotlet: upload a file for a tool ~115
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.
| Name | Type | Req | Description |
|---|---|---|---|
| content_type | string | – | MIME type, e.g. image/jpeg. |
| name | string | – | File name, e.g. photo.jpg. |
No output schema declared.
No examples provided.
cotlet_whoami Cotlet: who am I ~63
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
create_batch Create batch ~267
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | – |
| signature | string | – | – |
| title | string | yes | Batch name. |
| weight_oz | number | – | Weight in ounces. |
| width_in | number | – | – |
No output schema declared.
No examples provided.
create_batch_from_orders Create batch from orders ~157
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).
| Name | Type | Req | Description |
|---|---|---|---|
| order_ids | array | yes | Order ids from list_import_orders. |
| override_multiple | boolean | – | Use the saved package also for orders with several items. |
| package_id | string | yes | 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. |
No output schema declared.
No examples provided.
create_email_template Create email template ~182
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 #].
| Name | Type | Req | Description |
|---|---|---|---|
| bcc_email | string | – | A copy of every email goes here. Empty for none. |
| default | boolean | – | Use it for new labels. |
| html | string | yes | Body as HTML. Placeholders: [Recipient First Name], [Ship Date], [Shipping Service], [Recipient Address], [Tracking #]. |
| name | string | yes | Template name in Settings. |
| sender_email | string | yes | Reply-to address recipients see. |
| sender_name | string | yes | – |
| subject | string | yes | – |
No output schema declared.
No examples provided.
create_saved_package Create saved package ~224
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | – |
| return_label | string | – | return: return labels only; standard_and_return: an extra return label. |
| signature | string | – | – |
| title | string | yes | Name shown in Saved Packages. |
| weight_oz | number | – | 0 leaves the weight to each label. |
| width_in | number | – | – |
No output schema declared.
No examples provided.
create_scan_form Create SCAN Form ~153
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
No output schema declared.
No examples provided.
create_ship_from_address Create ship-from address ~103
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.
| Name | Type | Req | Description |
|---|---|---|---|
| origin | object | yes | – |
| return_address | object | – | Where returns go. Default: the origin. |
| title | string | yes | Name in the address list. |
No output schema declared.
No examples provided.
create_shipment Create shipment ~325
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | – |
| weight_oz | number | – | Weight in ounces. |
| width_in | number | – | – |
No output schema declared.
No examples provided.
delete_batch Delete batch ~66
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.
| Name | Type | Req | Description |
|---|---|---|---|
| batch_id | string | yes | – |
No output schema declared.
No examples provided.
delete_email_template Delete email template ~70
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.
| Name | Type | Req | Description |
|---|---|---|---|
| template_id | string | yes | id from list_email_templates. |
No output schema declared.
No examples provided.
delete_saved_package Delete saved package ~71
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.
| Name | Type | Req | Description |
|---|---|---|---|
| package_id | string | yes | id from list_saved_packages. |
No output schema declared.
No examples provided.
delete_ship_from_address Delete ship-from address ~80
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.
| Name | Type | Req | Description |
|---|---|---|---|
| address_id | string | yes | id from list_ship_from_addresses. |
No output schema declared.
No examples provided.
dispute_adjustment Dispute adjustment ~152
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.
| Name | Type | Req | Description |
|---|---|---|---|
| reason | string | yes | Why the adjustment is wrong, as you would write it to Pirate Ship support. |
| shipment_id | string | yes | shipment_id of the adjusted label, from list_carrier_adjustments. |
No output schema declared.
No examples provided.
download_labels Download labels ~106
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.
| Name | Type | Req | Description |
|---|---|---|---|
| batch_id | string | – | Every printable label of this batch. |
| shipment_ids | array | – | – |
No output schema declared.
No examples provided.
export_report Export report ~153
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.
| Name | Type | Req | Description |
|---|---|---|---|
| from_date | string | – | First day, YYYY-MM-DD, in your timezone. |
| report | string | yes | – |
| 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. |
No output schema declared.
No examples provided.
export_shipments Export shipments ~233
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
No output schema declared.
No examples provided.
get_account_balance Get account balance ~82
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_batch Get batch ~115
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.
| Name | Type | Req | Description |
|---|---|---|---|
| batch_id | string | yes | From create_shipment or list_batches. |
No output schema declared.
No examples provided.
get_label_settings Get label settings ~81
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_pickup_quote Get pickup quote ~186
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.
| Name | Type | Req | Description |
|---|---|---|---|
| carrier | string | yes | – |
| 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 | yes | – |
| ready_time | string | – | UPS only. |
| ship_from_id | string | – | From list_ship_from_addresses. Default: the default one. |
| total_weight_oz | number | yes | – |
No output schema declared.
No examples provided.
get_rates Get rates ~215
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Destination ZIP or postcode. |
| weight_oz | number | yes | Weight in ounces. |
| width_in | number | – | – |
No output schema declared.
No examples provided.
get_receipt Get receipt ~98
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.
| Name | Type | Req | Description |
|---|---|---|---|
| receipt_id | string | yes | receipt_id from list_receipts. |
No output schema declared.
No examples provided.
get_shipment Get shipment ~127
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).
| Name | Type | Req | Description |
|---|---|---|---|
| batch_id | string | – | Saves one request when known. |
| shipment_id | string | yes | From get_batch or list_shipments. |
No output schema declared.
No examples provided.
get_shipping_stats Get shipping stats ~147
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.
| Name | Type | Req | Description |
|---|---|---|---|
| from_date | string | – | First day, YYYY-MM-DD. Default 30 days ago. |
| to_date | string | – | Last day, YYYY-MM-DD, included. Default today. |
No output schema declared.
No examples provided.
get_tracking_email_settings Get tracking email settings ~89
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
ignore_orders Ignore orders ~55
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.
| Name | Type | Req | Description |
|---|---|---|---|
| order_ids | array | yes | Order ids from list_import_orders. |
No output schema declared.
No examples provided.
list_batches List batches ~117
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.
| Name | Type | Req | Description |
|---|---|---|---|
| page | integer | – | 0 is the newest page. |
No output schema declared.
No examples provided.
list_carrier_adjustments List carrier adjustments ~219
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
No output schema declared.
No examples provided.
list_email_templates List email templates ~89
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_import_orders List import orders ~153
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
No output schema declared.
No examples provided.
list_package_types List package types ~63
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
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.
remote · cotlet.dev
claude mcp add --transport http dev-cotlet-pirate-ship 'https://cotlet.dev/mcp/v1/pirate-ship'
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.