Dreamship

npx add-mcp 'https://mcp.dreamship.com/mcp'

Dreamship MCP connector

Connect your AI assistant to your Dreamship account, then check orders, make products and start draft orders just by asking.

The Dreamship connector is an MCP server that works with the assistants below. It works on your own Dreamship account, with your login and your permissions. You need a Dreamship account to connect, a connected shop to publish products and a payment method on Dreamship to submit a draft order.

Server URL

https://mcp.dreamship.com/mcp

Connect an assistant

1. In ChatGPT, open the Dreamship plugin and click Connect. In any other assistant, copy the server URL above and add it as a custom connector, using its steps below.
2. Sign in with your Dreamship login when it asks, then choose Allow on Dreamship's consent page. The page lists what the assistant will be able to do.

ChatGPT

Open the Dreamship plugin and click Connect

No server URL needed: it's listed in ChatGPT's plugin directory.

Open in ChatGPT

Claude

Customize > Connectors > Add custom connector

On a Team or Enterprise plan, an owner adds it first.

Claude's guide

Gemini

Settings > Connected Apps > Custom apps > Add a custom app

Needs a personal Google account in the US.

Gemini's guide

Grok

grok.com/connectors > New Connector > Custom

On Grok Business, an admin adds it first.

Grok's guide

Perplexity

Customize > Connectors > Add custom > Add MCP connector > Remote, with OAuth

Click the new connector to sign in. Available on Pro, Max and Enterprise.

Perplexity's guide

Claude Code

Add the server, then run /mcp to sign in:

claude mcp add --transport http dreamship https://mcp.dreamship.com/mcp

Claude Code's guide

Codex

In the Codex app: Settings > MCP servers > Add server > Streamable HTTP, enter the server URL, save and restart, then choose Authenticate.

In the CLI: codex mcp add dreamship --url https://mcp.dreamship.com/mcp, then codex mcp login dreamship.

Codex's guide

Claude Desktop and the Claude mobile apps use the connector you add on claude.ai.

Sign-in and permissions

• You sign in with OAuth on Dreamship's own sign-in page, so the assistant never sees your password. Sign-in asks for read and write access, and the consent page shows what each allows.
• The assistant works as you, on your business, with your role's permissions. Billing and business settings are only there for admins.
• Each teammate connects their own assistant. Connecting the same assistant again replaces your earlier connection.
• To disconnect, go to Account Settings > Connected Assistants on Dreamship, or remove the connector in your assistant's settings. Admins can disconnect anyone's connection on their business.
• A connection that goes unused for 60 days ends on its own, and you sign in again to reconnect. Leaving the team or moving to another business also ends it.

Tools

Your assistant picks the right tool from what you ask, so you never need to name one. Each tool tells your assistant whether it only reads or makes changes, so your assistant can ask you before changing anything.

Orders and tracking

search_orders

Find orders by status, date, customer, reference or product.

get_order

One order's status, costs, shipping and tracking, shown as an order card.

get_order_line_items

An order's items, quantities and production status, and any lines removed from a draft.

get_order_history

An order's event history, including its line items and fulfillments.

search_fulfillments

Find your orders' fulfillments by status or date, with their tracking.

get_fulfillment

One fulfillment's status, tracking and timeline.

create_draft_order

A draft order of your products. Nothing is charged or made until you submit it on Dreamship.

move_order_to_draft

Moves a submitted or rejected order back to draft so it can be fixed, until Dreamship charges it. You submit it again on Dreamship.

update_order

A draft's shipping method, 48-hour fulfillment on or off, or its reference ID. A method the order can't ship with is refused, naming the ones it can.

update_order_address

A draft's new shipping address. Only the fields you give change, and Dreamship verifies it. The order's marketplace no longer updates an address changed here.

add_order_line_items

Adds your products, or catalog items printed with your artwork, to a draft, with quantities. Up to 50 lines at once, and if one can't be added, none are.

update_order_line_item

A draft line item's quantity or reference ID. A quantity changed here stays when the marketplace sends the order again, unless the buyer changes theirs.

remove_order_line_item

Removes a line item from a draft so it isn't made. A line from a marketplace order can be put back, and one added on Dreamship is deleted for good.

restore_order_line_item

Puts back a marketplace order's line that was removed from a draft.

match_order_line_item

What a draft's line item prints, for a line Dreamship couldn't match or one on the wrong product: one of your products, or a catalog item with your artwork. You can save the match for that listing's future orders too.

set_line_item_artwork

Artwork on one print area of a draft's line item whose product takes artwork per order, such as a personalized product.

get_order_import_format

The Order Import spreadsheet's columns, for many orders at once. You upload the file yourself.

Products

search_products

Find products by name, catalog item, shop or listing status, shown as product cards.

get_product

A product's basic facts.

get_product_design

The full design: artwork, placement, variants, prices, costs, mockups and shop listings, shown as a card.

create_product

A product from a catalog item and your artwork, saved unpublished, shown as a card.

update_product

