Back to Tool Reference
MCP

trend.get

Return one named trend with its story, momentum, and keyword children.

Effectread-onlyScopetrend:readPlanStarter+

Parameters

trend_idstringRequired

id from trend.list.

Returns

id, name, one_line, why_now, design_direction (strings): The trend's story and how to design for it. lifecycle_stage, trend_type, seed_group (strings): total_search_volume, peak_search_volume, cluster_size (numbers): mean_velocity, max_velocity, breakout_count, mean_competition (numbers): Momentum signals from the underlying search data. interest_history (number[]): Sparkline of aggregate search interest. first_seen_at (string): keywords (object[]): Per-keyword children. Each: id, keyword, product_type, search_volume, competition, opportunity. Pick a keyword id matching the selected product type for design.generate(trend_match_uuid) or trend.generate_concept(match_id). Both require a keyword id, not this named trend's top-level id. has_ideas (boolean): design_ideas (object | null): Trend-level concept when one exists.

Request
json
{
  "name": "trend.get",
  "arguments": {
    "trend_id": "4e863e01-9848-44d6-99de-e9b42282dfe1"
  }
}
Response
json
{
  "id": "4e863e01-9848-44d6-99de-e9b42282dfe1",
  "name": "Bodega Core",
  "one_line": "Ironic streetwear graphics mimicking the mundane typography of disposable plastic grocery bags.",
  "why_now": "Streetwear continually recontextualizes cheap, everyday disposable items into ironic fashion statements. Though search interest has steadily declined over the past year, the classic 'Thank You' bag motif remains a recognizable staple of…",
  "design_direction": "Emulate the iconic 'Thank You' bodega bag layout using repetitive block typography, stark backgrounds, and basic red or blue spot colors. Swap the traditional pleasantries for ironic, nihilistic, or custom brand messaging, paired with…",
  "lifecycle_stage": "peak",
  "trend_type": "aesthetic",
  "total_search_volume": 1000,
  "peak_search_volume": 1000,
  "cluster_size": 2,
  "mean_velocity": -0.141,
  "max_velocity": -0.141,
  "breakout_count": 0,
  "mean_competition": 0.3333333333333333,
  "suggested_product_types": [
    "tshirt",
    "hoodie"
  ],
  "interest_history": [
    25,
    21
  ],
  "seed_group": "brand",
  "first_seen_at": "2026-07-27T12:53:13.780278Z",
  "keywords": [
    {
      "id": "9934ff1e-ca04-4ed8-b75d-c830c4834859",
      "keyword": "Plastic Bag T-Shirt",
      "product_type": "tshirt",
      "search_volume": 1000,
      "competition": 1.0,
      "opportunity": 0.34424696
    }
  ],
  "has_ideas": false,
  "design_ideas": null,
  "launch_concept": null
}