Dreamship

Look up a catalog item by ID or name. Returns decoration type, production times and list prices (starting_basic_cost, starting_plus_cost). Your own price for each variant, with your plan, promotions and any custom costs applied, is your_product_cost less your_promo_discount in the item's variant lookup. Only items available to your business. A single-item result also carries each print area's additional_cost plus print_area_pricing_rule, which is what a design using more than one print area actually costs. A name search matching several returns a `total_count` of all matches plus one page, by name; pass its `next_offset` as `offset` for the next page.

get_catalog_item

Look up item variants for a catalog item. Returns availability, list prices (basic_cost, plus_cost), your own price (your_product_cost less your_promo_discount), dimensions, weight, 48H rush costs, and shipping label availability, with your business's custom costs applied. your_print_area_costs and your_shipping_label_fee are there when your business has its own.

get_catalog_item_variants

Look up a fulfillment by ID. Returns status, tracking, and timeline.

get_fulfillment

Look up one of your orders by ID or reference ID. Returns a lean default (status, costs, shipping, dates, fulfillments/tracking) — covers the vast majority of questions. Pass fields=['*'] if you need niche details (platform_id, cost breakdowns, customer_notes, test_order, etc.), or a specific list like fields=['customer_notes'] for one field.

get_order

What the order card shows of one of the merchant's orders: its status, items with a mockup each, where it ships, its total and its tracking.

get_order_card

Look up the event history for one of your orders — creation, status changes, deletion, reprints, etc. Returns a timestamped audit trail with actor info, most recent first. Use when the user asks what happened to an order, when it changed status, or who triggered something. Works even for deleted orders.

get_order_history

The Order Import spreadsheet's format, for writing the merchant a file of many orders that they upload themselves at https://app.dreamship.com/app/orders/order-import/: its columns, which are required and what each takes, Dreamship's templates, and whether this business's imported orders are submitted and charged as soon as the import finishes or arrive as drafts. The connector cannot upload it.

get_order_import_format

Look up line items for one of your orders. Returns quantities, production status, and tracking.

get_order_line_items

Look up design templates/print areas for a catalog item. Returns print area keys, dimensions (pixels), DPI, bleed/safe zones, per-area additional_cost, and template file download URLs.

get_print_areas

Look up one of your products by ID. Basic facts only, such as its status, source and flags: get_product_design has its artwork ids, placement, variants, prices, costs and mockups.

get_product

Read one of the merchant's products as a design: each print area's artwork, its placement (artwork_left, artwork_top, artwork_width and artwork_height in print area pixels from its top left) and how far it is turned, the print area's own pixel size and DPI, the variants with their product_variant_id (for create_draft_order), retail prices (what buyers pay the merchant, in US dollars) and costs (what the merchant pays Dreamship for one, before shipping and order fees), tags, links to its mockup images, and its shop listings: each one's publish status, its links once published or its error, and whether an edit would update it. Read it before update_product to move artwork relative to where it is, and to tell the merchant which live listings an edit will change, and after publish_product to see how publishing went. In chats that show MCP Apps, the product appears as a card with its mockups, and the mockup images load only inside that card.

get_product_design

Everything a product template holds: its catalog item, variants and their prices, how products made from it are named, description, tags and mockups, and its placement: for each print area it saved one for, the starting position the artwork is measured from, the share of the print area it is scaled to fit inside, and how far it is moved, all in percent of the print area, plus how far square, landscape and portrait artwork is turned.

get_product_template

List the merchant's artwork, newest first: id, name, pixel size, status and a public url of the file. Only artwork whose status is 'valid' can go on a product; 'checking' turns valid or failed within a minute. Artwork the merchant added in show_artwork_uploader's box or at https://app.dreamship.com/app/artworks/upload shows up here.

list_artworks

List all your connected shops/stores.

list_shops

List the merchant's product templates by name, a page at a time: saved product settings (catalog item, variants and prices, naming, description, tags, mockups and where artwork sits) that create_product makes products from. Returns each one's id, item and link; pass next_offset as offset for the next page.

list_product_templates

Publish one of the merchant's products to their shops, as Publish on the product page does. Only when the merchant asks: on Shopify, Etsy, WooCommerce, BigCommerce, TikTok and Walmart it makes a listing buyers can see and order from, or a draft when the product's marketplace_draft is on (Walmart has no drafts). A custom shop is marked published. Amazon and eBay shops can't be published to, and a marketplace shop takes at most 100 variants. shop_ids come from list_shops. A product still rendering its mockups publishes once it finishes, a shop whose listing failed is tried again, and a shop it is already on is left as it is. Marketplace listings publish in the background: get_product_design shows each listing's status, its links once published, and any error. Taking a product off a shop is not offered.

