Meta ads

7 read3 write

Read-only Meta ad performance and creative breakdowns — spend / pause not exposed.

Detailed reference

get_ad_detailsreadforeplay.view_library

Full detail on a single ad, optionally including duplicates running on other networks.

Parameters

ad_id *	string	Foreplay ad UUID.
include_duplicates	boolean	Defaults to false.

Returns

Full ad object with creative_url, transcript, cta, target_country, optional duplicates[].

Example question

"Where else is this ad running?"

get_ad_performancereadmeta_ads.view

Spend, ROAS, CTR, CPM by campaign, adset, or ad. Read-only - no spend or pause via the MCP.

Parameters

ad_account_id	string?	Optional. Scope to one account.
days	integer	Window in days. Defaults to 30.

Returns

Per object: spend_cents, impressions, clicks, ctr, cpm, roas, conversions.

Example question

"What's my best ROAS this week?"

get_creative_breakdownreadmeta_ads.view

Top performing creatives (image/video) ranked by any metric.

Parameters

ad_account_id	string?	Optional. Scope to one account.
days	integer	Window in days. Defaults to 30.

Returns

Top creatives with thumbnail_url, type, ctr, cpm, conversion_rate.

Example question

"Which video creatives have the highest CTR?"

list_ad_accountsreadmeta_ads.view

Connected Meta ad accounts and their connection status.

Parameters

None.

Returns

Per account: id, name, currency, status, last_synced_at, balance_cents.

Example question

"Which Meta ad accounts are connected?"

list_ad_rulesread
List automation rules attached to one Meta ad account (auto-pause underperformers, scale winners, etc).
list_ad_setsread
List ad sets within a Meta campaign. Each ad set has its own targeting + budget + bid strategy.
list_ads_in_campaignread
pause_meta_campaignwrite
Pause one Meta ad campaign (sets status to PAUSED). Outbound spend stops immediately. Idempotent — pausing an already-paused campaign is safe.
resume_meta_campaignwrite
Resume one previously paused Meta ad campaign (sets status to ACTIVE).
update_campaign_budgetwrite