# Printdash (remote · api.printdash.io)

Online printing for Australia: products, exact prices, quotes, artwork checks and orders.

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

## Components

- remote · `api.printdash.io`: 70/100 (this document), [markdown](https://verifymcp.io/servers/io-printdash-printdash/functions-v1-mcp.md), [page](https://verifymcp.io/servers/io-printdash-printdash/functions-v1-mcp)

## Channel facts

- Endpoint: `https://api.printdash.io/functions/v1/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.6.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation check failed: no authorisation is required to call this server, and it exposes a tool marked destructive (set_context).
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 81/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 9225 tokens (~124/item across 74 items; 58 tools + 16 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 93/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 75% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 6 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 60 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).
  - Supports UI / widget rendering.

## Install

### How do I install the Printdash MCP server?

Printdash is a hosted endpoint at https://api.printdash.io/functions/v1/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http io-printdash-printdash 'https://api.printdash.io/functions/v1/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "io-printdash-printdash": {
      "url": "https://api.printdash.io/functions/v1/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "io-printdash-printdash": {
      "type": "http",
      "url": "https://api.printdash.io/functions/v1/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.io-printdash-printdash]
url = "https://api.printdash.io/functions/v1/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-printdash-printdash": {
      "type": "remote",
      "url": "https://api.printdash.io/functions/v1/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-printdash-printdash --url 'https://api.printdash.io/functions/v1/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-printdash-printdash:
    url: "https://api.printdash.io/functions/v1/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "io-printdash-printdash": {
      "Transport": "http",
      "Url": "https://api.printdash.io/functions/v1/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add io-printdash-printdash -t streamable-http -u 'https://api.printdash.io/functions/v1/mcp'
```

### Other

```json
{
  "mcpServers": {
    "io-printdash-printdash": {
      "type": "http",
      "url": "https://api.printdash.io/functions/v1/mcp"
    }
  }
}
```

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

## Changelog

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

### 2026-11-03 (score 70, +1)

- [security] The server rewrote its instructions, which are the text every model session reads
- [security] Tool “get_mockup” rewrote its description, which is the text the model reads
- [functional] First check of Capabilities: pass
- [functional] New resource “Printdash card”

### 2026-11-02 (score 69, 0)

- [security] The server rewrote its instructions, which are the text every model session reads
- [security] Tool “get_artwork_guide” rewrote its description, which is the text the model reads
- [security] Tool “get_artwork_requirements” rewrote its description, which is the text the model reads
- [cosmetic] “get_artwork_requirements” reworded the description of “configuration”

### 2026-11-01 (score 69, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-30 (score 68, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-10-29 (score 67)

First indexed and scored.

## MCP tools (58)

### `ping` (~40 tokens)

Check the Printdash connection

Checks that Printdash is reachable and says whether you are signed in. Printdash prints in Australia and delivers within Australia only; prices are in AUD and include GST.

Output parameters:

- `caller` (string)
- `currency` (string)
- `delivery` (string)
- `ok` (boolean)
- `server` (string)
- `service_area` (string)
- `signed_in` (boolean)
- `time` (string)
- `version` (string)

### `list_products` (~116 tokens)

List Printdash products

Every product Printdash sells (business cards, flyers, stickers, labels, booklets, signs, banners and more), with its id, a one-line description, its page and from_price: the starting price the site shows ("From $X inc GST for N", public retail for the product's default job). Start here or with search_products. A from_price is a guide only: price_job gives the exact price of the customer's job. Printdash prints in Australia and delivers within Australia only; prices are in AUD and include GST.

Output parameters:

- `count` (number)
- `currency` (string)
- `delivery` (string)
- `from_price_note` (string)
- `next` (string)
- `prices_include_gst` (boolean)
- `products` (array)
- `service_area` (string)

### `search_products` (~93 tokens)

Search Printdash products

Finds the Printdash products that match the customer's words ("A5 flyers", "round stickers", "pull up banner"), best first. Returns ids for get_product, each with the site's from_price (a starting price; price_job gives the exact one). Printdash prints in Australia and delivers within Australia only; prices are in AUD and include GST.

Input parameters:

- `query` (string, required): The customer's words for what they want printed.

Output parameters:

- `count` (number)
- `currency` (string)
- `from_price_note` (string)
- `next` (string)
- `prices_include_gst` (boolean)
- `products` (array)
- `query` (string)
- `service_area` (string)

### `get_product` (~138 tokens)

Get a product's options

The whole option form for one Printdash product, as its product page offers it: every field in the order to ask, whether it is required, each option's id and label, defaults, quantity and custom size limits, page counts, what is applied automatically, which stocks a finish is priced on, the product image, the artwork guides that apply, and default_configuration (the page's starting job, ready for price_job). Read this before asking the customer anything. Printdash prints in Australia and delivers within Australia only; prices are in AUD and include GST.

Input parameters:

- `product_id` (string, required): A product id from list_products or search_products.

Output parameters:

- `artwork_guides` (array)
- `binding` (string|null)
- `currency` (string)
- `default_configuration` (object)
- `description` (string|null)
- `designs` (object)
- `fields` (array)
- `image_url` (string|null)
- `next` (string)
- `option_matrix` (string)
- `prices_include_gst` (boolean)
- `product` (string)
- `product_id` (string)
- `service_area` (string)
- `template` (string)
- `url` (string)

### `match_options` (~164 tokens)

Match the customer's words to option ids

Turns the customer's words ("velvet", "A5", "double sided", "500", "90 x 55mm", "round corners") into option ids for one product, given what is already chosen. Returns matches, the ambiguous phrases with every candidate (never a guess: ask the customer), options not available with what is chosen, the words it could not place, and the configuration so far for price_job.

Input parameters:

- `chosen` (object): What is already chosen, so options are filtered by it (finishes the chosen stock does not offer, combinations the supplier cannot make).
- `phrases` (array, required): The customer's words, one option each: ["velvet", "A5", "double sided", "500"].
- `product_id` (string, required)

Output parameters:

- `ambiguous` (array)
- `configuration` (object)
- `matches` (array)
- `missing` (array)
- `next` (string)
- `not_available` (array)
- `problems` (array)
- `product` (string)
- `product_id` (string)
- `ready_to_price` (boolean)
- `unmatched` (array)
- `values` (array)

### `get_artwork_guide` (~256 tokens)

Get a Printdash artwork guide

Printdash's artwork setup guides as Markdown (bleed and safe zone, print-ready PDFs, colour, double-sided, cut lines, spot finishes, lamination, stocks, white ink, booklets, folding, wide format, Illustrator and InDesign export). Without a topic, the list. With a product (and its configuration), what that product's page says on the topic, sized for the job. The bleed, cut-line and booklet topics include Printdash's own diagram as an image: show that one, not a diagram from elsewhere. Answer file-setup questions from these tools, never from general knowledge: Printdash's bleed differs from the 3 mm many printers use.

Input parameters:

- `configuration` (object): The job, to size the product's lead (page size with bleed, pages, plate names).
- `product_id` (string): A product, for what its page says on the topic.
- `topic` (string): A guide id (bleed, pdf-export, colour, double-sided, dieline, spot-finishes, lamination, stock-finishes, white-ink, booklets, folding, wide-format, export-illustrator, export-indesign). Omit for the…

Output parameters:

- `diagrams` (array)
- `for_this_product` (string)
- `guide` (string)
- `guides` (array)
- `hidden_for_this_product` (boolean)
- `id` (string)
- `next` (string)
- `on_this_products_card` (boolean)
- `product` (string)
- `product_id` (string)
- `studio_note` (string)
- `summary` (string)
- `title` (string)
- `url` (string)

### `get_artwork_requirements` (~250 tokens)

Get the artwork requirements for a job

What a print-ready file must be for a product and configuration: finished size, bleed, safe zone, the PDF page size including bleed, pages or sides expected, the spot plate names a spot finish needs, the cut line rule, resolution, accepted file types and the size limit. The same rules the product page's guide card uses. File-setup facts must come from this tool, never from general knowledge: Printdash's bleed differs from the 3 mm many printers use (5 mm on most products). The size comes from the configuration, so build it with match_options first ("A5" is a size id); without one, or without a size, the answer is for the product page's default job (assumed_configuration) and lists size_options to ask the customer from. The answer includes Printdash's own diagram as an image: show that one.

Input parameters:

- `configuration` (object): The job, as for price_job (match_options builds it); its size sets the page size. Without one, or without a size, the answer is for the product page's default job (assumed_configuration), with size_o…
- `product_id` (string, required)

Output parameters:

- `accepted_file_types` (array)
- `assumed_configuration` (object)
- `bleed_mm` (number)
- `booklet` (boolean)
- `colour` (string)
- `configuration_missing` (array)
- `configuration_problems` (array)
- `cut_style`
- `cut_to_shape` (boolean)
- `diagrams` (array)
- `dieline_rule` (string|null)
- `finished_size_mm`
- `for_configuration` (boolean)
- `for_this_product` (object)
- `guides` (array)
- `max_file_mb` (number)
- `next` (string)
- `pages_expected` (number|null)
- `pdf_page_size_mm`
- `preferred_file_type` (string)
- `product` (string)
- `product_id` (string)
- `resolution_dpi` (number)
- `safe_zone_mm` (number)
- `sides` (number|null)
- `size_options` (array)
- `spot_plate_rule` (string|null)
- `spot_plates` (array)
- `studio_note` (string)

### `price_job` (~229 tokens)

Price a print job

Prices one exact job with Printdash's pricing engine: a product id and a configuration of option ids (from get_product or match_options). Returns the price ex GST, GST and total inc GST, turnaround, a config_id and a share_url that opens the job on printdash.io; with an Australian postcode (or, signed in, a saved address id) the delivered price too. Signed in, the price is the customer's own account price. If the job cannot be priced it says what is missing, what is wrong, or the nearest combinations that can be. Relay prices exactly as returned. Printdash prints in Australia and delivers within Australia only; prices are in AUD and include GST.

Input parameters:

- `address_id` (string): Signed in: a saved address id from list_addresses, instead of a postcode.
- `configuration` (object, required): The job, as option ids from get_product. Everything optional: the result says what is missing.
- `postcode` (string): An Australian postcode (four digits) for the delivered price. Printdash delivers within Australia only.
- `product_id` (string, required)

Output parameters:

- `config_id` (string)
- `configuration_input` (object)
- `currency` (string)
- `delivery`
- `designs` (number)
- `errors` (array)
- `missing` (array)
- `nearest` (array)
- `next` (string)
- `price` (object)
- `priced` (boolean)
- `prices_include_gst` (boolean)
- `product` (string)
- `product_id` (string)
- `quantity` (number)
- `quantity_per_design` (number|null)
- `reason` (string)
- `service_area` (string)
- `share_url` (string)
- `summary` (object)
- `turnaround` (string|null)

### `price_quantities` (~170 tokens)

Price a job at several quantities

The same job priced at up to 8 quantities (the price ladder), each from Printdash's pricing engine, with the delivered price when an Australian postcode is given. Relay prices exactly as returned. Printdash prints in Australia and delivers within Australia only; prices are in AUD and include GST.

Input parameters:

- `address_id` (string): Signed in: a saved address id from list_addresses, instead of a postcode.
- `configuration` (object, required): The job without its quantity (any quantity given is replaced).
- `postcode` (string): An Australian postcode (four digits) for the delivered price. Printdash delivers within Australia only.
- `product_id` (string, required)
- `quantities` (array, required): Up to 8 quantities, for example [250, 500, 1000, 2000].

Output parameters:

- `currency` (string)
- `next` (string)
- `priced_for` (string)
- `prices_include_gst` (boolean)
- `product` (string)
- `product_id` (string)
- `rows` (array)
- `service_area` (string)

### `estimate_delivery` (~144 tokens)

Estimate delivery within Australia

Whether Printdash delivers to an Australian postcode (or, signed in, a saved address) and, given the jobs being ordered, the delivery fee and the delivered total, priced the way checkout prices it. Australian postcodes only: anywhere else is refused, because Printdash delivers within Australia only. Prices in AUD; totals include GST.

Input parameters:

- `address_id` (string): Signed in: a saved address id from list_addresses, instead of a postcode.
- `jobs` (array): The jobs being ordered together; the fee depends on the order's value.
- `postcode` (string): An Australian postcode (four digits) for the delivered price. Printdash delivers within Australia only.

Output parameters:

- `currency` (string)
- `deliverable` (boolean)
- `delivery_unavailable` (boolean)
- `destination` (object)
- `gst` (number|null)
- `job_refused` (object)
- `lines` (array)
- `message` (string)
- `next` (string)
- `pickup_available` (boolean)
- `prices_include_gst` (boolean)
- `reason` (string)
- `service_area` (string)
- `shipping_ex_gst` (number|null)
- `shipping_label` (string|null)
- `subtotal_ex_gst` (number|null)
- `total_inc_gst` (number|null)

### `get_account` (~115 tokens)

Get the signed-in account

Who the signed-in customer is: name, company, pricing tier and its discount in percent (discount_percent 5 means 5% off, already in every price the pricing tools return), whether they are buying personally or as a Team (and their role), the Teams they can switch to, whether the Team orders on account, and what the account is still missing (a delivery address, a phone number). Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Output parameters:

- `active_context` (object)
- `buying_as` (string)
- `company` (string|null)
- `contexts` (array)
- `discount_percent` (number): Percent off the retail price: 5 means 5% off. Prices from the pricing tools already include it.
- `email` (string|null)
- `missing` (array)
- `name` (string|null)
- `next` (string)
- `on_account` (boolean)
- `orders_need_owner_approval` (boolean)
- `po_required` (boolean)
- `saved_addresses` (number)
- `terms` (string)
- `tier` (string)

### `set_context` (~101 tokens)

Switch between personal and a Team

Switches the account between buying personally and buying as one of its Teams, as the account menu's Viewing as does on printdash.io. Prices, quotes, orders and addresses follow the context. Pass team_id null for personal. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `team_id` (string|null, required): A team_id from get_account's contexts, or null for personal.

Output parameters:

- `active_context` (object)
- `buying_as` (string)
- `next` (string)
- `on_account` (boolean)
- `orders_need_owner_approval` (boolean)
- `po_required` (boolean)
- `switched` (boolean)
- `terms` (string)
- `tier` (string)

### `list_addresses` (~57 tokens)

List saved delivery addresses

The saved delivery addresses in the current buying context, the default first, with the ids price_job and estimate_delivery take. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Output parameters:

- `addresses` (array)
- `next` (string)

### `list_orders` (~81 tokens)

List recent orders

The most recent orders in the current buying context, each with its status as the order page shows it, payment, total, tracking and items. Read only. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `limit` (integer): How many, newest first (default 10).

Output parameters:

- `currency` (string)
- `next` (string)
- `orders` (array)
- `prices_include_gst` (boolean)

### `get_order` (~110 tokens)

Get one order

One order by its order number: status and payment as the order page shows them, every item with its job status, tracking, dispatch, delivery address, whether it can still be cancelled, whether the invoice is available, which items can be reordered, and the order page link. Read only. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `order` (string, required): The order number (or the order id from its link).

Output parameters:

- `awaiting_owner_approval` (boolean)
- `cancellable` (boolean)
- `currency` (string)
- `deliver_to` (string|null)
- `dispatch` (string|null)
- `due_date` (string|null)
- `invoice_available` (boolean)
- `items` (array)
- `next` (string)
- `on_account` (boolean)
- `order_id` (string)
- `order_number` (string)
- `payment` (string)
- `pickup` (boolean)
- `placed` (string)
- `po_number` (string|null)
- `prices_include_gst` (boolean)
- `reference` (string|null)
- `shipping_ex_gst` (number|null)
- `status` (string)
- `status_label` (string|null)
- `total_inc_gst` (number)
- `tracking`
- `url` (string)

### `list_quotes` (~90 tokens)

List saved quotes

The most recent saved quotes in the current buying context, each with its status as the Quotes list shows it, total (with delivery, as the Quotes list shows it), expiry and link. Read only. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `limit` (integer): How many, newest first (default 10).

Output parameters:

- `currency` (string)
- `next` (string)
- `prices_include_gst` (boolean)
- `quotes` (array)

### `get_quote` (~114 tokens)

Get one saved quote

One saved quote by its quote number: status, lines with their quoted quantities, the lines' subtotal, delivery and the total with delivery as the quote page shows it, expiry, the public share link if it has one, whether it can be converted to an order, and the quote page link. Read only. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `quote` (string, required): The quote number (or the quote id from its link).

Output parameters:

- `can_convert_to_order` (boolean)
- `created` (string)
- `currency` (string)
- `expires` (string|null)
- `lines` (array)
- `next` (string)
- `pickup` (boolean)
- `prices_include_gst` (boolean)
- `quote_number` (string)
- `reference` (string|null)
- `share_url` (string|null)
- `shipping_ex_gst` (number|null): Delivery ex GST; 0 for pickup, null when no address has priced it.
- `status` (string)
- `status_label` (string)
- `subtotal_inc_gst` (number): The lines' total inc GST, before delivery.
- `total_inc_gst` (number): The quote page's Total, inc GST: subtotal_inc_gst (the lines) plus delivery (shipping_ex_gst) and its GST.
- `url` (string)

### `create_address` (~205 tokens)

Save a delivery address

Saves an Australian delivery address to the address book in the current buying context (names, street, suburb, state code, four-digit postcode, optional company, mobile and type), optionally as the default. Collect it from the customer; never invent one. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `address_line1` (string, required): Street address.
- `address_line2` (string)
- `city` (string, required): Suburb or town.
- `company_name` (string)
- `first_name` (string, required)
- `last_name` (string, required)
- `mobile` (string)
- `postal_code` (string, required): Four-digit Australian postcode.
- `set_as_default` (boolean): Make it the default address for this buying context.
- `state` (string, required): NSW, VIC, QLD, SA, WA, TAS, NT or ACT.
- `type` (string)

Output parameters:

- `address` (object)
- `next` (string)
- `saved` (boolean)

### `update_address` (~217 tokens)

Change a saved address

Changes the fields given on one saved address (from list_addresses); the rest stay. If an order or quote was made with it, the change is saved as a new address with a new id (the result's address.id) and the orders and quotes keep the old one. Australian state codes and four-digit postcodes only. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `address_id` (string, required): An address id from list_addresses.
- `address_line1` (string): Street address.
- `address_line2` (string)
- `city` (string): Suburb or town.
- `company_name` (string)
- `first_name` (string)
- `last_name` (string)
- `mobile` (string)
- `postal_code` (string): Four-digit Australian postcode.
- `state` (string): NSW, VIC, QLD, SA, WA, TAS, NT or ACT.
- `type` (string)

Output parameters:

- `address` (object)
- `next` (string)
- `outcome` (string): replaced: an order or quote used the address, so the edit was saved as a new address (address.id is new) and the old one kept for those records (#669).
- `replaced_address_id` (string): The old id, when replaced. It no longer works.
- `updated` (array)

### `set_default_address` (~62 tokens)

Make an address the default

Makes one saved address the default for the current buying context; checkout and new quotes start from it. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `address_id` (string, required)

Output parameters:

- `default_address` (object)
- `next` (string)

### `delete_address` (~132 tokens)

Delete a saved address (asks first)

Prepares deleting one saved address: returns the summary to show the customer and a confirmation_token. Nothing is deleted until confirm is called with it after the customer agrees. An address an order or quote was made with leaves the address book but stays on those orders and quotes, as on printdash.io. The only saved address cannot be deleted: add the new one with create_address first. When the default is deleted, the newest other address becomes the default. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `address_id` (string, required)

Output parameters:

- `action` (string)
- `confirmation_required` (boolean)
- `confirmation_token` (string)
- `details` (object)
- `expires_at` (string)
- `next` (string)
- `summary` (string): Show this to the customer exactly as written before confirming.

### `get_cart` (~70 tokens)

Get the cart

The cart in the current buying context: each line with its line_id, job summary, price inc GST and whether it has artwork, the total before delivery, and the checkout link. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Output parameters:

- `checkout_url` (string)
- `currency` (string)
- `lines` (array)
- `next` (string)
- `prices_include_gst` (boolean)
- `service_area` (string)
- `total_inc_gst` (number)

### `add_to_cart` (~171 tokens)

Add a job to the cart

Prices one job with Printdash's pricing engine (product id and a configuration of option ids, as price_job takes them) and puts it in the cart exactly as the product page's Add to cart does. If the job cannot be priced, nothing is added and the result says what is missing or the nearest combinations. Nothing is ordered or charged: checkout on printdash.io re-prices, takes artwork and payment. Printdash prints in Australia and delivers within Australia only; prices are in AUD and include GST. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `configuration` (object, required): The job, as option ids from get_product. Everything optional: the result says what is missing.
- `product_id` (string, required)

Output parameters:

- `added` (boolean)
- `cart` (object)
- `currency` (string)
- `errors` (array)
- `line_id` (string)
- `missing` (array)
- `nearest` (array)
- `next` (string)
- `price` (object)
- `priced` (boolean)
- `prices_include_gst` (boolean)
- `product` (string)
- `product_id` (string)
- `reason` (string)
- `service_area` (string)
- `turnaround` (string|null)

### `update_cart_line` (~128 tokens)

Change a job in the cart

Changes one cart line's options (only what is given: a new quantity, stock, finish or size) and re-prices it with the pricing engine. A line from a quote Printdash priced cannot be changed. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `configuration` (object, required): Only the options that change, as option ids: a new quantity, stock, finishing ids or size. Finishing ids replace the line's finishing.
- `line_id` (string, required): A line_id from get_cart.

Output parameters:

- `added` (boolean)
- `cart` (object)
- `configuration_input` (object)
- `currency` (string)
- `errors` (array)
- `line_id` (string)
- `missing` (array)
- `nearest` (array)
- `next` (string)
- `price` (object)
- `priced` (boolean)
- `prices_include_gst` (boolean)
- `product` (string)
- `product_id` (string)
- `reason` (string)
- `service_area` (string)
- `turnaround` (string|null)
- `updated` (boolean)

### `remove_cart_line` (~59 tokens)

Remove a job from the cart

Removes one line from the cart by its line_id. Saved quotes are not affected. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `line_id` (string, required)

Output parameters:

- `cart` (object)
- `currency` (string)
- `line_id` (string)
- `next` (string)
- `prices_include_gst` (boolean)
- `removed` (boolean)
- `service_area` (string)

### `clear_cart` (~65 tokens)

Empty the cart

Removes every line from the cart in the current buying context. Saved quotes are not affected. Ask the customer before emptying a cart they did not just fill. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Output parameters:

- `cleared` (boolean)
- `next` (string)
- `removed_lines` (number)

### `create_quote` (~231 tokens)

Save a quote

Saves a new quote with a quote number from up to 20 jobs (each a product id and configuration, priced by the engine first), with an optional saved address for delivery, pickup where the account has it, an order reference and notes. Prices are locked for 30 days. It is the customer's saved quote, ready to share with a client (share_quote, email_quote) or convert to an order. If a job cannot be priced, nothing is saved. Printdash prints in Australia and delivers within Australia only; prices are in AUD and include GST. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `address_id` (string): A saved address id for delivery (list_addresses). Omit to choose at checkout.
- `fulfilment` (string): pickup only where the account has pickup (estimate_delivery says pickup_available).
- `lines` (array, required): The jobs, each priced by the engine before anything is saved.
- `notes` (string)
- `reference` (string): The customer's order reference or job name.

Output parameters:

- `currency` (string)
- `errors` (array)
- `expires` (string|null)
- `line_index` (number)
- `lines` (array)
- `missing` (array)
- `nearest` (array)
- `next` (string)
- `pickup` (boolean)
- `priced` (boolean)
- `prices_include_gst` (boolean)
- `product` (string)
- `product_id` (string)
- `quote_number` (string)
- `reason` (string)
- `reference` (string|null)
- `saved` (boolean)
- `service_area` (string)
- `share_url` (string|null)
- `shipping_ex_gst` (number|null)
- `status` (string)
- `status_label` (string)
- `subtotal_inc_gst` (number)
- `total_inc_gst` (number): The quote page's Total, inc GST: subtotal_inc_gst (the lines) plus delivery (shipping_ex_gst) and its GST.
- `url` (string)

### `update_quote` (~163 tokens)

Change a saved quote

Changes a saved quote in place: lines to change (line_id plus only the options that change) or add (product_id and configuration), lines to remove, the reference, notes or delivery address. Changed and added lines are re-priced by the engine; untouched lines keep their prices. Accepted, ordered, expired and team-priced quotes cannot be changed. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `address_id`: A saved address id, or null to clear it.
- `lines` (array)
- `notes`
- `quote` (string, required): The quote number (or the quote id from its link).
- `reference`
- `remove_line_ids` (array)

Output parameters:

- `added_line_ids` (array)
- `changed_line_ids` (array)
- `currency` (string)
- `errors` (array)
- `expires` (string|null)
- `line_index` (number)
- `lines` (array)
- `missing` (array)
- `nearest` (array)
- `next` (string)
- `pickup` (boolean)
- `priced` (boolean)
- `prices_include_gst` (boolean)
- `product` (string)
- `product_id` (string)
- `quote_number` (string)
- `reason` (string)
- `reference` (string|null)
- `removed_line_ids` (array)
- `service_area` (string)
- `share_url` (string|null)
- `shipping_ex_gst` (number|null)
- `status` (string)
- `status_label` (string)
- `subtotal_inc_gst` (number)
- `total_inc_gst` (number): The quote page's Total, inc GST: subtotal_inc_gst (the lines) plus delivery (shipping_ex_gst) and its GST.
- `updated` (boolean)
- `url` (string)

### `duplicate_quote` (~83 tokens)

Copy a saved quote

Saves a copy of a quote as a new quote with its own number, every line re-priced today (artwork is not copied). The original is unchanged. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `quote` (string, required): The quote number (or the quote id from its link).

Output parameters:

- `copied_from` (string)
- `currency` (string)
- `errors` (array)
- `expires` (string|null)
- `line_index` (number)
- `lines` (array)
- `missing` (array)
- `nearest` (array)
- `next` (string)
- `pickup` (boolean)
- `priced` (boolean)
- `prices_include_gst` (boolean)
- `product` (string)
- `product_id` (string)
- `quote_number` (string)
- `reason` (string)
- `reference` (string|null)
- `saved` (boolean)
- `service_area` (string)
- `share_url` (string|null)
- `shipping_ex_gst` (number|null)
- `status` (string)
- `status_label` (string)
- `subtotal_inc_gst` (number)
- `total_inc_gst` (number): The quote page's Total, inc GST: subtotal_inc_gst (the lines) plus delivery (shipping_ex_gst) and its GST.
- `url` (string)

### `delete_quote` (~94 tokens)

Delete a saved quote (asks first)

Prepares deleting a saved quote for good: returns the summary to show the customer and a confirmation_token. Nothing is deleted until confirm is called with it after the customer agrees. Accepted and ordered quotes cannot be deleted. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `quote` (string, required): The quote number (or the quote id from its link).

Output parameters:

- `action` (string)
- `confirmation_required` (boolean)
- `confirmation_token` (string)
- `details` (object)
- `expires_at` (string)
- `next` (string)
- `summary` (string): Show this to the customer exactly as written before confirming.

### `share_quote` (~133 tokens)

Get a quote's public link

Makes, or returns the existing, public link for a saved quote: the page where the customer's client can view and approve it, and pay online when allow_payment is on. The link never changes once made. It sends nothing (email_quote does). Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `allow_payment` (boolean): Let the recipient pay online from the link. Omit to keep the quote's current setting (off for a new link).
- `quote` (string, required): The quote number (or the quote id from its link).

Output parameters:

- `allow_payment` (boolean)
- `next` (string)
- `quote_number` (string)
- `reused` (boolean)
- `share_url` (string)
- `status` (string)
- `status_label` (string)
- `url` (string)

### `email_quote` (~150 tokens)

Email a quote to someone (asks first)

Prepares emailing a saved quote's public link to someone (usually the customer's client): returns the summary to show the customer and a confirmation_token. Nothing is sent until confirm is called with it after the customer agrees. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `include_branding` (boolean): Show the customer's own branding on the public page (default true).
- `quote` (string, required): The quote number (or the quote id from its link).
- `recipient_business` (string)
- `recipient_email` (string, required): Who to send it to (not the customer's own address).
- `recipient_name` (string)

Output parameters:

- `action` (string)
- `confirmation_required` (boolean)
- `confirmation_token` (string)
- `details` (object)
- `expires_at` (string)
- `next` (string)
- `summary` (string): Show this to the customer exactly as written before confirming.

### `convert_quote_to_order` (~122 tokens)

Put a quote in the cart to order it

Puts a saved quote's lines in the cart, as the quote page's Convert to order does, and returns the checkout link. No order is placed: the customer chooses delivery and pays (or orders on account) at checkout on printdash.io. Only the quote's owner can, and every line needs artwork unless Printdash priced it. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `quote` (string, required): The quote number (or the quote id from its link).

Output parameters:

- `added_lines` (number)
- `checkout_url` (string)
- `currency` (string)
- `next` (string)
- `prices_include_gst` (boolean)
- `quote_number` (string)
- `replaced_lines` (number)
- `service_area` (string)

### `request_custom_quote` (~220 tokens)

Ask Printdash for a custom quote (asks first)

Prepares a custom quote request for a job the catalogue does not cover (description, quantities, size, sides, stock, finishing, deadline, similar product, delivery address): returns the summary to show the customer and a confirmation_token. Nothing is filed or emailed until confirm is called after the customer agrees; then Printdash's team prices it by hand. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `address_id` (string): A saved address id for delivery.
- `deadline` (string): Date needed, YYYY-MM-DD.
- `description` (string, required): The job in the customer's words: what it is, size, material, finish.
- `finishing` (string)
- `quantities` (array, required)
- `sides` (integer)
- `similar_product_id` (string): The closest catalogue product, if any.
- `size` (string): Finished size, for example 90 x 55mm or A5.
- `stock` (string)

Output parameters:

- `action` (string)
- `confirmation_required` (boolean)
- `confirmation_token` (string)
- `details` (object)
- `expires_at` (string)
- `next` (string)
- `summary` (string): Show this to the customer exactly as written before confirming.

### `list_quote_requests` (~66 tokens)

List custom quote requests

The customer's custom quote requests in the current buying context, newest first, each with its status as /quotes shows it and the quote it became, if any. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Output parameters:

- `next` (string)
- `requests` (array)

### `get_quote_request` (~82 tokens)

Get one custom quote request

One custom quote request by its request number: what was asked for, its status, whether it can still be cancelled, and the quote it became. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `request` (string, required): The request number (or the request id from its link).

Output parameters:

- `cancellable` (boolean)
- `created` (string)
- `deadline` (string|null)
- `description` (string)
- `finishing` (string|null)
- `kind` (string)
- `next` (string)
- `quantities` (array)
- `quote_number` (string|null)
- `request_number` (string)
- `sides` (number|null)
- `size` (string|null)
- `status` (string)
- `status_label` (string)
- `stock` (string|null)
- `url` (string)

### `cancel_quote_request` (~64 tokens)

Cancel a custom quote request

Cancels a custom quote request that is still pending review. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `request` (string, required): The request number (or the request id from its link).

Output parameters:

- `cancellable` (boolean)
- `cancelled` (boolean)
- `created` (string)
- `description` (string)
- `kind` (string)
- `next` (string)
- `quantities` (array)
- `quote_number` (string|null)
- `request_number` (string)
- `status` (string)
- `status_label` (string)
- `url` (string)

### `get_referral_summary` (~57 tokens)

Get the referral summary

The customer's referral code and link, how many customers and orders they have referred, their credit balance and commission. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Output parameters:

- `code` (string)
- `commission_all_time` (number)
- `credit_balance` (number)
- `currency` (string)
- `customers_referred` (number)
- `link` (string)
- `next` (string)
- `orders_from_referrals` (number)
- `url` (string)

### `send_invite` (~86 tokens)

Invite someone to Printdash (asks first)

Prepares emailing someone an invitation with the customer's referral link: returns the summary to show the customer and a confirmation_token. Nothing is sent until confirm is called after the customer agrees. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `email` (string, required): Who to invite (not the customer's own address).

Output parameters:

- `action` (string)
- `confirmation_required` (boolean)
- `confirmation_token` (string)
- `details` (object)
- `expires_at` (string)
- `next` (string)
- `summary` (string): Show this to the customer exactly as written before confirming.

### `confirm` (~165 tokens)

Confirm a prepared action

Carries out an action prepared by delete_address, delete_quote, email_quote, request_custom_quote, send_invite, prepare_checkout (placing the order), cancel_order, request_reorder, approve_order or reject_order, after the customer has seen its summary and said yes. Pass its confirmation_token and a new UUID as idempotency_key; retrying with the same key returns the first outcome and never acts twice. Never call it without the customer's agreement. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `confirmation_token` (string, required): The confirmation_token a prepare tool returned.
- `idempotency_key` (string, required): A UUID you generate for this confirmation; reuse it only to retry the same one.

Output parameters:

- `action` (string)
- `confirmed` (boolean)
- `replayed` (boolean)

### `request_artwork_upload` (~286 tokens)

Get an upload link for artwork

For a client that holds the file (Claude Code, Cursor, a script): returns a signed upload_url to PUT the file's bytes to, and an upload_id for attach_artwork. target says where it goes: a cart line (line_id from get_cart), a saved quote's line (line_id from get_quote) or an order job (item_id from get_order), plus design (1 to N, on a job with several designs) and side (front or back). Give the file name with its extension (pdf is best; ai, eps, psd, jpg, png and tif are accepted) and its size in bytes, up to 700 MB. Refused when the line's artwork can no longer change. A chat client that cannot send a file should use attach_artwork_from_url or get_artwork_uploader_link instead. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `content_type` (string): Optional; the type is decided by the extension, as the site's uploaders do.
- `file_name` (string, required): The file's name with its extension: business-card.pdf. PDF is best.
- `size_bytes` (integer, required): The file's size in bytes (up to 700 MB).
- `target` (object, required): Where the artwork goes.

Output parameters:

- `content_type` (string)
- `design` (number)
- `expires_at` (string)
- `file_name` (string)
- `headers` (object)
- `max_bytes` (number)
- `method` (string)
- `next` (string)
- `side` (string)
- `target` (object)
- `upload_id` (string): Pass to attach_artwork once the PUT succeeded.
- `upload_url` (string): PUT the file's bytes here, with the Content-Type in headers.

### `attach_artwork` (~133 tokens)

Attach an uploaded file to a line

After the file has been PUT to request_artwork_upload's upload_url: puts it on the line (in the design and side chosen then, replacing a file already in that slot), makes the page 1 and page 2 previews, runs Printdash's file checks, and returns the preview as an image with the checks' notices. The notices are the ones checkout shows; none of them blocks an order. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `upload_id` (string, required): The upload_id request_artwork_upload returned.

Output parameters:

- `attached` (boolean)
- `checks` (object)
- `complete` (number): Designs with every face they need.
- `design` (number)
- `designs` (array): Which file and page is each design's front and back, as the site resolves them.
- `file` (object)
- `files` (array)
- `next` (string)
- `order_item_status` (object)
- `preview` (object)
- `replaced` (array)
- `side` (string)
- `target` (object)
- `total` (number)
- `uploader_url` (string)

### `attach_artwork_from_url` (~263 tokens)

Attach artwork from a link

Fetches the file at an https link (a Canva, Figma or design tool export, Dropbox or Drive download link, a signed storage URL) up to 700 MB and attaches it like attach_artwork: target (cart_line, quote_line or order_item with its id, design, side), url, and file_name when the link's own name has no extension. A link that opens a web page instead of the file is refused, and so is a file whose contents do not match its extension. For a Canva export, name it canva-<designId>.pdf with the Canva design id: Printdash recognises Canva files by that name (they arrive at finished size by design, so the bleed notice is dropped and the studio checks bleed). Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `file_name` (string): The name to store it under, with its extension, when the link's own name has none. For a Canva export: canva-<designId>.pdf.
- `target` (object, required): Where the artwork goes.
- `url` (string, required): An https link that downloads the file itself (not a page showing it).

Output parameters:

- `attached` (boolean)
- `checks` (object)
- `complete` (number): Designs with every face they need.
- `design` (number)
- `designs` (array): Which file and page is each design's front and back, as the site resolves them.
- `file` (object)
- `files` (array)
- `next` (string)
- `order_item_status` (object)
- `preview` (object)
- `replaced` (array)
- `side` (string)
- `target` (object)
- `total` (number)
- `uploader_url` (string)

### `attach_artwork_inline` (~149 tokens)

Attach a small file sent inline

For programmatic clients only: attaches a file sent as base64 in data_base64, up to 10 MB, like attach_artwork (target, file_name with its extension). Never paste a file a customer dropped into a chat here; use attach_artwork_from_url or get_artwork_uploader_link. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `data_base64` (string, required): The file's bytes, base64-encoded, up to 10 MB decoded.
- `file_name` (string, required): The file's name with its extension.
- `target` (object, required): Where the artwork goes.

Output parameters:

- `attached` (boolean)
- `checks` (object)
- `complete` (number): Designs with every face they need.
- `design` (number)
- `designs` (array): Which file and page is each design's front and back, as the site resolves them.
- `file` (object)
- `files` (array)
- `next` (string)
- `order_item_status` (object)
- `preview` (object)
- `replaced` (array)
- `side` (string)
- `target` (object)
- `total` (number)
- `uploader_url` (string)

### `get_artwork_uploader_link` (~125 tokens)

Get the site's uploader for a line

The printdash.io page whose own uploader takes artwork for this line: checkout for a cart line, the quote page for a saved quote's line, the order page for an order job. It opens signed in in the browser the customer connected with. Use it when the customer has the file but the chat cannot send it. Refused when the line's artwork can no longer change. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `target` (object, required): Where the artwork goes.

Output parameters:

- `next` (string)
- `target` (object)
- `url` (string)
- `where` (string)

### `check_artwork` (~139 tokens)

Check a line's artwork

Runs Printdash's file checks on a line's artwork, the same ones the product page and checkout show: page size against the ordered size, pages against sides or booklet pages, ink to the edge for bleed, spot finish and cut line layers found, missing or misnamed, finishes knocked out, template guides left in. Each notice comes with a guide link; anything the check could not measure says nothing. Returns the preview as an image. Never blocks an order. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `target` (object, required): Where the artwork goes.

Output parameters:

- `complete` (number): Designs with every face they need.
- `designs` (array): Which file and page is each design's front and back, as the site resolves them.
- `files` (array)
- `measured`
- `next` (string)
- `notices` (array)
- `preview_url` (string|null)
- `spot_scan` (string)
- `status` (string): partial: some checks were still running; call again.
- `target` (object)
- `total` (number)

### `get_mockup` (~201 tokens)

Show the 3D mockup

The 3D mockup of a line's artwork on the product, as an image, and view_url: the printdash.io page for that line (checkout, the quote page or the order page) with its interactive 3D viewer already open. To show the customer the mockup, give them view_url; never give a storage or image URL. An order job is rendered by Printdash's server and cached; if it is still rendering the result says so and you call again in about 20 seconds. A cart or quote line returns the mockup checkout or the quote page stored, or else Printdash's server renders it the same way (rendering, then call again); the flat preview comes back when there is no 3D view to show. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `target` (object, required): Where the artwork goes.

Output parameters:

- `configuration` (array): The line's size, stock, sides, finishing and pages, as labelled rows.
- `next` (string)
- `quantity` (number|null)
- `status` (string)
- `target` (object)
- `view_url` (string): The printdash.io page for this line with its 3D viewer open (checkout, the quote page or the order page, ?mockup=<line id>). The one link to give the customer.

### `list_artwork` (~98 tokens)

List a line's artwork

The files on a cart line, quote line or order job, in order, with which file and page is each design's front and back (as the site resolves them), how many designs are ready, whether the artwork can still change, and the uploader link. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `target` (object, required): Where the artwork goes.

Output parameters:

- `artwork_editable` (boolean)
- `complete` (number): Designs with every face they need.
- `designs` (array): Which file and page is each design's front and back, as the site resolves them.
- `files` (array)
- `next` (string)
- `order_item_status` (object)
- `sides` (number)
- `target` (object)
- `total` (number)
- `uploader_url` (string)

### `remove_artwork` (~139 tokens)

Remove artwork from a line

Takes artwork off a line: one design's file (design, and side for one face only), or on a one-design job the front, the back, or (no side) every file. The file itself is deleted only if no other line, quote or order uses it. Refused when the line's artwork can no longer change. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `target` (object, required): The line, and the design (and side, for one face only) to remove. On a one-design job, no side removes every file.

Output parameters:

- `complete` (number): Designs with every face they need.
- `designs` (array): Which file and page is each design's front and back, as the site resolves them.
- `files` (array)
- `next` (string)
- `order_item_status` (object)
- `removed` (boolean)
- `removed_files` (array)
- `target` (object)
- `total` (number)

### `prepare_checkout` (~379 tokens)

Review the cart before ordering

Checkout's review of the whole cart in the current buying context, as printdash.io's checkout shows it: every line with its artwork state and Printdash's file notices, delivery to a saved address (address_id, else the default) or pickup where the account has it, the order reference (required, up to 50 characters), notes, a PO number for a Team on account, is_whitelabel (Remove Printdash Branding), the totals from Printdash's own delivery pricing, expected_total, and what placing it will do: placed unpaid with a pay link on printdash.io, on the Team's account, or held for a Team owner's approval. When it is ready, the summary and a confirmation_token for place_order. Writes nothing; nothing is ordered until place_order is called after the customer agrees. Printdash prints in Australia and delivers within Australia only; prices are in AUD and include GST. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `address_id` (string): A saved address id for delivery (list_addresses). Omit for the context's default address.
- `fulfilment` (string): pickup only where the account has it (pickup_available).
- `is_whitelabel` (boolean): Remove Printdash Branding, as the checkout switch. Default false.
- `notes` (string): Notes for Printdash's team about this order.
- `payment_method` (string): A request: a Team with approved terms orders on account unless card is asked for; Printdash decides.
- `po_number` (string): A Team on account: the purchase order number (required when the Team says so).
- `reference` (string): The order reference, required as at checkout: a name for this order. Kept to 50 characters.

Output parameters:

- `action` (string)
- `address_id` (string|null)
- `blocking` (array)
- `checkout_url` (string)
- `confirmation_required` (boolean)
- `confirmation_token` (string)
- `currency` (string)
- `deliver_to` (string|null)
- `details` (object)
- `expected_total` (number|null): The total the customer is shown; place_order is refused if Printdash's own total differs.
- `expires_at` (string)
- `fulfilment` (string)
- `is_whitelabel` (boolean)
- `lines` (array)
- `next` (string)
- `notes` (string|null)
- `payment` (object)
- `pickup_available` (boolean)
- `po_number` (string|null)
- `prices_include_gst` (boolean)
- `ready` (boolean)
- `reference` (string|null)
- `service_area` (string)
- `summary` (string): Show this to the customer exactly as written before placing the order.
- `totals` (object)

### `place_order` (~196 tokens)

Place the prepared order

Places the order prepare_checkout summarised, after the customer has seen that summary and said yes. Pass its confirmation_token and a new UUID as idempotency_key; retrying with the same key returns the same order and never places a second. Printdash re-prices every line and refuses a price that moved since the review (then call prepare_checkout again). Payment never happens here: a card order comes back with payment_url, the order page on printdash.io where the customer pays; an on-account order needs no payment; a held order waits for a Team owner. Never call it without the customer's agreement. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `confirmation_token` (string, required): The confirmation_token prepare_checkout returned.
- `idempotency_key` (string, required): A UUID you generate for this order; reuse it only to retry the same one.

Output parameters:

- `action` (string)
- `confirmed` (boolean)
- `replayed` (boolean)

### `cancel_order` (~107 tokens)

Cancel an order (asks first)

Prepares cancelling one order: returns the summary to show the customer and a confirmation_token. Nothing is cancelled until confirm is called with it after the customer agrees. Only an unpaid order that is not in production can be cancelled, as on the order page; otherwise it says so. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `order` (string, required): The order number (or the order id from its link).

Output parameters:

- `action` (string)
- `confirmation_required` (boolean)
- `confirmation_token` (string)
- `details` (object)
- `expires_at` (string)
- `next` (string)
- `summary` (string): Show this to the customer exactly as written before confirming.

### `reorder` (~188 tokens)

Price an order's job again

Turns one job from a past order (item_id from get_order, where can_reorder is true) back into a configuration and prices it at today's price, optionally at another quantity, exactly as price_job does. Writes nothing: add_to_cart with its product_id and configuration_input puts it in the cart. Jobs priced by Printdash's team (reorder_by_request) go through request_reorder instead. Printdash prints in Australia and delivers within Australia only; prices are in AUD and include GST. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `item_id` (string): The job's item_id from get_order (optional on a one-job order).
- `order` (string, required): The order number (or the order id from its link).
- `quantity` (integer): Another quantity; omit for the same.

Output parameters:

- `config_id` (string)
- `configuration_input` (object)
- `currency` (string)
- `delivery`
- `designs` (number)
- `errors` (array)
- `missing` (array)
- `nearest` (array)
- `next` (string)
- `price` (object)
- `priced` (boolean)
- `prices_include_gst` (boolean)
- `product` (string)
- `product_id` (string)
- `quantity` (number)
- `quantity_per_design` (number|null)
- `reason` (string)
- `reorder_of` (object)
- `service_area` (string)
- `share_url` (string)
- `summary` (object)
- `turnaround` (string|null)

### `request_reorder` (~178 tokens)

Ask Printdash to re-price a past job (asks first)

For a job on a past order that Printdash's team priced (reorder_by_request in get_order): prepares the order page's reorder request, at the same or another quantity with optional notes, and returns the summary to show the customer and a confirmation_token. Nothing is filed until confirm is called after the customer agrees; then the team confirms today's price and sends a quote or pay link. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `item_id` (string): The job's item_id from get_order (optional on a one-job order).
- `notes` (string): Any change to the specs, in the customer's words.
- `order` (string, required): The order number (or the order id from its link).
- `quantity` (integer)

Output parameters:

- `action` (string)
- `confirmation_required` (boolean)
- `confirmation_token` (string)
- `details` (object)
- `expires_at` (string)
- `next` (string)
- `summary` (string): Show this to the customer exactly as written before confirming.

### `get_invoice` (~103 tokens)

Get an order's invoice

The tax invoice for one order as a PDF attached to the result, once the order is invoiced (paid, or on a Team's account once approved). Otherwise it says plainly that there is no invoice yet. The order page link has Download invoice too. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `order` (string, required): The order number (or the order id from its link).

Output parameters:

- `attached` (boolean)
- `bytes` (number)
- `file_name` (string)
- `invoice_available` (boolean)
- `next` (string)
- `order_number` (string)
- `reason` (string)
- `url` (string)

### `list_pending_approvals` (~86 tokens)

List orders waiting for my approval

For a Team owner: every held order of each Team they own, oldest first, with who placed it, the total, whether it is on account, its items and its page. An account that owns no Team is told only an owner approves. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Output parameters:

- `next` (string)
- `orders` (array)
- `owner` (boolean)

### `approve_order` (~125 tokens)

Approve a Team order (asks first)

For a Team owner: prepares approving one held order (from list_pending_approvals) and returns the summary to show the customer and a confirmation_token. Nothing is decided until confirm is called after they agree. Approving an on-account order sends it to production; approving a card order makes it payable by any member. A member who is not an owner cannot approve. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `order` (string, required): The order number (or the order id from its link).

Output parameters:

- `action` (string)
- `confirmation_required` (boolean)
- `confirmation_token` (string)
- `details` (object)
- `expires_at` (string)
- `next` (string)
- `summary` (string): Show this to the customer exactly as written before confirming.

### `reject_order` (~126 tokens)

Reject a Team order (asks first)

For a Team owner: prepares rejecting one held order, with an optional reason the member who placed it is told, and returns the summary to show the customer and a confirmation_token. Nothing is decided until confirm is called after they agree. Rejecting cancels the order. Needs a signed-in Printdash account: called without one, the connection asks the customer to sign in on printdash.io.

Input parameters:

- `order` (string, required): The order number (or the order id from its link).
- `reason` (string): Why, in the owner's words; the member who placed it is told.

Output parameters:

- `action` (string)
- `confirmation_required` (boolean)
- `confirmation_token` (string)
- `details` (object)
- `expires_at` (string)
- `next` (string)
- `summary` (string): Show this to the customer exactly as written before confirming.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-printdash-printdash/functions-v1-mcp#diagnostics

## Score history

- 2026-11-05: 70
- 2026-11-04: 70
- 2026-11-03: 70
- 2026-11-02: 69
- 2026-11-01: 69
- 2026-10-31: 68
- 2026-10-30: 68
- 2026-10-29: 67

## Common questions

### What is the Printdash MCP server?

Printdash is an MCP server listed in the public MCP registry as io.printdash/printdash. Online printing for Australia: products, exact prices, quotes, artwork checks and orders. This page covers its hosted endpoint (https://api.printdash.io/functions/v1/mcp).

### Is the Printdash MCP server safe to use?

Printdash scores 70 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 Printdash MCP server expose?

Printdash exposes 58 tools: ping, list_products, search_products, get_product, match_options, and 53 more. Their descriptions and schemas cost roughly 8,114 tokens of context every time the server is loaded.

### Does the Printdash MCP server require authentication?

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

### Is the Printdash MCP server still maintained?

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

## Links

- Remote endpoint: https://api.printdash.io/functions/v1/mcp
- Website: https://printdash.io/developers
- Changelog RSS feed: https://verifymcp.io/servers/io-printdash-printdash/functions-v1-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-printdash-printdash/functions-v1-mcp.json
- HTML version of this page: https://verifymcp.io/servers/io-printdash-printdash/functions-v1-mcp