Change artwork, placement, name, description, tags or price. Saves a new version, and listings on your shops update too unless Sync edits with marketplaces is off in the designer.

publish_product

Publish a product to your connected shops when you ask.

list_shops

Your connected shops.

Product templates

list_product_templates

Your product templates.

get_product_template

A template's catalog item, variants and prices, naming, description, tags, mockups and artwork placement.

save_product_as_template

Save a product as a template for new products.

update_product_template

Change a template's name, description, tags, naming, prices or artwork placement. Products already made from it don't change.

Artwork

list_artworks

Your artwork.

add_artwork

Add artwork from a link, or from an image in the chat where the assistant can pass one, as ChatGPT can.

show_artwork_uploader

An upload box right in the chat, in Claude.

start_artwork_upload

Upload a file directly from local apps like Claude Code and Codex.

Catalog and costs

get_catalog_item

A catalog item by name or ID, with its production times, list prices and print area costs.

get_catalog_item_variants

A catalog item's variants, with your prices.

get_print_areas

A catalog item's print areas and mockup templates, with guidance on what each print area cuts off, wraps or hides and where text and faces should stay.

estimate_cost

What an order would cost you, shipping included.

Account

get_business

Your business's name, country, plan and preferences.

get_billing

Your balance, plan, payment methods and anything outstanding. Admins only.

get_business_settings

Your order and product preferences, plan, webhooks and account settings. Admins only.

Exports

create_export

Start an export of your data. The file is emailed to you and listed on your Exports page.

Help

search_help_docs

Search Dreamship's help center.

get_api_docs

Look up Dreamship's API docs.

AI personalization (not in Claude)

test_ai_personalization

Preview what Dreamship's AI would draw for an order of an AI personalized product, from sample answers. Each business gets 100 previews a day, shared with the designer's Test.

get_ai_personalization_test

A preview's status, and its watermarked image once it's ready.

What it can't do

• It can't submit or cancel an order, take a product off a shop or charge your account, and it deletes only line items you remove from a draft.
• It can't change an order once Dreamship has charged it. Before that, it fixes an order as a draft, which you submit again on Dreamship.
• It doesn't upload order import files, place sample orders, publish to Amazon or eBay, or publish more than 100 variants to a marketplace shop.
• Customs numbers, such as VAT or IOSS numbers or a Mexican recipient's tax number, are added on Dreamship before you submit a draft.
• Each login can make up to 60 tool calls a minute.

Example prompts

• Which of my Dreamship products are on my Shopify store?
• Make a mug with the same artwork as my [product] and show me the mockups.
• Publish my [product] to my Shopify store.
• What would 3 of my [product] cost me shipped to Canada?
• Create a draft order for 2 black size M [product] for [name], [address].
• Make a mug from my newest artwork and draft an order to ship one to me.
• Move order #[number] back to draft and change its address to [address].
• Match the unmatched item in order #[number] to my [product].
• The unmatched line in order #[number] is a black size L tee with my [artwork] artwork.
• Take the [product] off order #[number] and add 2 of my [product] instead.
• I'd like to upload a new design.
• Export my orders from last month.
• In Claude Code or Codex: make a tee from each PNG in [folder] with my [template] template, with names and prices from [sheet].csv.
• In Claude Code or Codex: turn [orders].csv into an Order Import file, using our order numbers as reference IDs.

Tips and troubleshooting

• ChatGPT: start each Dreamship request with @Dreamship. ChatGPT only gives a plugin's tools to a message that mentions it.
• Images in claude.ai: images you attach in Claude can't reach the connector. Ask Claude for the upload box, or upload at app.dreamship.com/app/artworks/upload.
• Mockups: they render over a minute or two after a product is made, and the card fills in.
• AI artwork: when your assistant makes artwork, it gets guidance for each print area on what the product cuts off, wraps or hides, such as an ornament's circle or a canvas's wrapped sides. Check the mockups before you publish.
• Publishing: it finishes in the background. Ask again for the listing's status.
• Draft orders: you review, submit and pay for them on Dreamship. The reply links to each draft.
• Fixing an order: ask to move it back to draft, then fix its address, products, quantities, artwork or shipping, and submit it again on Dreamship. A saved product match also applies to that listing's future orders, which go straight to production if your shop submits imported orders automatically.
• Working in bulk: in Claude Code or Codex, make products from a product template, and give each product and order your sheet's SKU or order number as its reference ID. Dreamship won't make a second with the same ID, so a run that stops partway can start again. For many orders, ask for an Order Import file to upload. After several drafts, ask for one link to submit them all.
• Costs: they're what you pay Dreamship, not your retail prices. Estimates include any country fee Dreamship charges for that destination, such as VAT.
• Cards: product and order cards show in ChatGPT and Claude. Other assistants answer in text.
• A new tool doesn't show up: open the plugin in ChatGPT and choose Refresh, or reconnect in Claude. Both keep the tool list from when you connected.
• The connector option is missing: on team plans of ChatGPT, Claude, Grok or Perplexity, an owner or admin may need to add or allow it first.