Back to Tool Reference
MCP

trend.list

List the org's named trends, strongest first.

Effectread-onlyScopetrend:readPlanStarter+

A named trend is a cluster of related search keywords with a story — "Coastal Grandma Revival", not "linen tshirt". This is the primary trend feed (same data as the dashboard's Find Trend page); the per-keyword metric rows behind each trend live under trend.list_keywords / trend.get_keyword.

Use this tool for trend recommendations, including garment-specific requests. Preserve the requested lifecycle. If fewer matching trends exist than asked for, show the available matches and say so briefly; offer to broaden the search rather than substituting keywords or relabeling other lifecycle stages. Present each choice by name with a short plain-language direction. Internal ranking scores are not exposed. After selection, use trend.get for that trend's keyword IDs and design direction.

Parameters

lifecyclestring

Optional filter — one of "emerging" / "rising" / "peak" / "declining".

trend_typestring

Optional trend trend_type filter (e.g. "aesthetic").

pageintegerDefault: 1

1-indexed.

page_sizeintegerDefault: 30

Clamped to [1, 100].

product_typestring

Optional search term (e.g. "tshirt" or "hoodie"). Requires a visible supporting keyword for that garment; filters results and view_counts without changing lifecycle labels.

Returns

resultsTrend[]

Each: id, name, one_line, lifecycle_stage, trend_type, total_search_volume, peak_search_volume, cluster_size, breakout_count, suggested_product_types, seed_group, first_seen_at. Internal ranking scores are omitted.

totalnumber
view_countsobject

{all, emerging, rising, peak, declining} for filter UIs.

Request
json
{
  "name": "trend.list",
  "arguments": {}
}
Response
json
{
  "results": [
    {
      "id": "4e863e01-9848-44d6-99de-e9b42282dfe1",
      "name": "Bodega Core",
      "one_line": "Ironic streetwear graphics mimicking the mundane typography of disposable plastic grocery bags.",
      "lifecycle_stage": "peak",
      "trend_type": "aesthetic",
      "total_search_volume": 1000,
      "peak_search_volume": 1000,
      "cluster_size": 2,
      "breakout_count": 0,
      "suggested_product_types": [
        "tshirt",
        "hoodie"
      ],
      "seed_group": "brand",
      "first_seen_at": "2026-07-27T12:53:13.780278Z",
      "drops": []
    },
    {
      "id": "3253d79b-39be-4268-994a-b5c703c07ef7",
      "name": "Angel Number Streetwear",
      "one_line": "Minimalist and streetwear-inspired typography featuring spiritual angel numbers for daily manifestation.",
      "lifecycle_stage": "peak",
      "trend_type": "cultural",
      "total_search_volume": 720,
      "peak_search_volume": 480,
      "cluster_size": 4,
      "breakout_count": 0,
      "suggested_product_types": [
        "hoodie",
        "tshirt"
      ],
      "seed_group": "brand",
      "first_seen_at": "2026-07-27T12:53:13.780299Z",
      "drops": []
    }
  ],
  "total": 4,
  "page": 1,
  "page_size": 30,
  "view_counts": {
    "all": 4,
    "emerging": 0,
    "rising": 0,
    "peak": 4,
    "declining": 0
  }
}