Back to Tool Reference
MCP

mockup.get_generation

Return mockup generation status and the generated assets.

Effectread-onlyScopemockup:readPlanStarter+

Parameters

handlestringRequired

The task id returned by mockup.generate.

wait_secintegerDefault: 0

0 returns an instant snapshot. Positive values long-poll up to that many seconds and return when the mockups complete/fail or the timeout expires.

Returns

handlestring
status"pending" | "running" | "complete" | "failed"
progressnumber | null

Fractional progress 0.0-1.0 when known.

doneboolean
mockupsobject[]

Each: id, status, external_key, image_url, video_url, error, stage, progress.

urlstring | null

Page that opens these mockups in the app. Share this link rather than building one.

Request
json
{
  "name": "mockup.get_generation",
  "arguments": {
    "handle": "c1fe737e-8776-5f39-8c3a-acd25ad5b75e",
    "wait_sec": 50
  }
}