# Gelato MCP by usefulapi (remote · gelato.usefulapi.io)

Browse the Gelato catalog, prices, orders and shipping; quote, create draft orders and products.

- Trust score: 65/100 (medium)
- Change this week: +4
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-17

## Components

- remote · `gelato.usefulapi.io`: 65/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-gelato/gelato.md), [page](https://verifymcp.io/servers/io-usefulapi-gelato/gelato)

## Channel facts

- Endpoint: `https://gelato.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `required`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-10-17.

- **Endpoint Security**: 78/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token.
  - HTTPS enforcement could not be verified: the plaintext port redirected somewhere other than https, so enforcement is unproven.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
  - The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents.
- **Transport & Reachability**: 0/100
  - Transport check failed: declared streamable-http, but the endpoint redirected instead of responding directly.
- **Schema Quality & AI Usability**: 81/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 2662 tokens (~140/item across 19 items; 19 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 20 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 60/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.

## Install

### How do I install the Gelato MCP by usefulapi server?

Gelato MCP by usefulapi is a hosted endpoint at https://gelato.usefulapi.io/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http io-usefulapi-gelato 'https://gelato.usefulapi.io/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "io-usefulapi-gelato": {
      "url": "https://gelato.usefulapi.io/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "io-usefulapi-gelato": {
      "type": "http",
      "url": "https://gelato.usefulapi.io/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.io-usefulapi-gelato]
url = "https://gelato.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-gelato": {
      "type": "remote",
      "url": "https://gelato.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-gelato --url 'https://gelato.usefulapi.io/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-gelato:
    url: "https://gelato.usefulapi.io/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "io-usefulapi-gelato": {
      "Transport": "http",
      "Url": "https://gelato.usefulapi.io/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add io-usefulapi-gelato -t streamable-http -u 'https://gelato.usefulapi.io/mcp'
```

### Other

```json
{
  "mcpServers": {
    "io-usefulapi-gelato": {
      "type": "http",
      "url": "https://gelato.usefulapi.io/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-15 (score 65, +1)

No change was recorded against any check on this day. Stability & Change Management went from 13 to 17. That category is still filling its 30-day observation window: 4 days of observed history at the previous scan, 5 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-14 (score 64, +2)

- [security] The server rewrote its instructions, which are the text every model session reads
- [functional] The server now declares the “prompts” capability
- [functional] First check of Schema quality: 100
- [functional] New prompt “getting_started”
- [functional] Server version: 1.1.0 → 1.2.0

### 2026-10-12 (score 62, +1)

- [functional improvement] Stability: unverified → 0.07

### 2026-10-10 (score 61)

First indexed and scored.

## MCP tools (19)

### `gelato_list_catalogs` (~57 tokens)

List product 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.

### `gelato_get_catalog` (~85 tokens)

Get catalog

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 parameters:

- `catalog_uid` (string, required): Catalog UID, e.g. "posters" (from gelato_list_catalogs).

### `gelato_search_products` (~159 tokens)

Search catalog products

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 parameters:

- `attribute_filters` (object): Attribute name → accepted values, e.g. {"Orientation":["hor"],"PaperFormat":["A4","A3"]} (names and values from gelato_get_catalog).
- `catalog_uid` (string, required): Catalog UID, e.g. "posters".
- `limit` (integer): Results per page, 1-100 (default 50).
- `offset` (integer): Number of results to skip (default 0). Pass the previous reply's next_offset.

### `gelato_get_product` (~70 tokens)

Get product

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 parameters:

- `product_uid` (string, required): Gelato product UID (from gelato_search_products).

### `gelato_get_product_prices` (~141 tokens)

Get product prices

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 parameters:

- `country` (string): 2-letter ISO 3166-1 country code (the United Kingdom is GB, not UK).
- `currency` (string): 3-letter ISO 4217 currency code, e.g. USD or EUR.
- `page_count` (integer): Page count, required for multi-page products.
- `product_uid` (string, required): Gelato product UID.

### `gelato_get_cover_dimensions` (~101 tokens)

Get cover dimensions

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 parameters:

- `page_count` (integer, required): Total page count including covers (see validPageCounts in gelato_get_product).
- `product_uid` (string, required): Gelato product UID of a multi-page product.

### `gelato_check_stock` (~92 tokens)

Check stock availability

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 parameters:

- `product_uids` (array, required): Product UIDs to check (1-250).

### `gelato_list_shipment_methods` (~81 tokens)

List shipment methods

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 parameters:

- `country` (string): Only methods that deliver to this 2-letter ISO country code.

### `gelato_search_orders` (~342 tokens)

Search orders

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 parameters:

- `channels` (array): Only orders from these channels (ui, api, shopify, etsy).
- `countries` (array): Only orders shipping to these countries (2-letter ISO codes).
- `currencies` (array): Only orders in these currencies.
- `end_date` (string): Only orders ordered or created on or before this ISO 8601 date-time.
- `financial_statuses` (array): Only these financial statuses.
- `fulfillment_statuses` (array): Only these fulfillment statuses.
- `ids` (array): Only these Gelato order ids.
- `limit` (integer): Results per page, 1-100 (default 50).
- `offset` (integer): Number of results to skip (default 0). Pass the previous reply's next_offset.
- `order_reference_ids` (array): Only orders with these orderReferenceIds.
- `order_types` (array): Only these order types.
- `search` (string): Free text matched against the recipient's first or last name and orderReferenceId.
- `start_date` (string): Only orders ordered or created on or after this ISO 8601 date-time (e.g. 2026-10-01T00:00:00Z).
- `store_ids` (array): Only orders from these e-commerce store ids.

### `gelato_get_order` (~79 tokens)

Get order

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 parameters:

- `order_id` (string, required): Gelato order id (from gelato_search_orders).

### `gelato_quote_order` (~177 tokens)

Quote order

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 parameters:

- `allow_multiple_quotes` (boolean): Default true: one quote per fulfillment facility when one facility cannot make everything. False: one combined quote.
- `currency` (string, required): 3-letter ISO 4217 currency code, e.g. USD or EUR.
- `customer_reference_id` (string, required): Your customer reference id.
- `order_reference_id` (string, required): Your order reference id for the quote.
- `products` (array, required): Products to quote.
- `recipient` (object, required): Delivery address the quote is for.

### `gelato_create_order` (~252 tokens)

Create order (draft by default)

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 parameters:

- `currency` (string, required): 3-letter ISO 4217 currency code, e.g. USD or EUR.
- `customer_reference_id` (string, required): Your internal customer id.
- `items` (array, required): Line items.
- `metadata` (array): Up to 20 key/value pairs stored on the order.
- `order_reference_id` (string, required): Your internal order id.
- `order_type` (string): "draft" (default; review first) or "order" (produced and charged immediately).
- `shipment_method_uid` (string): A shipmentMethodUid from gelato_quote_order, or "normal", "standard", "express". Several values may be given separated by commas (no spaces). Omitted = cheapest.
- `shipping_address` (object, required): Delivery address.

### `gelato_submit_draft_order` (~75 tokens)

Submit draft order

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 parameters:

- `order_id` (string, required): Gelato order id of a draft order.

### `gelato_cancel_order` (~63 tokens)

Cancel order

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 parameters:

- `order_id` (string, required): Gelato order id.

### `gelato_delete_draft_order` (~55 tokens)

Delete draft order

Permanently delete a DRAFT order (regular orders cannot be deleted; cancel them instead). DELETE /v4/orders/{orderId}.

Input parameters:

- `order_id` (string, required): Gelato order id of a draft order.

### `gelato_list_store_products` (~184 tokens)

List store products

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 parameters:

- `limit` (integer): Results per page, 1-100 (default 50).
- `offset` (integer): Number of results to skip (default 0). Pass the previous reply's next_offset.
- `order` (string): Sort direction (default desc).
- `order_by` (string): Sort field (default createdAt).
- `store_id` (string, required): Gelato e-commerce store id.

### `gelato_get_store_product` (~87 tokens)

Get store product

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 parameters:

- `product_id` (string, required): Store product id (from gelato_list_store_products).
- `store_id` (string, required): Gelato e-commerce store id.

### `gelato_get_template` (~90 tokens)

Get template

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 parameters:

- `template_id` (string, required): Template id (Gelato dashboard → the template's URL).

### `gelato_create_product_from_template` (~261 tokens)

Create store product from template

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 parameters:

- `description` (string, required): Product description (HTML allowed by most stores).
- `product_type` (string): Product type shown in the store.
- `sales_channels` (array): Sales channels: "web" (default) or "global" (Shopify Point of Sale).
- `store_id` (string, required): Gelato e-commerce store id.
- `tags` (array): Product tags, at most 13 (Etsy stores: 20 characters each).
- `template_id` (string, required): Template id (see gelato_get_template).
- `title` (string, required): Product title.
- `variants` (array): Variants to create (omit for all template variants), each with the images for its placeholders.
- `vendor` (string): Vendor shown in the store.
- `visible_in_online_store` (boolean): Show the product in the online store (default false).

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-gelato/gelato#diagnostics

## Score history

- 2026-10-17: 65
- 2026-10-16: 65
- 2026-10-15: 65
- 2026-10-14: 64
- 2026-10-13: 62
- 2026-10-12: 62
- 2026-10-10: 61

## Common questions

### What is the Gelato MCP by usefulapi server?

Gelato MCP by usefulapi is listed in the public MCP registry as io.usefulapi/gelato. Browse the Gelato catalog, prices, orders and shipping; quote, create draft orders and products. This page covers its hosted endpoint (https://gelato.usefulapi.io/mcp).

### Is the Gelato MCP by usefulapi server safe to use?

Gelato MCP by usefulapi scores 65 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Gelato MCP by usefulapi server expose?

Gelato MCP by usefulapi exposes 19 tools: gelato_list_catalogs, gelato_get_catalog, gelato_search_products, gelato_get_product, gelato_get_product_prices, and 14 more. Their descriptions and schemas cost roughly 2,451 tokens of context every time the server is loaded.

### Does the Gelato MCP by usefulapi server require authentication?

Yes. Gelato MCP by usefulapi asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.

### Is the Gelato MCP by usefulapi server still maintained?

Gelato MCP by usefulapi is still listed as active in the MCP registry. We last reached this channel on 17 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://gelato.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Website: https://usefulapi.io/gelato/
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-gelato/gelato.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-gelato/gelato.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-gelato/gelato