MCP App Store
by KeenEthics
Dreamship icon

Dreamship MCP Server for ChatGPT

By Dreamship

Overview

Run your print-on-demand shops just by asking, or make something just for you. Dreamship prints products such as t-shirts, mugs and posters one at a time, as they're ordered, and ships each one to your customer or to you. For your shops: Products and mockups: Add artwork from a file or a link, make and edit products from it, and see their mockups in the chat. Product templates: Save a product as a template and make more products the same way. Publishing: Publish products to your connected shops, such as Shopify and Etsy, when you ask. Orders and tracking: Look up any order, its shipments, tracking and history. Catalog and costs: Browse the catalog, each item's print areas and mockup templates, and see what an order would cost you, shipping included. Draft orders: Set up orders for your customers as drafts, then review, submit and pay for them on dreamship.com. Exports: Export your orders, products and catalog, then download the files from Dreamship. Just for you: Design a one-off, such as a mug with your dog on it, and the plugin drafts the order to your address. You review, submit and pay for it on dreamship.com, and Dreamship ships it to your door. Requirements: A Dreamship account. Publishing needs a shop connected in Dreamship, and submitting an order needs a payment method there. The plugin acts only on your own account, with the permissions your role has on dreamship.com. It cannot submit, change or cancel an order, take a product off a shop, charge your account, or delete anything.

How to connect

  1. ChatGPT: Open the Dreamship listing in the ChatGPT app directory and choose Connect. ChatGPT listing Dreamship exposes 45 tools here.

Tools

add_artwork

ChatGPT
Add an image to the merchant's artwork from exactly one of: url, a public link to a PNG or JPEG; file, an image in this chat, attached by the user or generated by you, where the chat can pass files to tools (ChatGPT can); or upload_id, from start_artwork_upload once its bytes were PUT. Dreamship checks the image, which takes a few seconds, and returns its id, status and pixel size. A big file can still be 'checking' when this answers: find its status with list_artworks a minute later. Compare the pixel size with get_print_areas to know whether it prints sharp. Images must be PNG or JPEG, RGB, at least 200 x 200 pixels, at most 500 megapixels (about 22,300 x 22,300) and under 150 MB. When the image is on the merchant's device and this chat can't pass it here, as in claude.ai, Claude Desktop and Cowork, call show_artwork_uploader, or ask them to upload it at https://app.dreamship.com/app/artworks/upload and find it with list_artworks.

add_order_line_items

ChatGPT
Add line items to one of the merchant's draft orders, as the order page does: the merchant's own products, by product_variant_id from get_product_design, or catalog item variants from get_catalog_item_variants printed with a Design Library artwork_id, which goes on the item's default print areas. A submitted or rejected order needs move_order_to_draft first. A personalized product's line then takes its own artwork from set_line_item_artwork. All the lines are added, or none. Returns the new lines and the order's total.

create_draft_order

ChatGPT
Create a draft order of the merchant's products. Dreamship checks it as it checks a submission (address, stock, artwork, shipping, payment) and leaves it a draft: nothing is charged or made until the merchant submits it on Dreamship. Use get_product_design for product_variant_ids, making a product with create_product first when there is none. reference_id is the merchant's own id for the order: a second order with the same one is refused, naming the first, so a retry after a timeout never orders twice. Returns the order's link and total cost, and whether the merchant still needs a payment method. Customs numbers such as a VAT or IOSS number are added on Dreamship before submitting, not here. A Mexico order needs the recipient's RFC or CURP before it can be made at all, so the merchant creates those on Dreamship (Create Order, or Order Import with vat_number). After several drafts, send one link: https://app.dreamship.com/app/orders/?ids=<id>,<id> lists just those orders, where the merchant selects them all and chooses Submit orders. For many orders at once, get_order_import_format describes a spreadsheet the merchant uploads instead.

create_export

