Gelato
Gelato is a print-on-demand platform for creating and managing orders, browsing printable products and prices, checking stock, and finding shipment methods.
Verdict
Common use cases
- Validate regional stock before campaign launch
- Draft custom book orders for client review
- Automate merch fulfillment from CRM data
- Track shipment status in customer support chat
- Cancel orders flagged by fraud detection
Integration
- Vendor
- Gelato
- Category
- other
- Auth
- API_KEY
- Tools
- 13
- Composio slug
gelato
Tools
- Cancel Order
Cancel a regular Gelato order before production advances too far. DESTRUCTIVE: cancellation is an irreversible lifecycle change and may fail with conflict once the order is printed or shipped. Confirm the target order and do not retry blind
- Check Stock Availability
Check current regional stock status for 1 to 250 Gelato product UIDs. Availability is volatile; call near quote or order time and do not treat an earlier result as a reservation.
- Create Draft Order
Create a Gelato draft for review or later submission without entering production. Use a unique order_reference_id; delete the draft when it is no longer needed.
- Create Order
Create a production order that can immediately enter fulfillment and charge the connected account. IRREVERSIBLE: call only after explicit purchase authorization, use a unique order_reference_id, and never retry an ambiguous result.
- Delete Draft Orderdestructive
Permanently delete a Gelato draft. DESTRUCTIVE: only use for a confirmed draft, preferably one created by the same workflow; this cannot delete a regular production order and success was not live-exercised.
- Get Catalogs
List available Gelato product catalogs, or provide catalog_uid to retrieve one catalog's full product-attribute definitions and allowed values. Use detail mode before constructing attribute filters.
- Get Order
Retrieve the full current state, financial status, fulfillment status, shipment tracking, items, and totals of one Gelato order by its Gelato order ID.
- Get Product
Retrieve one Gelato product's attributes, dimensions, weight, supported countries, printability, stockability, content areas, and valid page counts by product UID.
- Get Product Prices
Return Gelato's quantity price tiers for one product, optionally localized by destination country, currency, and multipage page count. These catalog prices do not replace Quote Order for actual shipment options and final order cost.
- Quote Order
Quote product and shipping costs and delivery estimates for a destination before creating an order. This does not place or charge an order, but submitted print-file URLs are sent to Gelato for quote validation.
- Search Orders
Search Gelato orders with status, reference, date, country, currency, channel, type, store, or free-text filters and return one offset-controlled page.
- Search Products
Search printable products in a Gelato catalog by catalog attribute values and return one offset-controlled page. Facet hit maps are omitted by default because they are extremely large; request them only when needed for filter discovery.
- Submit Draft Order
Convert an existing draft into a regular production order. CRITICAL: this is an irreversible, potentially payable transition that can start production. If items are supplied, every omitted existing item is removed; include ID-only entries f
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Click 'Add MCP Integration' and search for Gelato. 3. You'll be prompted to paste your Gelato API key, which you generate in the Gelato dashboard under Account → API Keys → Create New Key. 4. Copy the key and paste it into the Switchy dialog, then click Connect. 5. Switchy will verify the key by calling the Get Catalogs tool; if it succeeds you'll see 'Connected' next to the Gelato icon. 6. Open any Project and type '@Gelato check stock availability for product UID abc123' to confirm the integration responds. 7. If the tool returns stock data or a clear error, the connection is live and ready for production workflows.
What teammates see: by default, memories from Gelato are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Check Stock Across Regions
@Gelato check stock availability for product UID 12345 in the US, Canada, UK, and Germany. Return a table showing which regions have stock right now.
Draft Order for Approval
@Gelato create a draft order for a 200-page softcover book, 6x9 inches, with the cover file at https://example.com/cover.pdf. Use order reference 'draft-2025-001' and ship to New York.
Submit Production Order
@Gelato create a production order for product UID 67890, quantity 50, shipping to the address in our last draft. Use order reference 'prod-2025-042' and confirm the total cost before submitting.
Track Order Status
@Gelato get the order details for Gelato order ID 'abc-xyz-123'. Show me the fulfillment status, shipment tracking link, and estimated delivery date.
Cancel Pending Order
@Gelato cancel the order with reference 'prod-2025-042'. Confirm whether cancellation succeeded or if the order already entered production.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@gelato retrieve order GEL-ORD-2024-03-15-8472 and summarize its current fulfillment status, tracking info, and any delays or issues
Order GEL-ORD-2024-03-15-8472 is currently in 'shipped' status. Production completed March 16, handed to carrier March 17. Tracking number: 1Z999AA10123456784 (UPS). Estimated delivery: March 20. No delays reported. Order contains 25 units of custom t-shirts (GEL-TSHIRT-L-BLACK) shipping to Chicago. Payment captured $412.75 USD. All line items fulfilled from the Dallas production facility.
This example shows how teams can monitor order lifecycle and proactively communicate delivery timelines to customers. The Get Order tool provides full financial and fulfillment state, including tracking numbers once shipment occurs. Use this for customer service inquiries or internal logistics tracking across multiple concurrent print campaigns.
Use-case deep-dives
When Gelato wins for small-batch branded swag without inventory risk
A 6-person SaaS startup ships conference swag twice a year and needs 50-200 branded tees per event. Gelato's Create Order and Check Stock Availability tools let the marketing lead draft orders in Switchy, verify regional stock for the target ship date, and submit production once the design is approved—all without holding inventory or negotiating MOQs. The Cancel Order tool covers last-minute speaker cancellations. This works when your volume stays under 500 units per drop and you can tolerate 5-7 day lead times; above that threshold, you'll want a dedicated fulfillment partner with bulk pricing. If your team runs two launches a year and hates leftover inventory, Gelato inside Switchy turns swag into a same-day decision instead of a procurement project.
Why agencies use this MCP to preview print specs before client sign-off
A 12-person creative agency produces branded packaging prototypes for CPG clients and needs to validate print dimensions and material options before final approval. Gelato's Get Product and Get Catalogs tools surface exact printable areas, supported substrates, and page-count constraints so the design team can spec deliverables in Switchy without round-tripping vendor PDFs. Create Draft Order lets account managers generate a no-commit proof with real pricing, and Delete Draft Order cleans up after the client picks a different finish. This scenario breaks down if your agency runs more than 30 proofs a month—at that scale the API rate limits and manual draft cleanup become friction. For teams closing 4-8 packaging projects a quarter, Gelato's MCP turns spec validation into a 10-minute Switchy thread instead of a two-day email chain.
When this MCP handles donor reward logistics for volunteer-run campaigns
A nonprofit's 3-person ops team runs an annual fundraiser with 200+ donor tiers that include physical thank-you gifts—posters, mugs, tote bags. Gelato's Create Order and Get Order tools let the volunteer coordinator batch-create fulfillment jobs in Switchy as donations close, then track shipment status without logging into a separate dashboard. Check Stock Availability prevents promising a reward the week before it goes out of stock. The trade-off: if your campaign has more than 500 unique shipping addresses or needs delivery inside 72 hours, Gelato's regional print network won't beat a local bulk shipper. For nonprofits running one or two campaigns a year with mixed reward SKUs and no warehouse, this MCP turns donor fulfillment into a spreadsheet-and-Switchy workflow instead of a logistics nightmare.
Frequently asked
What does the Gelato MCP do in Switchy?
It lets your team create, check, and manage print-on-demand orders through Gelato's API without leaving the AI workspace. You can check stock availability across regions, draft orders for review, submit production orders, retrieve tracking details, and cancel orders before they ship. The MCP wraps Gelato's product catalog and order lifecycle so your team can automate fulfillment workflows or answer customer questions about order status in real time.
Do I need a Gelato API key to connect this MCP?
Yes. The MCP uses API key authentication, so you'll need to generate a key from your Gelato account settings and paste it into Switchy's connection form. Anyone on your team with the key can connect the MCP, but only one connection per workspace is typical since the key ties to your Gelato billing account. Make sure the key has permissions for order creation and catalog reads.
Can the Gelato MCP modify or cancel orders after they're placed?
It can cancel regular orders, but only before production advances too far—once Gelato has printed or shipped the item, cancellation fails with a conflict error. The MCP marks this tool as destructive because cancellation is irreversible. You cannot edit an existing production order; instead, cancel it and create a new one with the correct details, or use a draft order for review before final submission.
How is this different from using Gelato's dashboard or API directly?
The MCP brings Gelato's order and catalog data into your AI workspace, so your team can check stock, draft orders, or pull tracking info without switching tabs or writing code. It's faster for ad-hoc queries and customer support workflows than logging into the dashboard, and simpler than maintaining your own API integration. You still pay Gelato's per-order fees; the MCP just changes where you interact with their system.
Who on my team should connect the Gelato MCP?
Whoever manages your Gelato account or has access to the API key. Since the MCP can create production orders that immediately charge your account, limit the connection to team members who understand order workflows and have spending authority. Once connected, any Switchy user in the workspace can invoke the tools, so treat the MCP like shared access to your Gelato billing account.