{"id":565008,"recorded_at":"2026-10-27T21:53:06.869200Z","observed_at":"2026-10-27T21:53:06.869140Z","subject_kind":"endpoint","subject":"5eb64623-6de7-45c2-a9d7-5fc22deec1e8","kind":"mcp.tools","method":"probe.mcp/1","body":{"count":74,"tools":[{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"batch_id":{"description":"A draft from create_shipment, create_batch or create_batch_from_orders.","minLength":1,"type":"string"},"label_type":{"description":"Printed label or a code the carrier prints at drop-off, when the service offers both.","enum":["LABEL","MOBILE_CODE"],"type":"string"},"max_total_usd":{"description":"Refuse when the labels together cost more than this.","exclusiveMinimum":0,"type":"number"},"rate_ids":{"description":"One rate_id from get_batch per rate group (a single shipment has one group).","items":{"type":"string"},"maxItems":20,"minItems":1,"type":"array"},"ship_date":{"description":"Default: the batch's ship date.","format":"date","type":"string"}},"required":["batch_id","rate_ids"],"type":"object"},"name":"buy_label"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"pickup_id":{"description":"id from list_pickups.","minLength":1,"type":"string"}},"required":["pickup_id"],"type":"object"},"name":"cancel_pickup"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"batch_id":{"minLength":1,"type":"string"},"ship_date":{"description":"One of the rate's ship_dates (YYYY-MM-DD).","format":"date","type":"string"}},"required":["batch_id","ship_date"],"type":"object"},"name":"change_ship_date"},{"description":"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, signed in but not connected), and the one step the user has to take, with the console link. Free. Needs the user's Cotlet API key or sign-in.","inputSchema":{"additionalProperties":false,"properties":{"app":{"description":"Only this app, e.g. skool.","type":"string"}},"type":"object"},"name":"cotlet_apps"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"element":{"description":"The element's number in the element list of the current page.","minimum":1,"type":"integer"}},"required":["element"],"type":"object"},"name":"cotlet_browser_click"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{},"type":"object"},"name":"cotlet_browser_close"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"url":{"description":"A public http or https address, e.g. https://example.com. In an app's browser, a page of that app.","format":"uri","type":"string"}},"required":["url"],"type":"object"},"name":"cotlet_browser_navigate"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"url":{"description":"A public http or https address, e.g. https://example.com. In an app's browser, a page of that app.","format":"uri","type":"string"}},"type":"object"},"name":"cotlet_browser_open"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"key":{"description":"The key.","enum":["Enter","Tab","Shift+Tab","Escape","Backspace","Delete","Space","ArrowDown","ArrowUp","ArrowLeft","ArrowRight","PageDown","PageUp","Home","End"],"type":"string"}},"required":["key"],"type":"object"},"name":"cotlet_browser_press"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{},"type":"object"},"name":"cotlet_browser_read"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{},"type":"object"},"name":"cotlet_browser_screenshot"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"direction":{"description":"Where to scroll. Default: down.","enum":["down","up","top","bottom"],"type":"string"},"element":{"description":"Scroll until this element of the element list is in view.","minimum":1,"type":"integer"},"screens":{"description":"How far, in viewport heights, for down and up. Default: 0.8.","exclusiveMinimum":0,"maximum":10,"type":"number"}},"type":"object"},"name":"cotlet_browser_scroll"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"element":{"description":"The element's number in the element list of the current page.","minimum":1,"type":"integer"},"option":{"description":"The option.","maxLength":300,"type":"string"}},"required":["element","option"],"type":"object"},"name":"cotlet_browser_select"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"element":{"description":"The element's number in the element list of the current page.","minimum":1,"type":"integer"},"submit":{"description":"Press Enter after typing, e.g. to search.","type":"boolean"},"text":{"description":"The text to type.","maxLength":5000,"type":"string"}},"required":["element","text"],"type":"object"},"name":"cotlet_browser_type"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"element":{"description":"The element's number in the element list of the current page.","minimum":1,"type":"integer"},"files":{"description":"The files.","items":{"additionalProperties":false,"properties":{"file_id":{"description":"A file uploaded to Cotlet.","type":"string"},"url":{"description":"A public file URL.","format":"uri","type":"string"}},"type":"object"},"maxItems":10,"minItems":1,"type":"array"}},"required":["element","files"],"type":"object"},"name":"cotlet_browser_upload"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"call_id":{"description":"call_id from the earlier call","type":"string"}},"required":["call_id"],"type":"object"},"name":"cotlet_get_call"},{"description":"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.","inputSchema":{"additionalProperties":false,"description":"Body of POST /api/v1/reports and the arguments of the MCP tool cotlet_report_issue.","properties":{"app":{"anyOf":[{"maxLength":80,"type":"string"},{"type":"null"}],"default":null,"description":"App slug the report is about, e.g. 'skool'.","title":"App"},"call_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"default":null,"description":"call_id of the call that went wrong, if any.","title":"Call Id"},"client":{"anyOf":[{"maxLength":80,"type":"string"},{"type":"null"}],"default":null,"description":"Agent or tool sending this, e.g. 'Claude Code'.","title":"Client"},"description":{"description":"What you tried, what you expected and what happened, with the error text if there was one. No passwords, tokens or other secrets.","maxLength":5000,"minLength":10,"title":"Description","type":"string"},"kind":{"description":"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 here but lacks a tool, field or option the task needed. other: anything else.","enum":["bug","error","feature_request","missing_feature","other"],"title":"Kind","type":"string"},"title":{"description":"One line, e.g. 'skool_list_members stops after 50 members'.","maxLength":200,"minLength":3,"title":"Title","type":"string"},"tool":{"anyOf":[{"maxLength":160,"type":"string"},{"type":"null"}],"default":null,"description":"Tool or endpoint name, e.g. 'skool_list_members'.","title":"Tool"}},"required":["kind","title","description"],"title":"AgentReportCreate","type":"object"},"name":"cotlet_report_issue"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"apps":{"description":"App slugs, e.g. [\"skool\", \"substack\"].","items":{"type":"string"},"maxItems":10,"minItems":1,"type":"array"},"use_case":{"description":"What the user wants the agent to do in these apps, in their words.","maxLength":1000,"type":"string"}},"required":["apps"],"type":"object"},"name":"cotlet_request_apps"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"content_type":{"description":"MIME type, e.g. image/jpeg.","type":"string"},"name":{"description":"File name, e.g. photo.jpg.","type":"string"}},"type":"object"},"name":"cotlet_upload_file"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{},"type":"object"},"name":"cotlet_whoami"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"height_in":{"exclusiveMinimum":0,"maximum":130,"type":"number"},"insured_value_usd":{"maximum":10000,"minimum":0,"type":"number"},"length_in":{"exclusiveMinimum":0,"maximum":130,"type":"number"},"package_preset_id":{"description":"A saved package: its type, size and weight replace the fields above.","type":"string"},"packaging":{"default":"Parcel","enum":["Parcel","SoftEnvelope","Irregular","SmallFlatRateBox","MediumFlatRateBox","LargeFlatRateBox","FlatRateEnvelope","FlatRateLegalEnvelope","FlatRatePaddedEnvelope"],"type":"string"},"ship_from_id":{"description":"Ship-from address id; default: the account's default.","type":"string"},"shipments":{"items":{"additionalProperties":false,"properties":{"address1":{"maxLength":100,"minLength":1,"type":"string"},"address2":{"maxLength":100,"type":"string"},"city":{"maxLength":60,"minLength":1,"type":"string"},"company":{"maxLength":100,"type":"string"},"country":{"default":"US","pattern":"^[A-Z]{2}$","type":"string"},"email":{"maxLength":120,"type":"string"},"full_name":{"maxLength":100,"minLength":1,"type":"string"},"height_in":{"exclusiveMinimum":0,"maximum":130,"type":"number"},"length_in":{"exclusiveMinimum":0,"maximum":130,"type":"number"},"order_id":{"description":"Your order number, kept on the label.","maxLength":50,"type":"string"},"phone":{"maxLength":30,"type":"string"},"rubber_stamp_1":{"maxLength":50,"type":"string"},"state":{"description":"State or region code, e.g. NY.","maxLength":60,"type":"string"},"weight_oz":{"description":"Overrides the package.","exclusiveMinimum":0,"maximum":2400,"type":"number"},"width_in":{"exclusiveMinimum":0,"maximum":130,"type":"number"},"zip":{"maxLength":12,"minLength":3,"type":"string"}},"required":["full_name","address1","city","zip"],"type":"object"},"maxItems":500,"minItems":1,"type":"array"},"signature":{"default":"none","enum":["none","signature","adult_signature"],"type":"string"},"title":{"description":"Batch name.","maxLength":100,"minLength":1,"type":"string"},"weight_oz":{"description":"Weight in ounces.","exclusiveMinimum":0,"maximum":2400,"type":"number"},"width_in":{"exclusiveMinimum":0,"maximum":130,"type":"number"}},"required":["title","shipments"],"type":"object"},"name":"create_batch"},{"description":"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).","inputSchema":{"additionalProperties":false,"properties":{"order_ids":{"description":"Order ids from list_import_orders.","items":{"minLength":1,"type":"string"},"maxItems":500,"minItems":1,"type":"array"},"override_multiple":{"default":false,"description":"Use the saved package also for orders with several items.","type":"boolean"},"package_id":{"description":"Saved package id from list_saved_packages.","minLength":1,"type":"string"},"ship_from_id":{"description":"From list_ship_from_addresses. Default: the default one.","type":"string"},"title":{"description":"Batch name. Default: today's date.","maxLength":100,"type":"string"}},"required":["order_ids","package_id"],"type":"object"},"name":"create_batch_from_orders"},{"description":"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 #].","inputSchema":{"additionalProperties":false,"properties":{"bcc_email":{"description":"A copy of every email goes here. Empty for none.","type":"string"},"default":{"default":false,"description":"Use it for new labels.","type":"boolean"},"html":{"description":"Body as HTML. Placeholders: [Recipient First Name], [Ship Date], [Shipping Service], [Recipient Address], [Tracking #].","maxLength":20000,"minLength":1,"type":"string"},"name":{"description":"Template name in Settings.","maxLength":100,"minLength":1,"type":"string"},"sender_email":{"description":"Reply-to address recipients see.","format":"email","type":"string"},"sender_name":{"maxLength":100,"minLength":1,"type":"string"},"subject":{"maxLength":200,"minLength":1,"type":"string"}},"required":["name","subject","html","sender_name","sender_email"],"type":"object"},"name":"create_email_template"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"default":{"default":false,"description":"Preselect it on new shipments.","type":"boolean"},"hazardous_materials":{"default":false,"type":"boolean"},"height_in":{"exclusiveMinimum":0,"maximum":130,"type":"number"},"insured_value_usd":{"default":0,"maximum":10000,"minimum":0,"type":"number"},"irregular":{"default":false,"type":"boolean"},"length_in":{"exclusiveMinimum":0,"maximum":130,"type":"number"},"media_mail":{"default":false,"description":"Qualifies for USPS Media Mail.","type":"boolean"},"packaging":{"default":"Parcel","enum":["Parcel","SoftEnvelope","Irregular","SmallFlatRateBox","MediumFlatRateBox","LargeFlatRateBox","FlatRateEnvelope","FlatRateLegalEnvelope","FlatRatePaddedEnvelope"],"type":"string"},"return_label":{"default":"none","description":"return: return labels only; standard_and_return: an extra return label.","enum":["none","return","standard_and_return"],"type":"string"},"signature":{"default":"none","enum":["none","signature","adult_signature"],"type":"string"},"title":{"description":"Name shown in Saved Packages.","maxLength":100,"minLength":1,"type":"string"},"weight_oz":{"description":"0 leaves the weight to each label.","maximum":2400,"minimum":0,"type":"number"},"width_in":{"exclusiveMinimum":0,"maximum":130,"type":"number"}},"required":["title","packaging"],"type":"object"},"name":"create_saved_package"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"batch_id":{"description":"Only the labels of this batch (ignores ship_date).","type":"string"},"from_address_id":{"description":"Ship From Address, when you ship from more than one. Default: the default one.","type":"string"},"ship_date":{"description":"Labels of this Ship Date. Default: today.","format":"date","type":"string"}},"required":[],"type":"object"},"name":"create_scan_form"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"origin":{"additionalProperties":false,"properties":{"address1":{"description":"Street and number.","maxLength":100,"minLength":1,"type":"string"},"address2":{"description":"Apt, unit, suite.","maxLength":100,"type":"string"},"city":{"maxLength":60,"minLength":1,"type":"string"},"company":{"maxLength":100,"type":"string"},"full_name":{"maxLength":100,"minLength":1,"type":"string"},"phone":{"maxLength":20,"type":"string"},"state":{"description":"US state code, e.g. NC.","maxLength":2,"minLength":2,"type":"string"},"zip":{"maxLength":10,"minLength":5,"type":"string"}},"required":["full_name","address1","city","state","zip"],"type":"object"},"return_address":{"additionalProperties":false,"description":"Where returns go. Default: the origin.","properties":{"address1":{"description":"Street and number.","maxLength":100,"minLength":1,"type":"string"},"address2":{"description":"Apt, unit, suite.","maxLength":100,"type":"string"},"city":{"maxLength":60,"minLength":1,"type":"string"},"company":{"maxLength":100,"type":"string"},"full_name":{"maxLength":100,"minLength":1,"type":"string"},"phone":{"maxLength":20,"type":"string"},"state":{"description":"US state code, e.g. NC.","maxLength":2,"minLength":2,"type":"string"},"zip":{"maxLength":10,"minLength":5,"type":"string"}},"required":["full_name","address1","city","state","zip"],"type":"object"},"title":{"description":"Name in the address list.","maxLength":100,"minLength":1,"type":"string"}},"required":["title","origin"],"type":"object"},"name":"create_ship_from_address"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"address_correction":{"default":"ask","description":"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.","enum":["ask","accept","skip"],"type":"string"},"height_in":{"exclusiveMinimum":0,"maximum":130,"type":"number"},"insured_value_usd":{"maximum":10000,"minimum":0,"type":"number"},"length_in":{"exclusiveMinimum":0,"maximum":130,"type":"number"},"package_preset_id":{"description":"A saved package: its type, size and weight replace the fields above.","type":"string"},"packaging":{"default":"Parcel","enum":["Parcel","SoftEnvelope","Irregular","SmallFlatRateBox","MediumFlatRateBox","LargeFlatRateBox","FlatRateEnvelope","FlatRateLegalEnvelope","FlatRatePaddedEnvelope"],"type":"string"},"rubber_stamp_1":{"description":"Extra text printed on the label.","maxLength":50,"type":"string"},"rubber_stamp_2":{"maxLength":50,"type":"string"},"ship_from_id":{"description":"Ship-from address id; default: the account's default.","type":"string"},"signature":{"default":"none","enum":["none","signature","adult_signature"],"type":"string"},"to":{"additionalProperties":false,"properties":{"address1":{"maxLength":100,"minLength":1,"type":"string"},"address2":{"maxLength":100,"type":"string"},"city":{"maxLength":60,"minLength":1,"type":"string"},"company":{"maxLength":100,"type":"string"},"country":{"default":"US","pattern":"^[A-Z]{2}$","type":"string"},"email":{"maxLength":120,"type":"string"},"full_name":{"maxLength":100,"minLength":1,"type":"string"},"phone":{"maxLength":30,"type":"string"},"state":{"description":"State or region code, e.g. NY.","maxLength":60,"type":"string"},"zip":{"maxLength":12,"minLength":3,"type":"string"}},"required":["full_name","address1","city","zip"],"type":"object"},"weight_oz":{"description":"Weight in ounces.","exclusiveMinimum":0,"maximum":2400,"type":"number"},"width_in":{"exclusiveMinimum":0,"maximum":130,"type":"number"}},"required":["to"],"type":"object"},"name":"create_shipment"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"batch_id":{"minLength":1,"type":"string"}},"required":["batch_id"],"type":"object"},"name":"delete_batch"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"template_id":{"description":"id from list_email_templates.","minLength":1,"type":"string"}},"required":["template_id"],"type":"object"},"name":"delete_email_template"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"package_id":{"description":"id from list_saved_packages.","minLength":1,"type":"string"}},"required":["package_id"],"type":"object"},"name":"delete_saved_package"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"address_id":{"description":"id from list_ship_from_addresses.","minLength":1,"type":"string"}},"required":["address_id"],"type":"object"},"name":"delete_ship_from_address"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"reason":{"description":"Why the adjustment is wrong, as you would write it to Pirate Ship support.","maxLength":2000,"minLength":10,"type":"string"},"shipment_id":{"description":"shipment_id of the adjusted label, from list_carrier_adjustments.","pattern":"^[0-9]+$","type":"string"}},"required":["shipment_id","reason"],"type":"object"},"name":"dispute_adjustment"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"batch_id":{"description":"Every printable label of this batch.","type":"string"},"shipment_ids":{"items":{"type":"string"},"maxItems":100,"minItems":1,"type":"array"}},"required":[],"type":"object"},"name":"download_labels"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"from_date":{"description":"First day, YYYY-MM-DD, in your timezone.","format":"date","type":"string"},"report":{"enum":["transactions","refunds","receipts","return_labels","carrier_adjustments"],"type":"string"},"search":{"description":"Free text, as in the report's search box.","maxLength":200,"type":"string"},"sort":{"default":"newest","description":"Order by date.","enum":["newest","oldest"],"type":"string"},"to_date":{"description":"Last day, YYYY-MM-DD, included.","format":"date","type":"string"}},"required":["report"],"type":"object"},"name":"export_report"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"batch":{"description":"Batch titles.","items":{"maxLength":100,"type":"string"},"maxItems":20,"type":"array"},"carrier":{"description":"USPS or UPS.","items":{"maxLength":100,"type":"string"},"maxItems":20,"type":"array"},"from_date":{"description":"First day, YYYY-MM-DD, in your timezone.","format":"date","type":"string"},"search":{"description":"Free text, as in the report's search box.","maxLength":200,"type":"string"},"sort":{"default":"newest","description":"Order by date.","enum":["newest","oldest"],"type":"string"},"status":{"description":"Label status as the report shows it, e.g. Printed, Refunded.","items":{"maxLength":100,"type":"string"},"maxItems":20,"type":"array"},"to_date":{"description":"Last day, YYYY-MM-DD, included.","format":"date","type":"string"},"tracking_status":{"description":"Tracking status as the report shows it, e.g. Delivered, In Transit.","items":{"maxLength":100,"type":"string"},"maxItems":20,"type":"array"}},"required":[],"type":"object"},"name":"export_shipments"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{},"required":[],"type":"object"},"name":"get_account_balance"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"batch_id":{"description":"From create_shipment or list_batches.","minLength":1,"type":"string"}},"required":["batch_id"],"type":"object"},"name":"get_batch"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{},"required":[],"type":"object"},"name":"get_label_settings"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"carrier":{"enum":["usps","ups"],"type":"string"},"close_time":{"default":"17:00","description":"UPS only.","pattern":"^[0-2][0-9]:[0-5][0-9]$","type":"string"},"date":{"description":"UPS only: pickup day. USPS comes next delivery day.","format":"date","type":"string"},"instructions":{"description":"Where to find the packages, with OTHER.","maxLength":200,"type":"string"},"location":{"default":"FRONT_DOOR","enum":["FRONT_DOOR","BACK_DOOR","SIDE_DOOR","MAIL_ROOM","OFFICE","RECEPTION","OTHER"],"type":"string"},"overweight":{"default":false,"description":"UPS: a package over 70 lb.","type":"boolean"},"package_count":{"maximum":500,"minimum":1,"type":"integer"},"ready_time":{"default":"09:00","description":"UPS only.","pattern":"^[0-2][0-9]:[0-5][0-9]$","type":"string"},"ship_from_id":{"description":"From list_ship_from_addresses. Default: the default one.","type":"string"},"total_weight_oz":{"exclusiveMinimum":0,"maximum":100000,"type":"number"}},"required":["carrier","package_count","total_weight_oz"],"type":"object"},"name":"get_pickup_quote"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"height_in":{"exclusiveMinimum":0,"maximum":130,"type":"number"},"length_in":{"exclusiveMinimum":0,"maximum":130,"type":"number"},"packaging":{"default":"Parcel","enum":["Parcel","SoftEnvelope","Irregular","SmallFlatRateBox","MediumFlatRateBox","LargeFlatRateBox","FlatRateEnvelope","FlatRateLegalEnvelope","FlatRatePaddedEnvelope"],"type":"string"},"residential":{"default":true,"description":"The destination is a home.","type":"boolean"},"to_country":{"default":"US","description":"Destination country, ISO 3166-1 alpha-2.","pattern":"^[A-Z]{2}$","type":"string"},"to_zip":{"description":"Destination ZIP or postcode.","maxLength":12,"minLength":3,"type":"string"},"weight_oz":{"description":"Weight in ounces.","exclusiveMinimum":0,"maximum":2400,"type":"number"},"width_in":{"exclusiveMinimum":0,"maximum":130,"type":"number"}},"required":["to_zip","weight_oz"],"type":"object"},"name":"get_rates"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"receipt_id":{"description":"receipt_id from list_receipts.","pattern":"^[0-9]+$","type":"string"}},"required":["receipt_id"],"type":"object"},"name":"get_receipt"},{"description":"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).","inputSchema":{"additionalProperties":false,"properties":{"batch_id":{"description":"Saves one request when known.","type":"string"},"shipment_id":{"description":"From get_batch or list_shipments.","minLength":1,"type":"string"}},"required":["shipment_id"],"type":"object"},"name":"get_shipment"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"from_date":{"description":"First day, YYYY-MM-DD. Default 30 days ago.","format":"date","type":"string"},"to_date":{"description":"Last day, YYYY-MM-DD, included. Default today.","format":"date","type":"string"}},"required":[],"type":"object"},"name":"get_shipping_stats"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{},"required":[],"type":"object"},"name":"get_tracking_email_settings"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"order_ids":{"description":"Order ids from list_import_orders.","items":{"minLength":1,"type":"string"},"maxItems":500,"minItems":1,"type":"array"}},"required":["order_ids"],"type":"object"},"name":"ignore_orders"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"page":{"default":0,"description":"0 is the newest page.","minimum":0,"type":"integer"}},"required":[],"type":"object"},"name":"list_batches"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"carrier":{"description":"USPS or UPS.","items":{"maxLength":100,"type":"string"},"maxItems":20,"type":"array"},"from_date":{"description":"First day, YYYY-MM-DD, in your timezone.","format":"date","type":"string"},"limit":{"default":25,"description":"Rows per page, 1 to 100.","maximum":100,"minimum":1,"type":"integer"},"offset":{"default":0,"description":"Rows to skip: the next page starts at offset + limit while it is below total.","minimum":0,"type":"integer"},"search":{"description":"Free text, as in the report's search box.","maxLength":200,"type":"string"},"sort":{"default":"newest","description":"Order by date.","enum":["newest","oldest"],"type":"string"},"status":{"description":"Adjustment status as the table shows it.","items":{"maxLength":100,"type":"string"},"maxItems":20,"type":"array"},"to_date":{"description":"Last day, YYYY-MM-DD, included.","format":"date","type":"string"}},"required":[],"type":"object"},"name":"list_carrier_adjustments"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{},"required":[],"type":"object"},"name":"list_email_templates"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"ignored":{"default":false,"description":"Show the ignored orders instead.","type":"boolean"},"limit":{"default":25,"description":"Rows per page, 1 to 100.","maximum":100,"minimum":1,"type":"integer"},"offset":{"default":0,"description":"Rows to skip: the next page starts at offset + limit while it is below total.","minimum":0,"type":"integer"},"search":{"description":"Free text, as in the report's search box.","maxLength":200,"type":"string"}},"required":[],"type":"object"},"name":"list_import_orders"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{},"required":[],"type":"object"},"name":"list_package_types"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{},"required":[],"type":"object"},"name":"list_pickups"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"from_date":{"description":"First day, YYYY-MM-DD, in your timezone.","format":"date","type":"string"},"limit":{"default":25,"description":"Rows per page, 1 to 100.","maximum":100,"minimum":1,"type":"integer"},"offset":{"default":0,"description":"Rows to skip: the next page starts at offset + limit while it is below total.","minimum":0,"type":"integer"},"search":{"description":"Free text, as in the report's search box.","maxLength":200,"type":"string"},"sort":{"default":"newest","description":"Order by date.","enum":["newest","oldest"],"type":"string"},"status":{"description":"Payment status as the table shows it.","items":{"maxLength":100,"type":"string"},"maxItems":20,"type":"array"},"to_date":{"description":"Last day, YYYY-MM-DD, included.","format":"date","type":"string"}},"required":[],"type":"object"},"name":"list_receipts"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"from_date":{"description":"First day, YYYY-MM-DD, in your timezone.","format":"date","type":"string"},"limit":{"default":25,"description":"Rows per page, 1 to 100.","maximum":100,"minimum":1,"type":"integer"},"offset":{"default":0,"description":"Rows to skip: the next page starts at offset + limit while it is below total.","minimum":0,"type":"integer"},"search":{"description":"Free text, as in the report's search box.","maxLength":200,"type":"string"},"sort":{"default":"newest","description":"Order by date.","enum":["newest","oldest"],"type":"string"},"status":{"description":"Refund status as the table shows it, e.g. Pending, Approved, Declined.","items":{"maxLength":100,"type":"string"},"maxItems":20,"type":"array"},"to_date":{"description":"Last day, YYYY-MM-DD, included.","format":"date","type":"string"}},"required":[],"type":"object"},"name":"list_refunds"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"from_date":{"description":"First day, YYYY-MM-DD, in your timezone.","format":"date","type":"string"},"limit":{"default":25,"description":"Rows per page, 1 to 100.","maximum":100,"minimum":1,"type":"integer"},"offset":{"default":0,"description":"Rows to skip: the next page starts at offset + limit while it is below total.","minimum":0,"type":"integer"},"search":{"description":"Free text, as in the report's search box.","maxLength":200,"type":"string"},"sort":{"default":"newest","description":"Order by date.","enum":["newest","oldest"],"type":"string"},"status":{"description":"Return label status as the table shows it.","items":{"maxLength":100,"type":"string"},"maxItems":20,"type":"array"},"to_date":{"description":"Last day, YYYY-MM-DD, included.","format":"date","type":"string"}},"required":[],"type":"object"},"name":"list_return_labels"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{},"required":[],"type":"object"},"name":"list_saved_packages"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{},"required":[],"type":"object"},"name":"list_scan_forms"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{},"required":[],"type":"object"},"name":"list_ship_from_addresses"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"batch":{"description":"Batch titles.","items":{"maxLength":100,"type":"string"},"maxItems":20,"type":"array"},"carrier":{"description":"USPS or UPS.","items":{"maxLength":100,"type":"string"},"maxItems":20,"type":"array"},"from_date":{"description":"First day, YYYY-MM-DD, in your timezone.","format":"date","type":"string"},"limit":{"default":25,"description":"Rows per page, 1 to 100.","maximum":100,"minimum":1,"type":"integer"},"offset":{"default":0,"description":"Rows to skip: the next page starts at offset + limit while it is below total.","minimum":0,"type":"integer"},"search":{"description":"Free text, as in the report's search box.","maxLength":200,"type":"string"},"sort":{"default":"newest","description":"Order by date.","enum":["newest","oldest"],"type":"string"},"status":{"description":"Label status as the report shows it, e.g. Printed, Refunded.","items":{"maxLength":100,"type":"string"},"maxItems":20,"type":"array"},"to_date":{"description":"Last day, YYYY-MM-DD, included.","format":"date","type":"string"},"tracking_status":{"description":"Tracking status as the report shows it, e.g. Delivered, In Transit.","items":{"maxLength":100,"type":"string"},"maxItems":20,"type":"array"}},"required":[],"type":"object"},"name":"list_shipments"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{},"required":[],"type":"object"},"name":"list_store_connections"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"from_date":{"description":"First day, YYYY-MM-DD, in your timezone.","format":"date","type":"string"},"limit":{"default":25,"description":"Rows per page, 1 to 100.","maximum":100,"minimum":1,"type":"integer"},"offset":{"default":0,"description":"Rows to skip: the next page starts at offset + limit while it is below total.","minimum":0,"type":"integer"},"search":{"description":"Free text, as in the report's search box.","maxLength":200,"type":"string"},"sort":{"default":"newest","description":"Order by date.","enum":["newest","oldest"],"type":"string"},"to_date":{"description":"Last day, YYYY-MM-DD, included.","format":"date","type":"string"},"type":{"description":"Transaction types as the table shows them, e.g. Label, Payment, Refund.","items":{"maxLength":100,"type":"string"},"maxItems":20,"type":"array"}},"required":[],"type":"object"},"name":"list_transactions"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"text":{"description":"An address as written, lines separated by newlines or commas.","maxLength":500,"minLength":5,"type":"string"}},"required":["text"],"type":"object"},"name":"parse_address"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"batch_id":{"minLength":1,"type":"string"}},"required":["batch_id"],"type":"object"},"name":"refund_batch"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"shipment_id":{"description":"From get_batch or list_shipments.","minLength":1,"type":"string"}},"required":["shipment_id"],"type":"object"},"name":"refund_label"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"batch_id":{"description":"batch_id from list_batches or create_batch.","minLength":1,"type":"string"},"title":{"description":"The new title, up to 100 characters.","maxLength":100,"minLength":1,"type":"string"}},"required":["batch_id","title"],"type":"object"},"name":"rename_batch"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"carrier":{"enum":["usps","ups"],"type":"string"},"close_time":{"default":"17:00","description":"UPS only.","pattern":"^[0-2][0-9]:[0-5][0-9]$","type":"string"},"date":{"description":"UPS only: pickup day. USPS comes next delivery day.","format":"date","type":"string"},"instructions":{"description":"Where to find the packages, with OTHER.","maxLength":200,"type":"string"},"location":{"default":"FRONT_DOOR","enum":["FRONT_DOOR","BACK_DOOR","SIDE_DOOR","MAIL_ROOM","OFFICE","RECEPTION","OTHER"],"type":"string"},"overweight":{"default":false,"description":"UPS: a package over 70 lb.","type":"boolean"},"package_count":{"maximum":500,"minimum":1,"type":"integer"},"ready_time":{"default":"09:00","description":"UPS only.","pattern":"^[0-2][0-9]:[0-5][0-9]$","type":"string"},"ship_from_id":{"description":"From list_ship_from_addresses. Default: the default one.","type":"string"},"total_weight_oz":{"exclusiveMinimum":0,"maximum":100000,"type":"number"}},"required":["carrier","package_count","total_weight_oz"],"type":"object"},"name":"schedule_pickup"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"field":{"default":"name","enum":["name","email","phone"],"type":"string"},"query":{"maxLength":100,"minLength":2,"type":"string"}},"required":["query"],"type":"object"},"name":"search_recipients"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"address_id":{"description":"id from list_ship_from_addresses.","minLength":1,"type":"string"}},"required":["address_id"],"type":"object"},"name":"set_default_ship_from_address"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"wait_seconds":{"default":20,"description":"How long to wait for the sync to finish; 0 only starts it.","maximum":60,"minimum":0,"type":"integer"}},"required":[],"type":"object"},"name":"sync_store_orders"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"order_ids":{"description":"Order ids from list_import_orders.","items":{"minLength":1,"type":"string"},"maxItems":500,"minItems":1,"type":"array"}},"required":["order_ids"],"type":"object"},"name":"unignore_orders"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"bcc_email":{"description":"A copy of every email goes here. Empty for none.","type":"string"},"default":{"default":false,"description":"Use it for new labels.","type":"boolean"},"html":{"description":"Body as HTML. Placeholders: [Recipient First Name], [Ship Date], [Shipping Service], [Recipient Address], [Tracking #].","maxLength":20000,"minLength":1,"type":"string"},"name":{"description":"Template name in Settings.","maxLength":100,"minLength":1,"type":"string"},"sender_email":{"description":"Reply-to address recipients see.","format":"email","type":"string"},"sender_name":{"maxLength":100,"minLength":1,"type":"string"},"subject":{"maxLength":200,"minLength":1,"type":"string"},"template_id":{"description":"id from list_email_templates.","minLength":1,"type":"string"}},"required":["template_id"],"type":"object"},"name":"update_email_template"},{"description":"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.","inputSchema":{"additionalProperties":false,"minProperties":1,"properties":{"address_correction":{"description":"What Pirate Ship does when it finds a better address: nothing, ask, or correct it.","enum":["off","confirm","automatic"],"type":"string"},"label_format":{"description":"PDF, or ZPLII for thermal printers.","enum":["pdf","zpl"],"type":"string"},"label_size":{"description":"Label size in inches.","enum":["4x6","2x7"],"type":"string"},"logo_on_label":{"type":"boolean"},"mobile_codes":{"description":"Offer USPS label-free QR codes.","type":"boolean"},"packing_list":{"enum":["none","with_gift_message","gift_message_only"],"type":"string"},"report_format":{"description":"Spreadsheet format of exports.","enum":["xlsx","csv"],"type":"string"}},"required":[],"type":"object"},"name":"update_label_settings"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"default":{"default":false,"description":"Preselect it on new shipments.","type":"boolean"},"hazardous_materials":{"default":false,"type":"boolean"},"height_in":{"exclusiveMinimum":0,"maximum":130,"type":"number"},"insured_value_usd":{"default":0,"maximum":10000,"minimum":0,"type":"number"},"irregular":{"default":false,"type":"boolean"},"length_in":{"exclusiveMinimum":0,"maximum":130,"type":"number"},"media_mail":{"default":false,"description":"Qualifies for USPS Media Mail.","type":"boolean"},"package_id":{"description":"id from list_saved_packages.","minLength":1,"type":"string"},"packaging":{"default":"Parcel","enum":["Parcel","SoftEnvelope","Irregular","SmallFlatRateBox","MediumFlatRateBox","LargeFlatRateBox","FlatRateEnvelope","FlatRateLegalEnvelope","FlatRatePaddedEnvelope"],"type":"string"},"return_label":{"default":"none","description":"return: return labels only; standard_and_return: an extra return label.","enum":["none","return","standard_and_return"],"type":"string"},"signature":{"default":"none","enum":["none","signature","adult_signature"],"type":"string"},"title":{"description":"Name shown in Saved Packages.","maxLength":100,"minLength":1,"type":"string"},"weight_oz":{"description":"0 leaves the weight to each label.","maximum":2400,"minimum":0,"type":"number"},"width_in":{"exclusiveMinimum":0,"maximum":130,"type":"number"}},"required":["package_id"],"type":"object"},"name":"update_saved_package"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"address_id":{"description":"id from list_ship_from_addresses.","minLength":1,"type":"string"},"origin":{"additionalProperties":false,"properties":{"address1":{"description":"Street and number.","maxLength":100,"minLength":1,"type":"string"},"address2":{"description":"Apt, unit, suite.","maxLength":100,"type":"string"},"city":{"maxLength":60,"minLength":1,"type":"string"},"company":{"maxLength":100,"type":"string"},"full_name":{"maxLength":100,"minLength":1,"type":"string"},"phone":{"maxLength":20,"type":"string"},"state":{"description":"US state code, e.g. NC.","maxLength":2,"minLength":2,"type":"string"},"zip":{"maxLength":10,"minLength":5,"type":"string"}},"required":["full_name","address1","city","state","zip"],"type":"object"},"origin_is_return":{"description":"true sends returns to the origin.","type":"boolean"},"return_address":{"additionalProperties":false,"description":"A separate return address.","properties":{"address1":{"description":"Street and number.","maxLength":100,"minLength":1,"type":"string"},"address2":{"description":"Apt, unit, suite.","maxLength":100,"type":"string"},"city":{"maxLength":60,"minLength":1,"type":"string"},"company":{"maxLength":100,"type":"string"},"full_name":{"maxLength":100,"minLength":1,"type":"string"},"phone":{"maxLength":20,"type":"string"},"state":{"description":"US state code, e.g. NC.","maxLength":2,"minLength":2,"type":"string"},"zip":{"maxLength":10,"minLength":5,"type":"string"}},"required":["full_name","address1","city","state","zip"],"type":"object"},"title":{"maxLength":100,"minLength":1,"type":"string"}},"required":["address_id"],"type":"object"},"name":"update_ship_from_address"},{"description":"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.","inputSchema":{"additionalProperties":false,"properties":{"delay":{"description":"When the email goes out after purchase; +24 hours is next day 9:00 AM.","enum":["+1 second","+1 hour","+2 hour","+3 hours","+6 hours","+12 hours","+24 hours","+2 days","+3 days","+4 days","+5 days","+6 days","+7 days"],"type":"string"},"enabled":{"description":"Send tracking emails on new labels by default.","type":"boolean"}},"required":[],"type":"object"},"name":"update_tracking_email_settings"}]},"body_sha256":"70e2c42e7afa900b916a8f5b51f4e1abb645dadf0c3e72d323798c05e9388fe5","prev_id":null,"leaf":"0xb88cd5dd520c7a0b60c0e1dcd78425514398292956c5364ced2955a5eefa16e3","leaf_text":"{\"body\":\"70e2c42e7afa900b916a8f5b51f4e1abb645dadf0c3e72d323798c05e9388fe5\",\"id\":565008,\"kind\":\"mcp.tools\",\"method\":\"probe.mcp/1\",\"observed_us\":1793137986869140,\"prev\":null,\"subject\":\"5eb64623-6de7-45c2-a9d7-5fc22deec1e8\",\"subject_kind\":\"endpoint\"}","day":{"day":"2026-10-27","leaves":273461,"root":"0xdd77e5e99da32c3f154180d63e3c3e6fe11e896a2c6896412ef6b5c4bcf7e795","chained":"0x23bb4dfd09f55c15ac3962f53578e02c6114d5bfd9bb451cf8794fb6e2817ef4","anchor_chain":"eip155:5042002","anchor_tx":"0xb2ebd83aafeb765a0ce66e76aefb133ed06606c98038fd56191e2bcd1dcb77b4","anchor_block":69414147},"proof":["0xb88c92586a1768688e829c3a6ad7f41fe960a42b560a2b157cd70179c043033b","0x18804e9cd43f45ef0ee462586fc7544c73b525c5cd4928ef429d6c1e2ccabcc7","0x116b02f290080b0ee08edd8f351487334a3f896417f607642ccb0b884a535512","0xded723929294c6679d37c84dde0434a7cd653e5ad6e3b82a928af2eb2ce72a7a","0xcb02164c16b813a8449d198353021b7be261eb3f5d59cb6d93db264e865b15b1","0xf530f9bda20197b212d426707aa720348533e8bd915201561524ffd3b6457b5f","0x909a2154a63821e09e64eb485e14ef6eefef4766938e3957051eeb2e0a1f03f8","0xcfca3f216f2d5a2bb619ea50897479bbec5b2e26fd92f50373a86d7cefa688fb","0xc01a495fa269cf5f9e5c331be42f80a553163576f186dcadda7c6d916b1c6240","0x38d0f3e33fa9508c1d51117f86840b0c25a750ee552fe4bb39edf622d70eef97","0x70b11259f0c8e64fe21c951a7fa6fa7010ca86464b77ae2a7b96e2a53a553c1c","0xdc4af1861bcc27178db9854c119413a3d8acb113ca467e0eb6c0cadd8a60ba5d","0xdb8e341e9690aa686b29432c7b868b3859fb692c3ae3a679b8bc1219ebe3a597","0x87cb8935612c40b569de008a9bf8218cd24a06f74a7364a1654613d972fe00ed","0xec7bb68216a4deb1960acfbbd75da88f7e468b58adb9cf3ec62f2790e46508b3","0x64c405a28e8819716221eb2529fe4ce277ab08025e17e685cbd5ece75ceb75c7","0xf30fddbf4811226c58e8f0daf36fddd79fc5f1356b592bb1d99a8061ddbabe66","0x2bf8151e5f157dd183b9de6fa00469551932a7a6e3f33a694895000ac9061197","0x9fc354c0ea3efc3f1b6548bb77ea902a50f2c9647647ea61592efce2bd795699"]}