Back to Tool Reference
MCP

insight.list_design_performance

List recorded design performance with paging and measured metrics first.

Effectread-onlyScopeinsight:readPlanGrowth

Aggregates per-design metrics from the daily analytics snapshots across the range. Unavailable or undated metrics are null, not zero. They sort after measured values and do not establish underperformance. Each row's metric_coverage says whether every channel and day reported; partial values sum only what was measured. Designs absent from the collected snapshots are not included.

Parameters

rangestringDefault: "28d"

Time range: 7d or 28d. Defaults to 28d.

sortstringDefault: "gmv"

Sort metric: gmv, orders, or views. Per-design CVR is not available consistently.

pageintegerDefault: 1

1-based page number.

page_sizeintegerDefault: 20

Clamped to [1, 100].

Returns

resultsobject[]

Per-design rows with nullable views, orders, impressions, and GMV, plus metric_coverage: complete, partial (at least one channel or day did not report), or unavailable.

caveatstring

States that null means unavailable, not zero, and what partial coverage means.

totalint

Number of designs before pagination.

pageint

Current page.

page_sizeint

Effective page size.

Request
json
{
  "name": "insight.list_design_performance",
  "arguments": {}
}
Response
json
{
  "has_data": false,
  "range": "28d",
  "period": {
    "start_date": "2026-09-11",
    "end_date": "2026-10-08"
  },
  "sort": "gmv",
  "source": "DailyOrganizationInsight.top_designs daily analytics snapshots",
  "caveat": "Ranks recorded daily design metrics. Null means unavailable, not zero; those rows follow measured values. metric_coverage is complete, partial or unavailable: partial means at least one channel or day did not report, so the values sum only…",
  "results": [],
  "total": 0,
  "page": 1,
  "page_size": 20
}