Upspring

The advertisers this workspace follows (its watchlist). Start here when the question is about "my competitors" or "the brands we track".

get_watched_advertisers

Account-level performance snapshots (spend, ROAS, CTR, CPA, purchases, leads, cost per lead, conversion rate...) for YOUR OWN ad account, daily or monthly. "Conversion" is dynamic — pass conversion_event to headline leads/purchases/registrations/etc.; each response also carries a full conversions map. Performance data is available from 2026-02-01 to 2026-08-31. Defaults to ad account act_2042363319624030 in "Upspring MCP " unless you pass ad_account (and space_id when it is ambiguous).

get_my_performance_summary

Per-ad performance rows (spend, ROAS, CTR, CPA, purchases, hook rate, leads, cost per lead, conversion rate...) for YOUR OWN ads, sortable by any metric. "Conversion" is dynamic — pass conversion_event to headline leads/purchases/registrations/etc.; each row also carries a full conversions map. Performance data is available from 2026-02-01 to 2026-08-31. Defaults to ad account act_2042363319624030 in "Upspring MCP " unless you pass ad_account (and space_id when it is ambiguous). Pass scope: "all_granted" to aggregate across every granted workspace instead of just one (opt-in; logged distinctly).

get_my_ads_performance

Per-ad performance for YOUR OWN ads across ANY custom date range, not just whole months. Fetched LIVE for the exact dates, so recent windows reflect the freshest attributed numbers, and metrics honor this workspace attribution window (override per call with attribution_windows). Each ad returns spend, impressions, clicks, ctr, cpc, cpm, reach, frequency, plus a conversions map of every conversion type (purchase, lead, registration, ...) with count and value, and headline leads / cost_per_lead / conversion_rate. The response also carries account_total (an aggregate over EVERY ad in the range) and total (the full ad count); the per-ad rows are the top ones by spend, use offset to page. Meta ad accounts only for now. Defaults to ad account act_2042363319624030 in "Upspring MCP " unless you pass ad_account (and space_id when it is ambiguous).

get_my_ads_by_date_range

The customer's own brand grounding: brand context, marketing calendar, performance goals, account creative profile (creative-DNA fingerprint), playbook, and saved knowledge. START HERE for any question about the user's own brand, strategy, or "in our style" requests — then use the other get_my_* tools for numbers.

get_my_brand_profile

Fetch ONE of YOUR OWN ad creatives by its Upspring creative id: its content (copy, headlines, landing pages), its property tags (Content Type, Theme, Emotion Tone, Visual Style, ...), and a recent performance snapshot (spend, ROAS, purchases, CPA, CTR, plus leads / cost-per-lead / conversion rate where available). Pass include_descriptors to also get the full scene-by-scene textual description of the creative. Use this for the deepest read of a single creative, e.g. from the Upspring app's "Open in Claude" button or a creative_id from get_my_ads_by_date_range. To skim many creatives at once, use get_my_creative_descriptors. Defaults to ad account act_2042363319624030 in "Upspring MCP " unless you pass ad_account (and space_id when it is ambiguous).

get_my_creative

Creative-DNA patterns across YOUR OWN ads (which creative attributes correlate with performance). Performance data is available from 2026-02-01 to 2026-08-31. Defaults to ad account act_2042363319624030 in "Upspring MCP " unless you pass ad_account (and space_id when it is ambiguous).

get_my_creative_patterns

YOUR OWN best (or worst) performing ads in a date range — leads, cost per lead, and conversion rate are shown per creative alongside spend/ROAS/CPA. "Conversion" is dynamic — pass conversion_event to headline leads/purchases/registrations/etc. Performance data is available from 2026-02-01 to 2026-08-31. Defaults to ad account act_2042363319624030 in "Upspring MCP " unless you pass ad_account (and space_id when it is ambiguous). Pass scope: "all_granted" to aggregate across every granted workspace instead of just one (opt-in; logged distinctly).

get_my_top_ads

Query the industry/competitor ad corpus. With group_by: a distribution (share per dimension value, with human labels, descriptions, and verbatim examples). Without group_by: a ranked ad list ("best" = strongest performance signal, "recent" = newest) with creative DNA and one-line descriptions per ad; each ad carries human-readable labels for its creative dimensions. Follow up with get_ad_descriptors on shortlisted ad_ids for the full creative narration. Each ad also carries source_id — the Meta Ad Library id shown in the Upspring app, for cross-referencing a specific ad with the user.

query_industry_ads

Textual, scene-by-scene descriptions of SEVERAL of YOUR OWN creatives at once, so you can read and reason over many creatives without watching the videos. Pass creative_id values from get_my_ads_by_date_range (up to 15). Returns, per creative, a compact opening gist plus its property tags (and scene_count); pass full=true for the complete scene-by-scene text (heavier, use for a small set). This is the tool for analyzing creative patterns across your ads at scale; use get_my_creative for the single deepest read of one creative. Defaults to ad account act_2042363319624030 in "Upspring MCP " unless you pass ad_account (and space_id when it is ambiguous).

get_my_creative_descriptors

Look up whether a brand is in Upspring. Returns status "ready" (already here — the row carries advertiser_id for the other tools), "onboardable" (we can pull it in — each match carries an onboard_ref for onboard_advertiser), or "not_found". Use this whenever a user names a brand you cannot find with query_advertisers.

resolve_advertiser

Repoint the DEFAULT own-ads target to another workspace you granted this connection. Convenience only — you can also target any granted ad account per call via ad_account/space_id. Takes effect on subsequent calls.

switch_workspace