MCP

trend.generate_concept

Dispatch launch-concept generation for a trend.

EffectwritesReachesoutside VaybelScopetrend:writePlanStarter+CreditsmeteredRate limit10/minIdempotent

The concept is an LLM-generated matrix of audience x gender x product type with prompts, written back to trend match design_ideas. Generation typically completes in 10-60s; call trend.get_generation with wait_sec=0 for a snapshot or wait_sec>0 to long-poll.

Bills CONCEPT_CREATED (2 credits) only when a new job is dispatched. Calling on a trend whose concept is already cached returns the cached concept immediately and is free.

Parameters

match_idstringRequired

Trend match ID.

idempotency_keystring

Send the same key when retrying this exact call. A completed request replays for 24 hours without running or billing again.

callback_urlstring

An https URL that receives a signed completion event when the work finishes, so you can skip polling. See Webhooks.

Returns

handlestring

Opaque async handle. Same as match_id.

status"complete" | "pending"

match_idstring

design_ideasobject | null

Populated when status == "complete"; null when newly dispatched.

dispatchedboolean

true only when a new generation was kicked off (and a credit charged).

messagestring

Describes the trend.get_generation(..., wait_sec=...) contract.

Request

json

{
  "name": "trend.generate_concept",
  "arguments": {
    "match_id": "0cc30a25-c433-5a48-b638-66eb227bce7b"
  }
}