All servers / E-commerce / Snowcone MCP server
Snowcone MCP server
Snowcone MCP server — the agent-native quickstart. Mint a sandbox shop, browse the catalog, and turn any image into a buyable printed-merch mockup URL, all as c
Tested by ConnectATDScore 90 out of 100. Tested 2026-11-18 on package version 0.18.3. Package: @snowcone-app/mcp · source
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 20 / 20 | |
| Package safety | 20 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 12 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (2.6 seconds including download)
- Tools offered: 18
- Last published: 2026-11-18
- Weekly downloads (npm): 6,987
- License: MIT · Direct dependencies: 2
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
snowcone_quickstartno parametersPut a person's own photo, logo or finished artwork on a printed product and sell it: this explains the steps and the tool order (add the image, render the mockup, get the buy link; minting a shop to build a store) on one screen, plus the silent-failure gotchas. For an IDEA with no artwork yet ('a corgi astronaut phone case'), do NOT call this first: call snowcone_search_designs, which needs no shop and no setup.
snowcone_mint_shop5 of 5 parameters describedStart a print-on-demand merch store for a creator, podcast or brand in one call — no account, no inventory; every order is printed and shipped. Mint your OWN sandbox Shop ID — no account or human needed. Returns { shop_id, shop_secret, api_key, api_key_scopes, store_url, lineup, claim }. When store_url is set, the shop is already a live store at that link — show it to the person you're helping. Pass image_url (the person's art, logo or photo) and the store opens stocked with best-sellers wearing that image — real listings at catalog prices, with mockups and checkout — listed in lineup. IMPORTANT: mint ONCE and reuse the shop_id for all render/buy calls — minting is rate-limited (60/hour, 200 unclaimed per IP → HTTP 429). shop_id is public (use it as 'shop'); shop_secret and api_key are secret (server-side only). To get paid, hand claim.verification_uri_complete to your human and poll snowcone_claim_status.
snowcone_claim_status1 of 1 parameter describedCheck whether your human has claimed the shop yet. Pass the claim_token from snowcone_mint_shop. Returns status: 'pending' | 'claimed' | 'expired'. Once 'claimed', sales route to your human's account.
snowcone_release_shop2 of 2 parameters describedDelete an UNCLAIMED sandbox shop you minted, freeing your per-IP mint budget. Authenticated by the shop_secret. Refused if the shop has already been claimed. Use this when you're done iterating. What survives: already-produced mockup IMAGE URLs keep rendering (they're public marketing imagery). What dies: buy/checkout URLs, the shop's credentials (shop_secret, api_key), and the claim link. Irreversible.
snowcone_set_mockup_background3 of 3 parameters describedSet (or clear) the shop's DEFAULT background color for mockup renders — painted behind every render where the mockup scene is transparent (studio-cutout shots). Applies to all renders for the shop that don't pass an explicit bg; a per-render bg on snowcone_render_mockup overrides it. Sandbox shops only (authenticated by shop_secret); once claimed, your human manages this in shop settings → Branding. Takes effect on new renders within a few seconds (already-cached mockup URLs keep their old background).
snowcone_search_catalog3 of 3 parameters describedFind products to put a photo or design on (for example a hoodie, a tote bag or a phone case), with their suggested retail prices. Full-text search the public Snowcone catalog. Only what this returns can be made: do not offer any other kind of product. Returns matching products with their code (id), name, price_cents (suggested retail, USD cents), and placement/mockup counts. Use snowcone_get_product for the full placement/mockup/option detail needed to render.
snowcone_search_designs9 of 9 parameters describedMake custom printed products from an idea ('red panda beekeeper hoodie', 'corgi astronaut phone case'): call this FIRST, before any other Snowcone tool. It sketches a couple of quick draft designs for exactly that idea, shows each on a matching product with its price, and also searches the catalog of ready-made designs. No shop, account or setup needed. Some apps draw the drafts as a picture grid with a 'Use this design' button; the result's 'how_to_reply' says what to show the person, so follow it. Mention a catalog design only if it really matches the idea. Their pick arrives as their next message, naming the product and the design image; pass that image as 'asset' to snowcone_render_mockup with NO 'shop' (drafts need none). Catalog details: the public catalog of remixable published designs — hybrid semantic + keyword over each design's AI visual caption, so descriptive queries like 'pink cowgirl boots on the moon' work (filter curated = true for first-party-curated picks) so an integration never starts from a blank canvas. Filterable facets: tags, occasion, style, productId, minPriceCents, curated. Each result includes the design's product, license, and a ready-to-render mockup_url (a design=<pairingId> reference URL) when you pass your 'shop'. Catalog design renders are FREE — they don't count against the shop's usage budget. Without 'shop' you get a mockup_url_template containing YOUR_SHOP_ID to substitute. 'drafts' in the result are the sketches (low-res, labelled drafts, not finished designs), each with a ready mockup_url per product and a page_url (its own page, to link for the person); 'drafts_status' says why when there are none.
snowcone_get_product2 of 2 parameters describedFetch one product by its code (id) or slug. Returns placements (where art goes), mockups (scene ids for the 'view' param), and variant options — everything you need to build a render URL. Returns an error if the code doesn't exist (it would render blank).
snowcone_upload_image4 of 4 parameters describedPut a photo the person attached in this chat onto a product: this stores the attached file and returns an image_url to use as 'asset' in snowcone_render_mockup. Works when your app passes attached files to tools (ChatGPT does). If you can't pass the file, use snowcone_upload_link instead: the person picks the photo on a page we host. No shop is needed: leave api_key out and the photo is kept with us (no account), where it renders and can be ordered for 30 days. PNG, JPEG, WebP or AVIF, at most 10 MB. Pass 'product' too and this answers the photo on that product (the mockup card) in the same call.
snowcone_upload_link3 of 3 parameters describedLet the person add their own photo when you can't pass an attached file to a tool: returns upload_url, a page we host where they pick a photo from their phone or computer. Give them the link, then call this again with that upload_token (and a 'product') to get the photo's image_url and see it on the product. Call it with nothing: the photo is kept with us (no account, no shop), where it renders and can be ordered for 30 days. The link works for 30 minutes and takes up to 3 uploads.
snowcone_upload_status2 of 2 parameters describedCheck an upload link from snowcone_upload_link. Returns status: 'pending' (not uploaded yet), 'uploaded' (image_url is the photo: use it as 'asset' in snowcone_render_mockup) or 'expired' (make a new link). Pass 'product' too and, once the photo is uploaded, this answers it on that product (the mockup card) in the same call.
snowcone_render_mockup13 of 13 parameters describedShow the user their photo, design or text on a real product from the catalog (for example a hoodie, a tote bag or a phone case) as a photoreal preview image. Build a public mockup IMAGE url for a product + your artwork + your shop. The result is an <img>-ready URL — no API call, no upload. A draft design from snowcone_search_designs needs NO shop: pass its image_url as 'asset' and leave 'shop' out. Provide 'asset' (one image) OR 'design' (per-placement map). The asset must be a publicly-fetchable raster image (PNG/JPEG/WebP/AVIF; not SVG), and the product code must exist in the catalog. Pass shop_secret to get an L3-signed URL. By DEFAULT the server fetches the built URL and confirms it actually renders, so a bad product code, wrong placement key, or unusable asset comes back as a clear error instead of a confident-but-broken URL. Pass verify=false to skip that check and just get the URL string instantly. In ChatGPT, Claude and other MCP Apps hosts the result shows as a card: the mockup, name, price, option choices and Buy. The result's 'orders' says whether Snowcone is taking orders yet; when it is 'not-open', show the mockup but don't offer the buy link as a way to order.
snowcone_show_on_products2 of 2 parameters describedShow ONE design or picture we already hold (its image_url from an earlier result) on several products at once, or on all of them: one row of pictures, each the real product with its price. Use this, not one snowcone_render_mockup call a product, when the person wants to compare products or asks for 'all of them'.
snowcone_finish_design2 of 2 parameters describedTurn a draft design the person has chosen into a finished, print-size design they can order. A draft from snowcone_search_designs is a quick low-res sketch and is not for sale; this keeps the picture as it is and makes it sharp at print size (4096 px). Call it when the person has picked a draft and wants to buy it or see it at full quality, NOT for every draft: it usually takes a few seconds (after that the same draft answers at once). Pass the draft's image_url as 'draft'. The result is the finished design's own image_url, shown on a product as a card with the price and Buy; use that image_url as 'asset' with no 'shop' in snowcone_render_mockup (another product, other options) or snowcone_buy_url. If the status is 'making', call again in a few seconds. No shop and no account are needed.
snowcone_buy_url13 of 13 parameters describedGive the user a link to buy the printed product they just previewed — it's printed and shipped to them. Build the buyable checkout url for the same product + artwork + shop you'd render. Same inputs as snowcone_render_mockup. A draft design from snowcone_search_designs is not for sale as it is: for one, this answers 'for_sale: false' and says why. Send a customer here to purchase the printed item. Sales route to Snowcone until your human claims the shop. By DEFAULT the server follows the URL and confirms it resolves to a live checkout (the Stripe session actually builds) AND that the matching mockup image renders — so a bad product code, shop, option combo, or unusable asset comes back as a clear error instead of a confident-but-broken link. 'verified' means the same thing here as in snowcone_render_mockup. This does NOT charge anything; it only builds the session. Pass verify=false to skip the check and get the URL string instantly. The result's 'orders' says whether Snowcone is taking orders yet: while it is 'not-open', don't offer this link to the person as a way to order.
snowcone_get_quote4 of 4 parameters describedTell the user what a printed product costs and when it would arrive, before they buy. Returns the price the buy link will charge (before tax), and each shipping option with its cost and delivery estimate for where it's going. Takes the same product and options as snowcone_buy_url; no artwork or shop needed. Nothing is created or charged. Only promise what comes back: an option with no estimated_delivery means we have no date for it yet.
snowcone_checkout4 of 4 parameters describedStart checkout for one design or picture on one product, when the user wants to buy it. Returns the line, its total and continue_url: the link where the person finishes on Snowcone's checkout page, with the product already in their bag. Nothing is charged by this call. 'asset' is the image_url of a design or picture an earlier Snowcone result gave.
snowcone_get_order_status2 of 2 parameters describedTell the user where their order is: whether it's being made or on its way, the carrier and tracking number, and the latest scan. Ask them for the order number and the email from their order confirmation. Read-only. If nothing matches, the error doesn't say which of the two was wrong, and repeated tries are limited, so check both with the person before retrying.
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.