Docs

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

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.
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.
get_order_history: An order's event history.
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.
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.
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, change or cancel an order, take a product off a shop, charge your account, or delete anything.
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.
I'd like to upload a new design.
Export my orders from last month.

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

Privacy and support

Our Privacy Policy explains what an assistant receives when you connect it and what we record, under "What happens when I connect an AI assistant or other app?"

Questions or trouble connecting? Email us at support@dreamship.com and we'll help you get set up.