Research
Customer verbatims, personas, angles and formats, messaging lines, the Meta Ad Library, the swipe file, and recipes read from a reference ad.
meta_list_personas
READ — The workspace's personas — who the ads speak to — with pains, desires, objections, emotional triggers, trust needs and how they talk, each synthesized from customer quotes and curated by a human.
meta_list_angles
READ — The messaging angles — what an ad argues: promise, mechanism, pain addressed, emotional trigger, trust signals — each with the persona it was born from.
meta_list_formats
READ — Creative formats derived from the swipe file and the library — the reusable shapes an ad takes (founder to camera, notification stack, testimonial card…).
meta_list_verbatims
READ — Customer quotes, exactly as written — mined from reviews, the advertiser's site and competitors.
meta_link_verbatims
WRITE — File customer quotes under a persona and/or an angle, so they count as that audience's or message's evidence.
meta_list_research_sources
READ — Every research source with its id, label, kind, status and counts (documents stored, quotes mined).
meta_delete_research_source
WRITE — Permanently delete one research source and everything mined from it — its documents and their quotes.
meta_list_messaging
READ — The copy lines (hook, headline, primary_text, objection) written for the workspace's angles, with their status (draft, approved, rejected), who wrote them (`source`: ai or human) and the quotes they cite (`verbatimIds`, empty on a human line).
meta_draft_messaging
WRITE — Write copy lines for one angle from its evidence — hooks, headlines (≤40 chars), primary texts, objection handlers — each citing the quotes it was written from.
meta_save_messaging
WRITE — Add a copy line you or the human wrote, or edit one.
meta_set_messaging_status
WRITE — Approve, reject, or send back to draft one or several copy lines by id.
meta_delete_messaging
WRITE — Permanently delete copy lines by id.
meta_search_ad_library
READ — Search the Meta Ad Library for reference ads — by keyword across every advertiser, or every ad one advertiser is running.
meta_list_swipes
READ — The swipe file: reference ads the team has saved from the Ad Library, TikTok, Instagram, links or uploads — with advertiser, copy, CTA, landing page, tags and notes.
meta_save_swipe
WRITE — Save a reference ad to the swipe file from a link: a Meta Ad Library ad URL, a TikTok video, an Instagram post/reel, or a direct image/video URL.
meta_update_swipe
WRITE — Replace a swipe's tags and/or its note.
meta_get_recipe
READ — The recipe of one static — a swipe or one of our assets: its format, layout zones, copy verbatim, visual system, hook, and which slots a variation could change versus what carries the format.
save_report_viewwrite
Save an Ads report (/app/ads) as a named view, or update one (`view` = its slug).
list_personasread
The workspace's personas — who the ads speak to — with pains, desires, objections, emotional triggers, trust needs and how they talk, each synthesized from customer quotes and curated by a human.