Skip to main content

​
Meta Ads Tools

Four tools for listing campaigns, viewing insights, managing ad sets, and updating campaigns.
If you have only one Meta Ads account connected, the adAccountId parameter is optional — Lever auto-resolves it. If multiple accounts are connected, you must specify the ID. Use list_connections to find your account IDs.

​
meta_ads_list_campaigns

List all campaigns in the connected Meta Ads account. Type: read
ParameterTypeRequiredDescription
adAccountIdstringNoMeta ad account ID
Example prompt: “Show me all my Meta Ads campaigns” Returns: Campaign name, status, and daily budget for each campaign.

​
meta_ads_get_insights

Get performance insights for Meta Ads campaigns over a date range. Type: read
ParameterTypeRequiredDescription
adAccountIdstringNoMeta ad account ID
sincestringYesStart date (YYYY-MM-DD)
untilstringYesEnd date (YYYY-MM-DD)
levelaccount | campaign | adset | adNoReporting level (defaults to account)
Example prompt: “Get Meta Ads insights for the last 14 days at the campaign level” Returns: Performance metrics for the specified date range and reporting level.

​
meta_ads_list_adsets

List ad sets for a specific Meta Ads campaign. Type: read
ParameterTypeRequiredDescription
adAccountIdstringNoMeta ad account ID
campaignIdstringYesCampaign ID
Example prompt: “Show me the ad sets in Meta campaign 23456” Returns: Ad set name, status, and daily budget for each ad set.

​
meta_ads_update_campaign

Update a Meta Ads campaign’s status or daily budget. Goes through draft-preview-confirm — returns a preview that must be confirmed before the change executes. Type: write (draft-preview-confirm)
ParameterTypeRequiredDescription
adAccountIdstringNoMeta ad account ID
campaignIdstringYesCampaign ID
statusACTIVE | PAUSEDNoNew campaign status
dailyBudgetnumberNoNew daily budget in dollars
Example prompt: “Pause my Meta Ads campaign 23456”
Meta Ads uses ACTIVE and PAUSED for campaign status. This is different from Google Ads, which uses ENABLED and PAUSED.
Returns: A draft preview showing the proposed changes and a draftId. Call confirm_draft to execute.