Back to Tool Reference
MCP

catalog.list_blanks

List catalog blank products.

Effectread-onlyScopecatalog:readPlanany plan

Parameters

searchstring

Optional substring matched case-insensitively against title, name, brand, or vaybel_sku. Common shopper terms are normalized (for example "tee" to "t-shirt" and "women's" to "womens"). Preference words such as "premium" and "best-seller" help interpret the search phrase but do not imply true sales or quality data.

techniquestring

Optional technique filter. Accepts:

  • A specific provider technique string — "dtg", "cut-sew", "sublimation", "direct-to-fabric", "embroidery", "screen-print".
  • "aop" as a meta-value meaning "any all-over-print technique". Uses is_aop_technique so the set stays in sync with the rest of the platform.

Omit to return products of any technique.

categorystring

Optional substring matched against the product's human category title (e.g. "hoodie", "tee", "bag") and its provider type classification (e.g. "T-SHIRT", "CUT-SEW"). Case-insensitive — a match on either column includes the product.

limitintegerDefault: 20

Max products returned. Clamped to [1, 100].

Returns

{"products": [...], "count": <int>} — each product carries uuid, vaybel_sku, handle, name, title, type, brand, default_technique, category, product_tier, and genders, and research availability with its public URL. Use catalog.get_blank for cited selection guidance. Variants are intentionally omitted (fetched per-product later).

Request
json
{
  "name": "catalog.list_blanks",
  "arguments": {
    "category": "hoodie",
    "limit": 2
  }
}
Response
json
{
  "products": [
    {
      "uuid": "303bd2b6-8011-4dc9-a572-c3314d2bf03a",
      "vaybel_sku": "VB-HD-G18600",
      "handle": "vb-hd-g18600",
      "name": "Gildan 18600 Unisex Heavy Blend Zip Hoodie",
      "title": "Heavy Blend Full-Zip Hoodie",
      "type": "T-SHIRT",
      "brand": "Gildan",
      "default_technique": "dtg",
      "category": "Hoodie Zip",
      "product_tier": "universal",
      "genders": [
        "mens",
        "womens"
      ],
      "research": {
        "status": "not_available"
      }
    },
    {
      "uuid": "251ebb91-ea5e-432d-92c9-93fbefcb155e",
      "vaybel_sku": "VB-HD-G18500",
      "handle": "vb-hd-g18500",
      "name": "Gildan 18500 Unisex Heavy Blend Hoodie",
      "title": "Heavy Blend Adult Hooded Sweatshirt",
      "type": "T-SHIRT",
      "brand": "Gildan",
      "default_technique": "dtg",
      "category": "Hoodie Pullover",
      "product_tier": "universal",
      "genders": [
        "mens",
        "womens"
      ],
      "research": {
        "status": "available",
        "slug": "gildan-18500",
        "url": "https://vaybel.com/blanks/gildan-18500"
      }
    }
  ],
  "count": 2
}