Inkdrop

Older name for open_product_picker, kept for hosts that cached it. It opens the same Inkdrop product picker card under the same rules; prefer open_product_picker and never call both in one turn. Use this for an Inkdrop product request or catalog browse only when the user has not already chosen a product. It opens the Inkdrop product picker card, where the user sees product photos, prices, details and exact color, size and print-side options and makes the choice. Call once with relevant filters and limit 12, then wait for the card's message or the user's choice. In chat, point to the card in one short sentence; do not repeat the products as a text list and do not ask the user to type a choice. Once chosen, keep that product for the ongoing artwork-to-preview request; use get_product to verify its full options instead of opening the picker again. Do not generate another image while choosing a product. Do not call again to confirm, refresh or redisplay a successful result. Newly generated artwork alone does not trigger this tool: wait for the user's product-selection follow-up. An explicit catalog-only request can browse without artwork. A product request with ready artwork opens the picker directly. An image-only request without Inkdrop product intent does not trigger this tool. A successful result does not prove the host displayed the card; only if the user says the card is not visible, show the returned product names and prices in chat and wait for the choice. If no products match, ask the user to change filters instead of retrying automatically. Never invent a product or variant, silently substitute an unavailable option, or treat a default variant as the user's choice. Selection is not a mockup request or media-sharing consent. Before importing artwork or applying a design, obtain the exact reviewed product options, an explicit mockup request and agreement to image-link sharing. Catalog photos are not artwork.

list_products

Use only for an explicit artwork-edit request made directly in chat when there is no fresh product-card edit reservation. Creates a private 24-hour reservation for that request's owned source preview, exact user-selected product options and edit brief. It does not edit, import, render, or order anything. Default to an assisted edit in the original image viewer or a finished image attachment. Wait for the user to explicitly continue with the finished edited image before importing or applying it. Supply a new requestKey (a UUID is recommended) for each new user edit; keep it and all inputs unchanged on retries. Use the returned workflowId and workflowRevision unchanged through import_artwork and apply_design. Use get_artwork_for_edit when the standalone source needs identification; a source read is not an image-generation request. Only attempt a direct native edit when explicitly requested by the user and supported by the host; import only the successful NEW edited image after explicit continuation. Card-initiated edits already include a reserved pair: reuse it instead of calling this tool. If preparation fails, keep the existing preview and follow the returned recovery action.

prepare_artwork_edit

Read only this signed-in user's saved choices for the exact studioId. Unknown and expired cards return state=null. Revalidate product options and preview access before returning references. Following a saved request uses get_mockup_status; this read never imports, renders or restores consent.

get_studio_state

Use this when the user requests a real Inkdrop mockup and the intended artwork, reviewed exact product options and image-link sharing agreement are available. Requests such as “put my artwork on this product”, “show it on the shirt” or “make the mockup” are mockup requests for this tool; never answer them with a generated product picture. A product-card message naming an already imported artworkId with the exact selection and image-link agreement is also a complete mockup request: use that artworkId without importing again. Apply the already intended artwork to the retained product selection through this MCP tool; do not generate a new artwork image or illustrative product image. A mockup request made before product selection remains active while options are chosen. The disclosed Apply my artwork action or an equivalent chat request provides mockup intent; ordinary browsing or option changes do not. Creates an unlisted product preview without AI-generation charges, waits briefly for the same operation and returns READY, PENDING, FAILED or UNAVAILABLE. For an artwork edit, the user must explicitly continue with the finished edited image before it is imported or applied; use that successful new import's NEW artworkId. Old artwork/source-preview references identify the original, not the edited result. Retain product, variant, print side and scale; selection.productId maps to catalogProductId. A card-supplied edit has a reserved workflowId and workflowRevision: use that exact pair through import, apply and retries. A new direct-chat edit without a card reservation first calls prepare_artwork_edit, then uses its returned workflow pair through import, apply and retries. Do not invent a new revision on a guarded workflow. Keep creation inputs unchanged on retries. get_operation reads the same operation when PENDING; it does not start another render. The initiating card shows only its reserved revision. For a later artwork edit initiated directly in chat without a new card reservation, call get_preview once after READY with the new preview ID to display that result. An existing workflowId alone does not establish a waiting card. Missing or failed artwork edits are not ready to apply. Honor changed or canceled intent and revoked sharing agreement. This tool does not publish a product or place an order.

apply_design

Save this signed-in user's exact product-card references and optional artwork-edit brief for recovery for 24 hours. An edit atomically reserves its workflow and options; changing or clearing the active request supersedes it. Send a newer revision for a changed state, or the identical state at the same revision for a retry. This never imports artwork, creates a mockup, restores consent or places an order.

save_studio_state

Search published Inkdrop previews by name, prompt or creator. Returns stable preview IDs for get_preview.

search_previews

Use this to display the actual finished Inkdrop product card once after a chat-only creation reaches READY. Pass the READY previewId returned by apply_design or get_operation. Also use for an explicit reopen request or a later artwork edit initiated directly in chat without a new card reservation. Public previews work anonymously; private previews require an inkdrop:read grant from their owner. A card follows only the exact workflow revision it reserved. An existing workflowId alone does not mean a card watches a later revision. Do not call this after each status check or duplicate a result already watched by its initiating card.

get_preview

Read this connected user's exact widget workflow request and its real mockup. An active request waiting for artwork stays WAITING; canceled or missing guarded-edit reservations fail with a recovery action. This tool never starts a creation, imports artwork, or finds another preview.

get_mockup_status

Automatically follow the existing operation after apply_design until resultState is READY or FAILED. This read-only tool waits briefly and returns a compact result, never starts another creation or charges. If still PENDING, call it again; do not say Done or claim the artwork is applied before READY with an actual mockup image. On UNAVAILABLE, explain the recovery action and check the same operation. When READY for a chat-only creation with no waiting card, call get_preview once with the returned previewId so ChatGPT displays the real product card. Do not substitute an image caption or ask the user to request the card separately.

get_operation