Gelato MCP by usefulapi
Browse the Gelato catalog, prices, orders and shipping; quote, create draft orders and products.
Should I use this
Quality & Safety
B
Findings (7)
- HIGHTool poisoning patterns detected
- MEDIUMTool 'gelato_get_template' description contains placeholder textin gelato_get_template
- MEDIUMTool 'gelato_create_product_from_template' description contains placeholder textin gelato_create_product_from_template
- LOWTool 'gelato_check_stock' description lacks action verbin gelato_check_stock
- LOWTool 'gelato_create_product_from_template' name length outside 3-30 rangein gelato_create_product_from_template
- INFOTool description contains placeholder or incomplete textin gelato_get_template
- INFOTool description contains placeholder or incomplete textin gelato_create_product_from_template
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~7,145Tokens (tool definitions)
~3.1 KBTypical response size
Significant attention impact (5.58% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"gelato": {
"url": "https://gelato.usefulapi.io/mcp"
}
}
}Remote endpoints
https://gelato.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (19)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢gelato_list_catalogs
List Gelato's product catalogs (posters, cards, t-shirts, mugs, photo books, ...) with their catalogUid and title. Start here to find products. GET product.gelatoapis.com/v3/catalogs.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_get_catalog(catalog_uid)
One catalog with the attributes that define its products (e.g. PaperFormat, PaperType, ColorType) and each attribute's possible values. Use them as attribute_filters in gelato_search_products. GET /v3/catalogs/{catalogUid}.
Input Schema
{
"type": "object",
"properties": {
"catalog_uid": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "^[A-Za-z0-9_.+-]+$",
"description": "Catalog UID, e.g. \"posters\" (from gelato_list_catalogs)."
}
},
"required": [
"catalog_uid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_search_products(catalog_uid, attribute_filters, limit, offset)
List the products of a catalog, optionally filtered by attribute values, with each product's productUid, attributes, weight and dimensions, plus hit counts per attribute value. POST /v3/catalogs/{catalogUid}/products:search.
Input Schema
{
"type": "object",
"properties": {
"catalog_uid": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "^[A-Za-z0-9_.+-]+$",
"description": "Catalog UID, e.g. \"posters\"."
},
"attribute_filters": {
"description": "Attribute name → accepted values, e.g. {\"Orientation\":[\"hor\"],\"PaperFormat\":[\"A4\",\"A3\"]} (names and values from gelato_get_catalog).",
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"additionalProperties": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
}
},
"limit": {
"description": "Results per page, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"required": [
"catalog_uid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_get_product(product_uid)
One catalog product by productUid: attributes, weight, supported and unsupported countries, whether it is printable or stockable, and valid page counts for multi-page products. GET /v3/products/{productUid}.
Input Schema
{
"type": "object",
"properties": {
"product_uid": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "^[A-Za-z0-9_.+-]+$",
"description": "Gelato product UID (from gelato_search_products)."
}
},
"required": [
"product_uid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_get_product_prices(product_uid, country, currency, page_count)
Gelato's production prices of a product for every quantity tier, optionally for one destination country and currency. page_count is required for multi-page products. Shipping is not included (use gelato_quote_order). GET /v3/products/{productUid}/prices.
Input Schema
{
"type": "object",
"properties": {
"product_uid": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "^[A-Za-z0-9_.+-]+$",
"description": "Gelato product UID."
},
"country": {
"description": "2-letter ISO 3166-1 country code (the United Kingdom is GB, not UK).",
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"currency": {
"description": "3-letter ISO 4217 currency code, e.g. USD or EUR.",
"type": "string",
"pattern": "^[A-Za-z]{3}$"
},
"page_count": {
"description": "Page count, required for multi-page products.",
"type": "integer",
"minimum": 1,
"maximum": 10000
}
},
"required": [
"product_uid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_get_cover_dimensions(product_uid, page_count)
Cover layout of a multi-page product (photo book, brochure) in millimetres: spine, front, back, bleed and wraparound areas, for designing the cover file. GET /v3/products/{productUid}/cover-dimensions.
Input Schema
{
"type": "object",
"properties": {
"product_uid": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "^[A-Za-z0-9_.+-]+$",
"description": "Gelato product UID of a multi-page product."
},
"page_count": {
"type": "integer",
"minimum": 1,
"maximum": 10000,
"description": "Total page count including covers (see validPageCounts in gelato_get_product)."
}
},
"required": [
"product_uid",
"page_count"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_check_stock(product_uids)
Stock status of stockable products per stock region (US-CA, EU, UK, OC, AS, SA, ROW): in-stock, out-of-stock-replenishable (with a replenishment date), out-of-stock, non-stockable or not-supported. POST /v3/stock/region-availability.
Input Schema
{
"type": "object",
"properties": {
"product_uids": {
"minItems": 1,
"maxItems": 250,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "^[A-Za-z0-9_.+-]+$",
"description": "Gelato product UID."
},
"description": "Product UIDs to check (1-250)."
}
},
"required": [
"product_uids"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_list_shipment_methods(country)
Gelato's shipment methods (shipmentMethodUid, name, type normal/express/pallet, tracking, business/private, supported destination countries), optionally only those for one destination country. GET shipment.gelatoapis.com/v1/shipment-methods.
Input Schema
{
"type": "object",
"properties": {
"country": {
"description": "Only methods that deliver to this 2-letter ISO country code.",
"type": "string",
"pattern": "^[A-Za-z]{2}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_search_orders(search, order_types, fulfillment_statuses, financial_statuses, countries, ...)
Search orders and drafts, newest first: id, your reference ids, order type, fulfillment and financial status, channel, store, country, currency, totals and dates. Filter by status, type, country, channel, store, reference, date range or free text (recipient name or order reference). POST /v4/orders:search.
Input Schema
{
"type": "object",
"properties": {
"search": {
"description": "Free text matched against the recipient's first or last name and orderReferenceId.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"order_types": {
"description": "Only these order types.",
"minItems": 1,
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"enum": [
"order",
"draft"
]
}
},
"fulfillment_statuses": {
"description": "Only these fulfillment statuses.",
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"enum": [
"created",
"passed",
"failed",
"canceled",
"printed",
"shipped",
"draft",
"pending_approval",
"not_connected",
"on_hold"
]
}
},
"financial_statuses": {
"description": "Only these financial statuses.",
"minItems": 1,
"maxItems": 9,
"type": "array",
"items": {
"type": "string",
"enum": [
"draft",
"pending",
"invoiced",
"to_be_invoiced",
"paid",
"canceled",
"partially_refunded",
"refunded",
"refused"
]
}
},
"countries": {
"description": "Only orders shipping to these countries (2-letter ISO codes).",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"description": "2-letter ISO 3166-1 country code (the United Kingdom is GB, not UK).",
"type": "string",
"pattern": "^[A-Za-z]{2}$"
}
},
"currencies": {
"description": "Only orders in these currencies.",
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"description": "3-letter ISO 4217 currency code, e.g. USD or EUR.",
"type": "string",
"pattern": "^[A-Za-z]{3}$"
}
},
"channels": {
"description": "Only orders from these channels (ui, api, shopify, etsy).",
"minItems": 1,
"maxItems": 4,
"type": "array",
"items": {
"type": "string",
"enum": [
"ui",
"api",
"shopify",
"etsy"
]
}
},
"store_ids": {
"description": "Only orders from these e-commerce store ids.",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Gelato e-commerce store id."
}
},
"ids": {
"description": "Only these Gelato order ids.",
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Gelato order id."
}
},
"order_reference_ids": {
"description": "Only orders with these orderReferenceIds.",
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Your order reference id."
}
},
"start_date": {
"description": "Only orders ordered or created on or after this ISO 8601 date-time (e.g. 2026-10-01T00:00:00Z).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})(?:T(\\d{2}):(\\d{2})(?::(\\d{2})(?:\\.\\d{1,9})?)?(Z|[+-](\\d{2}):(\\d{2})))?$"
},
"end_date": {
"description": "Only orders ordered or created on or before this ISO 8601 date-time.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})(?:T(\\d{2}):(\\d{2})(?::(\\d{2})(?:\\.\\d{1,9})?)?(Z|[+-](\\d{2}):(\\d{2})))?$"
},
"limit": {
"description": "Results per page, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_get_order(order_id)
One order by Gelato order id: type (order/draft), fulfillment and financial status, items with their files and statuses, shipment with packages and tracking codes/URLs, shipping address, receipts and totals. GET /v4/orders/{orderId}.
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Gelato order id (from gelato_search_orders)."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_quote_order(order_reference_id, customer_reference_id, currency, recipient, products, ...)
Price an order before placing it: product prices and the available shipment methods (shipmentMethodUid, price, min/max delivery days and dates) per fulfillment facility, for a recipient address. Nothing is created or charged. Pass a returned shipmentMethodUid to gelato_create_order. POST /v4/orders:quote.
Input Schema
{
"type": "object",
"properties": {
"order_reference_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Your order reference id for the quote."
},
"customer_reference_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Your customer reference id."
},
"currency": {
"description": "3-letter ISO 4217 currency code, e.g. USD or EUR.",
"type": "string",
"pattern": "^[A-Za-z]{3}$"
},
"recipient": {
"type": "object",
"properties": {
"first_name": {
"type": "string",
"minLength": 1,
"maxLength": 25,
"description": "Recipient first name (Gelato allows 25 characters)."
},
"last_name": {
"type": "string",
"minLength": 1,
"maxLength": 25,
"description": "Recipient last name (Gelato allows 25 characters)."
},
"company_name": {
"description": "Company name (max 60 characters).",
"type": "string",
"minLength": 1,
"maxLength": 60
},
"address_line1": {
"type": "string",
"minLength": 1,
"maxLength": 35,
"description": "Street and number (Gelato allows 35 characters)."
},
"address_line2": {
"description": "Second address line (Gelato allows 35 characters).",
"type": "string",
"minLength": 1,
"maxLength": 35
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "City (Gelato allows 30 characters)."
},
"post_code": {
"description": "Postal code (required where the country uses them).",
"type": "string",
"minLength": 1,
"maxLength": 15
},
"state": {
"description": "State/province code, required for US, CA and AU (e.g. NY).",
"type": "string",
"minLength": 1,
"maxLength": 35
},
"country": {
"description": "2-letter ISO 3166-1 country code (the United Kingdom is GB, not UK).",
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"phone": {
"description": "Recipient phone number.",
"type": "string",
"minLength": 1,
"maxLength": 25
},
"email": {
"type": "string",
"maxLength": 254,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Recipient email (required by Gelato; used for delivery notifications)."
},
"is_business": {
"description": "Brazil only: true if the recipient is a company (then state_tax_id and registration_state_code apply).",
"type": "boolean"
},
"federal_tax_id": {
"description": "Brazil only, required there: CPF (person) or CNPJ (company).",
"type": "string",
"minLength": 1,
"maxLength": 30
},
"state_tax_id": {
"description": "Brazil only: the company's state tax id (Inscrição Estadual).",
"type": "string",
"minLength": 1,
"maxLength": 30
},
"registration_state_code": {
"description": "Brazil only: the state code where the company is registered.",
"type": "string",
"minLength": 1,
"maxLength": 10
}
},
"required": [
"first_name",
"last_name",
"address_line1",
"city",
"country",
"email"
],
"additionalProperties": false,
"description": "Delivery address the quote is for."
},
"products": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"item_reference_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Your id for this line, unique within the order."
},
"product_uid": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "^[A-Za-z0-9_.+-]+$",
"description": "Gelato product UID (from gelato_search_products or a store product variant)."
},
"quantity": {
"type": "integer",
"minimum": 1,
"maximum": 100000,
"description": "Quantity, at least 1."
},
"files": {
"description": "Print files (required for printable products only).",
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"description": "Print area: \"default\" (the primary area, e.g. the front of apparel), \"front\", \"back\", or an embroidery position. Default \"default\".",
"type": "string",
"minLength": 1,
"maxLength": 50,
"pattern": "^[a-z0-9_-]+$"
},
"url": {
"type": "string",
"maxLength": 2048,
"format": "uri",
"description": "Public URL Gelato downloads the file from (PDF, PNG, TIFF, SVG or JPEG)."
}
},
"required": [
"url"
],
"additionalProperties": false
}
},
"page_count": {
"description": "Page count, multi-page products only (covers included).",
"type": "integer",
"minimum": 1,
"maximum": 10000
}
},
"required": [
"item_reference_id",
"product_uid",
"quantity"
],
"additionalProperties": false
},
"description": "Products to quote."
},
"allow_multiple_quotes": {
"description": "Default true: one quote per fulfillment facility when one facility cannot make everything. False: one combined quote.",
"type": "boolean"
}
},
"required": [
"order_reference_id",
"customer_reference_id",
"currency",
"recipient",
"products"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴gelato_create_order(order_type, order_reference_id, customer_reference_id, currency, items, ...)
Create an order. By default it is a DRAFT: nothing is produced or charged until it is submitted with gelato_submit_draft_order (or in the dashboard). With order_type "order" Gelato starts production and charges the account right away. Shipment: a shipmentMethodUid from gelato_quote_order, or "normal"/"standard"/"express"; omitted = the cheapest. POST /v4/orders.
Input Schema
{
"type": "object",
"properties": {
"order_type": {
"description": "\"draft\" (default; review first) or \"order\" (produced and charged immediately).",
"type": "string",
"enum": [
"draft",
"order"
]
},
"order_reference_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Your internal order id."
},
"customer_reference_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Your internal customer id."
},
"currency": {
"description": "3-letter ISO 4217 currency code, e.g. USD or EUR.",
"type": "string",
"pattern": "^[A-Za-z]{3}$"
},
"items": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"item_reference_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Your id for this line, unique within the order."
},
"product_uid": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "^[A-Za-z0-9_.+-]+$",
"description": "Gelato product UID (from gelato_search_products or a store product variant)."
},
"quantity": {
"type": "integer",
"minimum": 1,
"maximum": 100000,
"description": "Quantity, at least 1."
},
"files": {
"description": "Print files (required for printable products only).",
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"description": "Print area: \"default\" (the primary area, e.g. the front of apparel), \"front\", \"back\", or an embroidery position. Default \"default\".",
"type": "string",
"minLength": 1,
"maxLength": 50,
"pattern": "^[a-z0-9_-]+$"
},
"url": {
"type": "string",
"maxLength": 2048,
"format": "uri",
"description": "Public URL Gelato downloads the file from (PDF, PNG, TIFF, SVG or JPEG)."
}
},
"required": [
"url"
],
"additionalProperties": false
}
},
"page_count": {
"description": "Page count, multi-page products only (covers included).",
"type": "integer",
"minimum": 1,
"maximum": 10000
}
},
"required": [
"item_reference_id",
"product_uid",
"quantity"
],
"additionalProperties": false
},
"description": "Line items."
},
"shipping_address": {
"type": "object",
"properties": {
"first_name": {
"type": "string",
"minLength": 1,
"maxLength": 25,
"description": "Recipient first name (Gelato allows 25 characters)."
},
"last_name": {
"type": "string",
"minLength": 1,
"maxLength": 25,
"description": "Recipient last name (Gelato allows 25 characters)."
},
"company_name": {
"description": "Company name (max 60 characters).",
"type": "string",
"minLength": 1,
"maxLength": 60
},
"address_line1": {
"type": "string",
"minLength": 1,
"maxLength": 35,
"description": "Street and number (Gelato allows 35 characters)."
},
"address_line2": {
"description": "Second address line (Gelato allows 35 characters).",
"type": "string",
"minLength": 1,
"maxLength": 35
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "City (Gelato allows 30 characters)."
},
"post_code": {
"description": "Postal code (required where the country uses them).",
"type": "string",
"minLength": 1,
"maxLength": 15
},
"state": {
"description": "State/province code, required for US, CA and AU (e.g. NY).",
"type": "string",
"minLength": 1,
"maxLength": 35
},
"country": {
"description": "2-letter ISO 3166-1 country code (the United Kingdom is GB, not UK).",
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"phone": {
"description": "Recipient phone number.",
"type": "string",
"minLength": 1,
"maxLength": 25
},
"email": {
"type": "string",
"maxLength": 254,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Recipient email (required by Gelato; used for delivery notifications)."
},
"is_business": {
"description": "Brazil only: true if the recipient is a company (then state_tax_id and registration_state_code apply).",
"type": "boolean"
},
"federal_tax_id": {
"description": "Brazil only, required there: CPF (person) or CNPJ (company).",
"type": "string",
"minLength": 1,
"maxLength": 30
},
"state_tax_id": {
"description": "Brazil only: the company's state tax id (Inscrição Estadual).",
"type": "string",
"minLength": 1,
"maxLength": 30
},
"registration_state_code": {
"description": "Brazil only: the state code where the company is registered.",
"type": "string",
"minLength": 1,
"maxLength": 10
}
},
"required": [
"first_name",
"last_name",
"address_line1",
"city",
"country",
"email"
],
"additionalProperties": false,
"description": "Delivery address."
},
"shipment_method_uid": {
"description": "A shipmentMethodUid from gelato_quote_order, or \"normal\", \"standard\", \"express\". Several values may be given separated by commas (no spaces). Omitted = cheapest.",
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "^[A-Za-z0-9_.:-]+(,[A-Za-z0-9_.:-]+)*$"
},
"metadata": {
"description": "Up to 20 key/value pairs stored on the order.",
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"value": {
"type": "string",
"maxLength": 100
}
},
"required": [
"key",
"value"
],
"additionalProperties": false
}
}
},
"required": [
"order_reference_id",
"customer_reference_id",
"currency",
"items",
"shipping_address"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴gelato_submit_draft_order(order_id)
Convert a DRAFT order into a regular order: Gelato starts production and charges the account. Items stay as they are. Only drafts can be submitted. PATCH /v4/orders/{orderId} {"orderType":"order"}.
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Gelato order id of a draft order."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴gelato_cancel_order(order_id)
Cancel an order before production. Gelato refuses (HTTP 409) once any item is printed or the order has shipped. This cannot be undone. POST /v4/orders/{orderId}:cancel.
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Gelato order id."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴gelato_delete_draft_order(order_id)
Permanently delete a DRAFT order (regular orders cannot be deleted; cancel them instead). DELETE /v4/orders/{orderId}.
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Gelato order id of a draft order."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_list_store_products(store_id, order_by, order, limit, offset)
Products of a connected e-commerce store (Shopify, Etsy, WooCommerce, ...) as Gelato knows them: id, title, status (created/publishing/publishing_error/active), external id, variants with their productUid, preview images and dates. The store id is in the Gelato dashboard URL of the store and on its orders (storeId). GET ecommerce.gelatoapis.com/v1/stores/{storeId}/products.
Input Schema
{
"type": "object",
"properties": {
"store_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Gelato e-commerce store id."
},
"order_by": {
"description": "Sort field (default createdAt).",
"type": "string",
"enum": [
"createdAt",
"updatedAt"
]
},
"order": {
"description": "Sort direction (default desc).",
"type": "string",
"enum": [
"desc",
"asc"
]
},
"limit": {
"description": "Results per page, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"required": [
"store_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_get_store_product(store_id, product_id)
One product of a connected store: title, description, status, variants (with productUid and external ids), options, preview and publishing state. GET /v1/stores/{storeId}/products/{productId}.
Input Schema
{
"type": "object",
"properties": {
"store_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Gelato e-commerce store id."
},
"product_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Store product id (from gelato_list_store_products)."
}
},
"required": [
"store_id",
"product_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gelato_get_template(template_id)
A product template made in the Gelato dashboard: title, description, preview, and its variants (id, title, productUid; pass the variant id as template_variant_id) with their image placeholders (names to fill in gelato_create_product_from_template). GET /v1/templates/{templateId}.
Input Schema
{
"type": "object",
"properties": {
"template_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Template id (Gelato dashboard → the template's URL)."
}
},
"required": [
"template_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴gelato_create_product_from_template(store_id, template_id, title, description, visible_in_online_store, ...)
Create a product in a connected store from a template, with your own images in the template's placeholders. Gelato creates the product, then publishes variants and mockups in the background (track it with gelato_get_store_product). Hidden in the online store unless visible_in_online_store is true. POST /v1/stores/{storeId}/products:create-from-template.
Input Schema
{
"type": "object",
"properties": {
"store_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Gelato e-commerce store id."
},
"template_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Template id (see gelato_get_template)."
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 500,
"description": "Product title."
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 20000,
"description": "Product description (HTML allowed by most stores)."
},
"visible_in_online_store": {
"description": "Show the product in the online store (default false).",
"type": "boolean"
},
"sales_channels": {
"description": "Sales channels: \"web\" (default) or \"global\" (Shopify Point of Sale).",
"minItems": 1,
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"enum": [
"web",
"global"
]
}
},
"tags": {
"description": "Product tags, at most 13 (Etsy stores: 20 characters each).",
"minItems": 1,
"maxItems": 13,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 255
}
},
"product_type": {
"description": "Product type shown in the store.",
"type": "string",
"minLength": 1,
"maxLength": 255
},
"vendor": {
"description": "Vendor shown in the store.",
"type": "string",
"minLength": 1,
"maxLength": 255
},
"variants": {
"description": "Variants to create (omit for all template variants), each with the images for its placeholders.",
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"template_variant_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "The variant id (variants[].id) from gelato_get_template."
},
"image_placeholders": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Placeholder (layer) name from the template."
},
"file_url": {
"type": "string",
"maxLength": 2048,
"format": "uri",
"description": "Public image URL (jpg, jpeg, png or pdf)."
},
"fit_method": {
"description": "\"slice\" (default: fill and crop) or \"meet\" (fit the whole image).",
"type": "string",
"enum": [
"slice",
"meet"
]
}
},
"required": [
"name",
"file_url"
],
"additionalProperties": false
}
}
},
"required": [
"template_variant_id"
],
"additionalProperties": false
}
}
},
"required": [
"store_id",
"template_id",
"title",
"description"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence
Recent observations
verifiedversion not recorded19 tools