Inkdrop

Read-only in-card catalog search, filters, sorting and pagination. This tool never opens another card or requests a mockup.

browse_products

Use when the user cancels an artwork edit or revokes its media-sharing agreement. Retires only the exact active owner-bound workflowId and workflowRevision; a repeated cancellation is safe and never cancels a newer request. Future requests for this edit cannot create new work. Does not delete artwork, import, generate, or start a mockup. An apply request already in progress may still finish, even if rendering has not started; follow its returned operationId or the same workflow pair read-only if needed. Never recreate work after cancellation. Card and direct-chat edits use the same cancellation tool.

cancel_artwork_edit

Use this when the user explicitly asks whether Inkdrop is connected, which permissions were granted, or requests help troubleshooting an Inkdrop sign-in/connection problem. Returns connection status, granted permissions and generation availability, with no credentials. Do not use as a preliminary account check for requests to buy AI image-generation credits, tokens, wallet top-ups, digital content or subscriptions: this connector does not sell them, regardless of connection status or generation availability. Explain that limitation directly without an account lookup. Also do not use for requests solely about another merchant's order, or standalone image-only edits with no requested Inkdrop product and no active Inkdrop workflow. Selecting the plugin alone is not a connection-status request. This tool does not retrieve credit balances or purchase eligibility.

get_account

Check an existing Inkdrop generation run. For new connector creations, use get_operation with the operation ID.

get_design_status

Use this when the user asks to choose an Inkdrop product for ready artwork, or explicitly asks to browse or change products. Call once with relevant filters and limit 12, then stop and wait for selection. Do not repeat a successful call to confirm, refresh or show the same picker again. Newly generated artwork alone does not trigger this tool: wait for the user's product-selection follow-up, such as “Choose my Inkdrop product”. Do not open a creation picker while artwork is missing. A product request that already includes intended artwork can open the picker directly. For missing artwork, help create standalone artwork in chat first; before generation, explain that the user should reply “Choose my Inkdrop product” when the image is ready. That reply continues product selection, never requests another image. An image-only request without Inkdrop product intent does not trigger this tool. An explicit catalog-only request can browse without artwork. Each call can open a new card. After a successful result, direct the user to choose the exact product, color, size, print side and scale, then end the response without more tool calls. Empty results are also successful: ask for changed filters in the existing picker or chat, rather than retrying automatically. A successful response provides picker data; it does not prove the host displayed the card. If the user reports a display failure, offer the returned products in text and ask for the exact options, or reopen only on their explicit request. The card handles search, filters, loading more and full product options. Do not call list_products again after a selection or for each option change. Preserve any reviewed selection unless the user explicitly asks to change products; never choose a different product, 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. The disclosed Apply my artwork action supplies the exact selection and consent. Only after that action or an equivalent explicit agreed request, import the actual intended artwork, apply_design once for that workflow revision, and follow its operation without starting another render. A card watches only the revision it reserved. Do not open another preview card while that request is watched. For a later artwork edit, retain reviewed product choices and use the assisted edit workflow; do not reopen the picker. Catalog photos are not artwork.

list_products

Retrieve the connected user's recent private and public previews. No other user's private records are accessible.

list_my_previews

Use this when the user wants to save their selected conversation artwork to Inkdrop or use it in a requested product preview. Imports the supplied image into the connected Inkdrop account and returns an artworkId for apply_design. Requires a usable host-provided image reference, an authorized image URL or uploaded image bytes, plus agreement to image-link sharing. Images are accessible to anyone with their link; previews remain outside the public feed unless published. Optional selection, region and revision preserve the user's chosen product options. For artwork edits, wait for the user to explicitly continue with the finished edited image, then import that successful standalone edit; the previous source image does not contain the requested edit. Send the paired workflowId and workflowRevision and exact selection supplied by the card or prepare_artwork_edit; the import is bound to that reserved edit. A new direct-chat edit first uses prepare_artwork_edit. This tool does not generate artwork, render a mockup, publish a product or place an order. Unused imports expire after 14 days.

import_artwork

Read a product's description, model, image and full available options from the Inkdrop (US) catalog. Reading details does not select, apply, or order it. Use returned IDs only, and preserve the user's exact product, color, size and print choice.

get_product

Use this when the owned preview's standalone source artwork needs identification for a requested edit. This read does not request image generation or import/apply. Default to an assisted edit in the original image viewer or a finished image attachment, then wait for the user to explicitly continue with the finished edit. Only use the returned image as a native editor input when the user explicitly requests a direct native edit and the host supports it; never use a screenshot, product card or shirt mockup. A successful source read identifies the exact original artwork but does not guarantee a native-editable image reference. If the native editor cannot use the returned tool image, use an original standalone uploaded or generated image already in this conversation only when it clearly matches that loaded source. If that matching original is missing, ambiguous or unavailable to the native editor, ask the user to attach that exact source image. Keep the pending workflowId, workflowRevision, edit brief and product options unchanged while waiting for the attachment; do not reserve another request. Never invent a native image or file ID. Returns no product widget and never generates, imports, applies, or orders anything. After a successful native edit and the user explicitly continues with that finished image, import the NEW edited image and apply it with the retained exact product options and reserved workflow revision. If source loading or editing fails, report the failure and keep the pending request and existing preview unchanged; do not apply an old image or a product screenshot.

get_artwork_for_edit

Use only when the user explicitly asks to purchase a finished physical product or open checkout. Do not use for mockup creation, artwork editing, or the normal final product action; those open /preview/<previewId>. The Order this product button is an explicit checkout request. Build the Inkdrop link for the latest READY preview using its exact size, color and print side. Shipping, tax, payment and final order confirmation happen on inkdrop.fun. Opening this link does not place an order; never claim the product is purchased or collect payment details in chat.

create_checkout_link