ChatGPT
Start an export of the merchant's own Dreamship data: orders, order line items (basic or full), order invoices (a zip for at most 500 charged orders), products, product variants, catalog items or item variants, the catalog, affiliate rewards, or transactions (admins only). Only start one when the merchant asks for an export. Dreamship builds the file in the background, emails it to them, and lists it for download on the Exports page that exports_page links to. The rows stay on Dreamship and never come back here. An export of orders, line items, invoices or transactions with no date range or other filter, or of over 50,000 rows, comes back as a question for the merchant: retry with confirmed_large only once they say they want all of it. So does the same export their business started in the last hour, which is already on the Exports page: retry with confirmed_repeat only if they want another copy.

create_product

ChatGPT
Create a product from a catalog item and the merchant's artwork. For the same artwork as one of their products, read its artwork_id from get_product_design. It is saved to the merchant's Products page unpublished, so it is on no shop until publish_product puts it there, and it can be ordered from Dreamship. Use get_catalog_item_variants for item_variant_ids and get_print_areas for print area keys and pixel sizes. Prices default to Dreamship's suggested retail price, which pays for the item, its US shipping and Etsy's fees and leaves the merchant about 20% of the price, so leave base_price out unless the merchant names a price. base_price sets the cheapest variant's price instead; pricier variants and each print area past the first add their suggested difference on top. Returns the product's link, and warns about more than 100 variants, which no marketplace shop takes. Artwork that would print below a print area's minimum DPI saves nothing and comes back as a question for the merchant about ai_upscale, unless ai_upscale is given. Give each product a reference_id: if a call times out, the product may still have been saved, and calling again with the same reference_id is refused, naming the product the first call made, so it is never made twice. With product_template_id it is made from one of the merchant's product templates (list_product_templates): its item, variants and prices, name, description, tags and mockups, its saved placement for each print area, and the turn it gives artwork of each shape, so print_areas only need key and artwork_id. Anything else given overrides the template. On an item with a print area per size (a mug's 11oz and 15oz, say), list one: its artwork goes on every size the product sells, as the designer does, placed the same way or at the same share of each print area, and filled_print_areas names the sizes filled. List a size too to give it something else.

estimate_cost

ChatGPT
Estimate the cost of ordering an item variant shipped to a destination, priced as your orders are, custom costs included. Returns the parts, not a total: your product cost and its promo discount, shipping for the first and each additional item, each print area's cost, and the carrier surcharge and any country fee percentages. An order adds them up like this: for each unit, product cost less its promo discount, plus print area costs; first-item shipping once per catalog item in the order, then additional-item shipping for every further unit; holiday_surcharge, when present, once per catalog item in the order, not per unit; the carrier surcharge as a percentage of that shipping; and the country fee as a percentage of the whole. A variant's your_print_area_costs, there when your business has its own print area costs, replaces print_areas' additional_cost for that variant. Use item_id + country at minimum. Without item_variant_id it returns a page of variants by color, then size, with a total_count and a next_offset to pass as offset. Print areas are charged on top of the base cost, so read print_area_pricing_rule before quoting a multi-location design.

get_ai_personalization_test

ChatGPT
How a test_ai_personalization run went: its status (pending, generating, success or failed), the watermarked preview's link once it succeeded, the prompt the AI was sent, or why it failed.

get_api_docs

ChatGPT
Look up Dreamship REST API documentation. Returns endpoint details, parameters, request/response schemas, and examples. Use when users ask how to use the API, what endpoints are available, or how to create/read/update resources via the API.

get_billing

ChatGPT
Look up your billing info including account balance, subscription plan, payment methods, and outstanding balances.

get_business

ChatGPT
Look up your business info: name, country, subscription plan, market segment, and operational preferences.

get_business_settings

ChatGPT
Look up your business settings including order preferences, product preferences, subscription, webhooks, and account configuration.

get_catalog_item

ChatGPT
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_variants

ChatGPT
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_fulfillment

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

get_order

ChatGPT
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_card

ChatGPT
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_history

ChatGPT
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_import_format

ChatGPT
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_line_items

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

get_print_areas

ChatGPT
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_product

ChatGPT
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_design

ChatGPT
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_template

ChatGPT
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.

list_artworks

ChatGPT
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_product_templates

ChatGPT
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_shops

ChatGPT
List all your connected shops/stores.

match_order_line_item

ChatGPT
Set which of the merchant's products a draft order's line item prints: a marketplace line Dreamship couldn't match to a product, or one on the wrong product. get_order_line_items lists the lines, an unmatched one without a product_variant_id, and get_product_design gives a product's variant ids, after create_product when there is no product yet. A personalized product's line then takes its own artwork from set_line_item_artwork. save_match also matches future orders of the same marketplace listing variant to this product, as Save Match does on Dreamship, and where the shop submits imported orders automatically those go to production with no one checking the match.

move_order_to_draft

ChatGPT
Move one of the merchant's submitted or rejected orders back to draft, as Edit Order does on Dreamship, so update_order_address, match_order_line_item and set_line_item_artwork can fix it. A submitted order can move until Dreamship accepts and charges it; after that it can't be edited. A draft isn't made or shipped until the merchant submits it on Dreamship, which the connector can't do. Moving a draft changes nothing.

publish_product

ChatGPT
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.

remove_order_line_item

ChatGPT
Remove a line item from one of the merchant's draft orders, as the order page does, so it isn't made or shipped. A paper note or gift box the order no longer qualifies for goes with it. A submitted or rejected order needs move_order_to_draft first. A line that came with a marketplace's order can be put back with restore_order_line_item while the order is a draft. A line added on Dreamship is deleted for good.

restore_order_line_item

ChatGPT
Put back a line item removed from one of the merchant's draft orders, as Add Line Item does on the order page. Only a line that came with a marketplace's order can come back, and get_order_line_items lists those as removed_line_items. A line added on Dreamship was deleted for good, and add_order_line_items adds it again. A submitted or rejected order needs move_order_to_draft first. Returns the line, which match_order_line_item matches if it has no product, and the order's new total.

save_product_as_template

ChatGPT
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.

search_fulfillments

ChatGPT
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_help_docs

ChatGPT
Search Dreamship help documentation by keyword.

search_orders

ChatGPT
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_products

ChatGPT
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.

set_line_item_artwork

ChatGPT
Put artwork on one print area of a draft order's line item whose product takes artwork per order, such as a personalized product, replacing what is there, as the order page's upload does. Other products print their own saved design, which update_product changes, or the line can be matched to another product. artwork_id comes from list_artworks or add_artwork; print_area_key is one of the product's print areas from get_product_design.

show_artwork_uploader

ChatGPT
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.

start_artwork_upload

ChatGPT
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.

test_ai_personalization

ChatGPT
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.

update_order

ChatGPT
Change one of the merchant's draft orders, as the order page does: its shipping method, 48H fulfillment on or off, its reference_id, or any of them. Its address and line items have tools of their own. 48H (made and shipped within 2 business days, for an added fee) needs at least one item on the order that offers it, and changes which methods the order can use. A method the order's address and items don't ship with is refused, naming the ones they do. reference_id is the merchant's own id for the order: one another of their orders has, unless it was cancelled, is refused, naming that order. A submitted or rejected order needs move_order_to_draft first. Returns the methods the order ships with now, none until every line item has a product, and its new total.

update_order_address

ChatGPT
Change a draft order's shipping address, as Edit Address does on Dreamship. Only the fields passed change. A submitted or rejected order needs move_order_to_draft first. Dreamship verifies the new address and may switch the shipping method to one that ships there, and the order's marketplace no longer updates an address changed here. Returns each changed field's old and new value, which is what putting an edit back takes, and whether the address verified.

update_order_line_item

ChatGPT
Change a line item on one of the merchant's draft orders, as the order page does: its quantity, its reference_id, or both. A submitted or rejected order needs move_order_to_draft first. On a marketplace's order, a quantity changed here stays when the marketplace sends the order again, unless the buyer's own quantity changed there. A line's reference_id is the merchant's own id for it: one another of their line items has is refused, naming that line. Returns the line and the order's new total.

update_product

ChatGPT
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_template

ChatGPT
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.

Capabilities

InteractiveWrites

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/dreamship"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/dreamship)