Back to Tool Reference
MCP

mockup.list

Find saved mockups with complete image details, scoped to the caller's org.

Effectread-onlyScopemockup:readPlanStarter+

For a request to see a design's saved mockups, use this tool once with design_id and status=CREATED. This returns data without displaying a widget. Each result already contains the same fields as mockup.get, including image, view and url; these are complete records, not search summaries. Do not follow this call with mockup.get for the returned items to obtain images, labels or links. To show the chosen views, call mockup.show once with their IDs together. Reuse the results to answer. Fetch another page only when the requested mockups are not on this page.

Parameters

design_idstring

Optional product design ID to filter to one design.

statusstring

Optional mockup status value (PREPARING / QUEUED / GENERATING / CREATED / FAILED).

groupstring

Optional mockup group value (e.g. flat_images, vto, lifestyle, shoppable_videos).

pageintegerDefault: 1

1-indexed.

page_sizeintegerDefault: 20

Clamped to [1, 100].

Returns

resultsMockup[]

Full records including image (image URL), view (label), and url (saved mockups page in the app).

totalnumber
pagenumber
page_sizenumber
Request
json
{
  "name": "mockup.list",
  "arguments": {}
}
Response
json
{
  "results": [
    {
      "id": "d5954486-fb42-4cfc-a226-332cfa9fc2a7",
      "view": "Front Full",
      "external_key": "flat_front_full",
      "type": "lifestyle_images",
      "environment": "lifestyle",
      "width": 2048,
      "height": 2048,
      "image": "https://cdn.vaybel.com/lifestyle_mockups/06ff6c40-4bed-430e-ac19-a6688619a8fd/flat_front_full_65304b965c66.png",
      "video": null,
      "status": "CREATED",
      "selected": true,
      "video_type": null,
      "created_at": "2026-09-25T11:09:17.169825+00:00",
      "queue_position": null,
      "step_progress": null,
      "feedback": null,
      "product_design": {
        "id": "06ff6c40-4bed-430e-ac19-a6688619a8fd",
        "title": "Cyberpunk Astronaut Dog Tee",
        "image": null
      },
      "step_message": "Mockup ready",
      "error_message": "",
      "url": "https://vaybel.com/dashboard/launch-product/06ff6c40-4bed-430e-ac19-a6688619a8fd/mockups"
    },
    {
      "id": "17aeb002-2322-4bef-88ff-d4fe9e81a2c4",
      "view": "Front",
      "external_key": "vto_front",
      "type": "lifestyle_images",
      "environment": "lifestyle",
      "width": 2048,
      "height": 2048,
      "image": "https://cdn.vaybel.com/lifestyle_mockups/06ff6c40-4bed-430e-ac19-a6688619a8fd/vto_front_8011693e2763.png",
      "video": null,
      "status": "CREATED",
      "selected": true,
      "video_type": null,
      "created_at": "2026-09-25T11:09:17.168263+00:00",
      "queue_position": null,
      "step_progress": 0,
      "feedback": null,
      "product_design": {
        "id": "06ff6c40-4bed-430e-ac19-a6688619a8fd",
        "title": "Cyberpunk Astronaut Dog Tee",
        "image": null
      },
      "step_message": "Mockup ready",
      "error_message": "",
      "url": "https://vaybel.com/dashboard/launch-product/06ff6c40-4bed-430e-ac19-a6688619a8fd/mockups"
    }
  ],
  "total": 25,
  "page": 1,
  "page_size": 20
}