Meta tools

Meta ad accounts reachable with the connected Meta token: id (act_…), name, currency, status, timezone, lifetime spend, business, and which one is selected. Read only; connected=false when Meta is not linked.

This tool takes no parameters.

Facebook + Instagram performance (Meta Insights) at campaign, ad set or ad level for a date range, optionally broken down by age, gender, placement or device: spend, impressions, reach, frequency, clicks, CTR, CPM, CPC, conversions, revenue, ROAS (purchase_roas) and CPA (cost_per_action_type). Sort by any metric and filter with thresholds (e.g. roas_below=3 sorted by spend, cpa_above=40). Real data only.

Best-performing Meta ads (creatives) in a placement such as Instagram Reels, ranked by ROAS, CPA, conversions or CTR, with creative details (thumbnail, video, Instagram permalink) and their ad set ids for duplication.

Custom and lookalike audiences of the Meta ad account: id, name, subtype, approximate size range, retention, delivery status.

This tool takes no parameters.

Search Meta's interest taxonomy (targeting search) by keyword: interest id, name, path and audience size range. Use the ids in targeting.interest_ids.

Estimated audience size for a targeting set before spending (Meta delivery estimate, falling back to reach estimate): monthly active users range and daily users.

Meta ad sets with status, daily/lifetime budget (account currency), bid, optimisation goal, targeting and schedule.

Recent Instagram posts of the connected Instagram business account with likes, comments and engagement, sorted by engagement — to pick a post to boost.

Lead (instant) forms of the Facebook Page with status and lead counts. Creating new lead forms is not supported.

Lead counts for one lead form over the last N days, by day, by ad and by platform. Counts only; personal answers are never returned.

Choose which Meta ad account all further Meta tools work in (agency / multi-account). Only accounts the user can access are accepted.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a website custom audience from the Meta pixel (e.g. added to cart in the last 30 days but did not purchase). Preview and approval first; the audience populates within hours.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a Meta lookalike audience (1–10%) of a custom audience in one or more countries. Preview and approval first.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a Meta campaign end to end (campaign + ad set + ad when a page and creative exist) as a paused draft with objective, daily budget and targeting. Writes a ledger draft and an approval item; sent to Meta only after approval.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Change a Meta campaign's budget (daily/lifetime), status, name, bid strategy or spend cap. Preview with before → after; budget increases above +50% per step are blocked. Applied only after approval.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Change a Meta ad set's budget, status, targeting (locations, age, gender, interests, audiences, placements), bid or schedule. Preview and approval first; the budget guardrail applies.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Duplicate a winning Meta ad set (with its ads) as a paused copy and give it a new interest audience, targeting or budget for a test. Preview and approval first.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Find active Meta ad sets whose CPA is above a threshold (or that spent at least the threshold with zero results), pause them in one action and move their freed daily budget to the best-CPA ad set within the +50% guardrail. Shows the list first; applied only after approval.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a Meta carousel ad (2–10 image cards, e.g. five product images) in an ad set for Facebook and Instagram. Studio images are uploaded to Meta (adimages). Created paused after approval.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a Meta video ad from an existing video id in an ad set (thumbnail taken from the video when not given). Created paused after approval.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Turn an existing Instagram post (source_instagram_media_id) or Facebook Page post (object_story_id) into an ad in an ad set; pick_best chooses the most engaging recent Instagram post. Preview and approval first; created paused.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.