Documentation / Tool Reference

Meta Ads tools

27 tools for Facebook & Instagram ads: campaign/ad set/ad management, all ad formats, custom & lookalike audiences, detailed targeting, and insights.

Connection & Account · 3

connect_meta_adsfree

Generates a one-time authorization link to connect a Meta (Facebook/Instagram) ad account.

list_meta_ad_accounts1 credits

Lists the ad accounts accessible to the connected Meta user (Facebook + Instagram ads are managed in one account).

list_meta_pages1 credits

Lists the Facebook Pages managed by the connected Meta user (id, name, category).

Reading & Reporting · 9

list_meta_campaigns1 credits

Lists campaigns in a Meta ad account.

account_id

meta_campaign_insights2 credits

Meta performance report (impressions/clicks/spend/reach/conversion actions).

account_iddate_presetlevelbreakdownsinceuntil

search_meta_interests1 credits

Searches Meta detailed-targeting assets by name → returns id + estimated audience size.

querykindlimit

list_meta_pixels1 credits

Lists conversion pixels in a Meta ad account (id, name, last fired).

account_id

meta_reach_estimate2 credits

Returns the estimated reach for a targeting (audience size before spending).

account_idcountriesage_minage_maxinterest_idsoptimization_goal

list_meta_adsets1 credits

Lists Meta ad sets; if campaign_id is given, limits to that campaign.

account_idcampaign_id

list_meta_ads1 credits

Lists Meta ads; if adset_id is given, limits to that ad set.

account_idadset_id

list_meta_page_posts1 credits

Lists the recent posts of a Facebook Page (object_story_id, text, date, link).

page_idlimit

list_meta_audiences1 credits

Lists the custom audiences (custom/lookalike/website retargeting) in a Meta ad account.

account_id

Campaign · 3

create_meta_campaign8 credits

Creates a Meta campaign.

account_idnameobjectivedaily_budgetspecial_ad_categoriesstatus

update_meta_campaign5 credits

Updates a Meta campaign (only the given fields).

account_idcampaign_idnamestatusdaily_budget

delete_meta_campaign5 credits

Deletes a Meta campaign (reporting data remains readable in Meta).

account_idcampaign_id

Ad set · 3

create_meta_adset5 credits

Creates a Meta ad set.

account_idcampaign_idnameoptimization_goalbilling_eventdaily_budgetcountriesage_minage_maxgendersinterest_idscustom_audience_idsexcluded_custom_audience_idspublisher_platforms

update_meta_adset5 credits

Updates a Meta ad set (only the given fields).

account_idadset_idnamestatusdaily_budget

delete_meta_adset5 credits

Deletes a Meta ad set.

account_idadset_id

Ad & Creative · 7

create_meta_link_ad8 credits

Creates a Meta link ad (creative + ad in one step).

account_idadset_idnamepage_idmessagelinkheadlineimage_urlstatus

create_meta_carousel_ad8 credits

Creates a Meta carousel ad (2-10 cards).

account_idadset_idnamepage_idmessagecardscta_typestatus

create_meta_post_ad8 credits

Turns an existing Facebook/Instagram Page post into an ad (boosts an organic post).

account_idadset_idnameobject_story_idstatus

create_meta_video_ad8 credits

Creates a Meta video ad.

account_idadset_idnamepage_idvideo_urlmessagelinkheadlineimage_urlcta_typestatus

update_meta_ad5 credits

Changes a Meta ad's name/status.

account_idad_idnamestatus

copy_meta_entity5 credits

Copies a Meta campaign/ad set/ad (the 'Duplicate' action in Ads Manager).

account_idkindentity_iddeep_copyrename_prefix

delete_meta_ad5 credits

Deletes a Meta ad.

account_idad_id

Audiences · 2

create_meta_website_audience5 credits

Creates a website retargeting audience (visitors who fired the pixel, last N days).

account_idnamepixel_idretention_days

create_meta_lookalike_audience5 credits

Creates a lookalike audience from a source custom audience.

account_idnamesource_audience_idcountryratio