creative

Tools backed by the creative module

Creative leaderboard

POST

https://dtrgbxembnbwlmpvhhms.supabase.co/functions/v1/cortex-mcp

/api/v1/tools/get_creative_leaderboard

Bearer (ck_ endpoint token)

Per-creative leaderboard with winner / mid / loser labels, trend, spend, CTR, KPI count, cost per KPI and the extracted creative attributes (visual style, messaging angle, density, specificity, human presence, subject elements) — the tool for "what is working creatively" and "what do our winners have in common". window_days accepts only 30, 60, 90 or 120 (attributes are precomputed nightly for those windows); it takes no start_date/end_date. Its metrics are ad-platform reported, so for CRM-source organizations the KPI columns are near zero by design — rank creatives by MQL with get_ads_performance instead. Requires the Creative module: without it this returns a clean "not part of this organization's plan" refusal rather than empty data.

Creative leaderboard › Request Body

window_days

number · enum

Lookback window in days. Only 30, 60, 90 and 120 exist (the attributes are precomputed nightly for those windows); default 90.

Enum values:

120

sort

string · enum

Ranking column (default cost_per_kpi). cost_per_kpi orders cheapest-first (best first); spend, ctr and kpis order highest-first.

Enum values:

cost_per_kpi

spend

ctr

kpis

limit

integer · min: 1 · max: 100

Rows to return (default 25, max 100).

Creative leaderboard › Responses

The tool ran

ToolResult

ok

boolean · const · required

Const value:

tool

string · required

data

required

The tool's payload — byte-identical to what the same tool returns over MCP.

compass email