publish_product

Save a product as a product template, as the designer's Save as template does: its catalog item, variants and prices, description, tags and mockups, and where its artwork sits on each print area, kept as a share of the print area so the merchant's next artwork lands in the same spot at the same size, turned the same way. Get the placement and turn right with update_product first. With product_template_id, saves only the placements and turns onto that existing template, leaving its other settings. create_product with product_template_id makes products from it.

save_product_as_template

Search your fulfillments by status or date range. Returns a `total_count` of all matches plus one page of results, newest first; pass its `next_offset` as `offset` for the next page.

search_fulfillments

Search Dreamship help documentation by keyword.

search_help_docs

Search your orders by status, shipping method, reference ID, customer name, date range, or product/catalog identifiers. Use item_id/product_id/product_variant_id/item_variant_id with a date range when the user asks for status or tracking updates for all orders containing a specific product. Returns a `total_count` of all matching orders (the true count, ignoring `limit`) plus one page of results, newest first; pass its `next_offset` as `offset` for the next page. `total_count` is how many orders match, where the returned list is only one page of them.

search_orders

Find the merchant's products, newest first, by name, catalog item, shop or listing status, including products on no shop yet. Returns each one's id, catalog item, status, variant count, retail price range (what buyers pay the merchant, in US dollars), cost range (what the merchant pays Dreamship for one, before shipping and order fees), a mockup thumbnail, link and shop listings, plus total_count; pass next_offset as offset for the next page. get_product_design has a product's whole design. In chats that show MCP Apps, the results appear as product cards with each product's mockup, and the mockup images load only inside those cards.

search_products

Show an upload box in this chat where the merchant picks PNG or JPEG files from their device. Each one is added as artwork, and the box tells you its id and pixel size, or that Dreamship is still checking it. Use it when the image is on the merchant's device and this chat can't pass it to add_artwork, as in claude.ai, Claude Desktop and Cowork. If no box appears, ask them to upload at https://app.dreamship.com/app/artworks/upload, then find it with list_artworks.

show_artwork_uploader

Start uploading a PNG or JPEG from a client running on the merchant's own computer that can send HTTP requests itself, such as Claude Code or Codex. Returns a URL to PUT the file's bytes to, with the exact headers to send, valid for 5 minutes. Then call add_artwork with the upload_id. A chat's sandbox, as in claude.ai and Cowork, can't reach that URL: call show_artwork_uploader there instead, or have the merchant upload at https://app.dreamship.com/app/artworks/upload.

start_artwork_upload

See what an order of an AI personalized product would get: Dreamship's AI draws one print area from sample answers to the listing's questions, exactly as it draws an order, with the product as saved. answers maps each question's text to a sample answer: words for a text question, and for an image question a public link to a photo or an artwork id from list_artworks. Starts the test and returns its test_id; it takes a minute or more, then get_ai_personalization_test shows a watermarked preview. A business can run 100 tests a day, shared with the designer's Test.

test_ai_personalization

Change one of the merchant's products: the artwork or its placement on a print area, its name, description, tags, price, whether its marketplace listings are drafts, or its AI personalization. Print areas left out stay as they are. For a print area listed, artwork_id swaps the artwork; resize, position or custom pixels move it as in create_product, which also asks about ai_upscale first when the artwork would print soft; rotate_degrees alone turns it where it sits; and listing only ai_upscale keeps the placement. On an item with a print area per size, a change to the first print area listed also reaches every other size the product prints, unless that size is listed too; filled_print_areas names them. base_price re-prices every variant as create_product's does. Each edit saves a new version, so orders already placed keep printing the old one, and the mockups render again. On a product listed on a shop, the edit also updates the live listing, prices included, unless the merchant turned off Sync edits with marketplaces in the designer; the result lists each listing and whether it updates.

update_product

Change a product template: its name, description, product type, tags, how products made from it are named, its variants' prices, the placement it saved for print areas (see get_product_template for the numbers), for example moving artwork further left by lowering x_offset_percentage, or how artwork of each shape is turned. Anything left out stays as it is. Products already made from it don't change. Templates can't be deleted here.

update_product_template