Back to Tool Reference
MCP

insight.get_overview

Return chart-free performance KPIs, deltas, channels, and narrative insights.

Effectread-onlyScopeinsight:readPlanGrowth

Parameters

rangestringDefault: "28d"

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

channelstringDefault: "all"

all, tiktok, etsy, shopify, or instagram. Defaults to all.

Returns

has_databoolean

false when no meaningful insight snapshots exist for the period.

metric_coveragestring

complete, partial, or unavailable. partial means a channel or day in the period did not report: kpis count it as zero, so they are a floor, not a full total, and deltas are computed from them. Say so when reporting these figures.

kpisobject

Orders, GMV, views, and CVR for the selected channel or all channels.

deltasobject

Period-over-period percent changes for orders, GMV, views, and CVR.

per_channelobject[]

Channel breakdown rows with orders, GMV, views, CTR, CVR, and that channel's own metric_coverage.

insightsobject[]

Narrative insight rows with type, severity, and message.

Request
json
{
  "name": "insight.get_overview",
  "arguments": {}
}
Response
json
{
  "has_data": false,
  "range": "28d",
  "channel": "all",
  "period": {
    "start_date": "2026-09-11",
    "end_date": "2026-10-08",
    "previous_start_date": "2026-08-14",
    "previous_end_date": "2026-09-10"
  },
  "message": "No insight snapshots are available for this period yet.",
  "metric_coverage": "unavailable",
  "kpis": {
    "orders": null,
    "gmv": null,
    "views": null,
    "cvr": null
  },
  "deltas": {
    "orders": null,
    "gmv": null,
    "views": null,
    "cvr": null
  },
  "delta_unit": "percent_change",
  "per_channel": [],
  "insights": []
}