meta-ads-mcp
MCP server for the Meta Marketing API v25.0 — 135 tools for managing Facebook & Instagram ad campaigns, audiences, creatives, insights, catalogs, and more.
When to Use
Use this MCP when you need to:
"Create a new Facebook ad campaign" — use create_campaign, create_adset, create_ad, and create_creative to build a full funnel"Check how my ads are performing today" — use get_account_insights or get_campaign_insights with today's date range"Pause all campaigns with ROAS below 2" — use list_campaigns + get_campaign_insights to find underperformers, then update_campaign to pause"Set up A/B test between two ad creatives" — use create_experiment to run a controlled test between ad sets"Create a lookalike audience from my customers" — use create_custom_audience, add_users_to_audience, then create_lookalike_audience"Upload ad images and create a carousel ad" — use upload_image for each image, then create_creative with carousel format"Get a detailed performance report for last 30 days" — use create_async_report for large date ranges, then get_async_report to retrieve"Search the Facebook Ad Library for competitor ads" — use search_ad_library to find public ad data"Set up automated rules to pause underperforming ads" — use create_rule with conditions like CPA > threshold"Manage my product catalog for dynamic ads" — use create_catalog, create_feed, and upload_feed to set up dynamic product ads
Installation
hljs language-json
Copy {
"mcpServers" : {
"meta-ads" : {
"command" : "npx" ,
"args" : [ "-y" , "@mikusnuz/meta-ads-mcp" ] ,
"env" : {
"META_ADS_ACCESS_TOKEN" : "your-access-token" ,
"META_AD_ACCOUNT_ID" : "123456789" ,
"META_APP_ID" : "your-app-id" ,
"META_APP_SECRET" : "your-app-secret" ,
"META_BUSINESS_ID" : "your-business-id" ,
"META_PIXEL_ID" : "your-pixel-id"
}
}
}
}
Environment Variables
Variable Required Description META_ADS_ACCESS_TOKENYes Meta Marketing API access token META_AD_ACCOUNT_IDYes Ad account ID (numeric, without act_ prefix) META_APP_IDOptional App ID — required for token exchange/debug META_APP_SECRETOptional App secret — required for token exchange/debug META_BUSINESS_IDOptional Business Manager ID — required for business tools META_PIXEL_IDOptional Pixel ID — required for conversion tools
Tools (135)
Campaign Management (25)
Tool Description list_campaignsList campaigns with filtering and pagination get_campaignGet campaign details by ID create_campaignCreate a new campaign update_campaignUpdate campaign settings delete_campaignDelete a campaign copy_campaignCopy an existing campaign with ad sets and ads get_campaign_adsetsList ad sets within a campaign get_campaign_adsList ads within a campaign get_campaign_leadsGet leads from a campaign list_adsetsList ad sets with filtering get_adsetGet ad set details by ID create_adsetCreate a new ad set update_adsetUpdate ad set settings delete_adsetDelete an ad set copy_adsetCopy an existing ad set to same or different campaign get_adset_targeting_sentenceGet human-readable targeting description get_adset_adsList ads within an ad set get_adset_leadsGet leads from an ad set list_adsList ads with filtering get_adGet ad details by ID create_adCreate a new ad update_adUpdate ad settings delete_adDelete an ad copy_adCopy an existing ad to same or different ad set get_ad_previewGenerate ad preview HTML get_delivery_estimateGet delivery estimate for an ad
Creatives (6)
Tool Description list_creativesList ad creatives get_creativeGet creative details create_creativeCreate a new ad creative update_creativeUpdate an ad creative create_dynamic_creativeCreate a dynamic creative generate_previewGenerate ad preview from creative spec without an existing ad
Media Assets (12)
Tool Description list_imagesList ad images upload_imageUpload an image from URL get_imageGet image details delete_imageDelete an image list_videosList ad videos upload_videoUpload a video from URL get_videoGet video details delete_videoDelete a video list_canvasesList Instant Experience canvases get_canvasGet canvas details create_canvasCreate a canvas delete_canvasDelete a canvas
Audiences & Targeting (16)
Tool Description list_custom_audiencesList custom audiences get_audienceGet audience details create_custom_audienceCreate a custom audience update_audienceUpdate audience settings delete_audienceDelete an audience add_users_to_audienceAdd users to a custom audience remove_users_from_audienceRemove users from a custom audience create_lookalike_audienceCreate a lookalike audience get_audience_healthGet audience health, delivery status, and match rate list_saved_audiencesList saved audiences get_saved_audienceGet saved audience details search_targetingSearch targeting interests, behaviors, demographics search_locationsSearch targetable locations search_targeting_mapBrowse targeting category tree get_reach_estimateEstimate audience reach for targeting spec get_targeting_suggestionsGet related targeting suggestions
Insights & Reporting (6)
Tool Description get_account_insightsAccount-level performance metrics get_campaign_insightsCampaign-level performance metrics get_adset_insightsAd set-level performance metrics get_ad_insightsAd-level performance metrics create_async_reportCreate an async insights report get_async_reportPoll async report status and results
Leads (5)
Tool Description get_form_leadsGet leads from a lead form get_leadGet a single lead by ID create_lead_formCreate a new lead generation form on a page list_lead_formsList lead gen forms for a page get_lead_formGet lead form details
Catalog & Commerce (17)
Tool Description list_catalogsList product catalogs get_catalogGet catalog details create_catalogCreate a product catalog update_catalogUpdate a catalog list_product_setsList product sets in a catalog create_product_setCreate a product set get_product_setGet product set details update_product_setUpdate a product set list_productsList products in a catalog get_productGet product details update_productUpdate a product list_feedsList data feeds for a catalog create_feedCreate a data feed upload_feedUpload data to a feed get_feed_uploadsGet feed upload history batch_productsBatch create, update, or delete products (up to 5,000/request) get_batch_statusCheck status of a catalog batch operation
Automation & Rules (5)
Tool Description list_rulesList automated rules get_ruleGet rule details create_ruleCreate an automated rule update_ruleUpdate a rule delete_ruleDelete a rule
Experiments (5)
Tool Description list_experimentsList A/B test experiments create_experimentCreate an experiment get_experimentGet experiment details update_experimentUpdate an experiment get_experiment_resultsGet experiment results
Conversions (4)
Tool Description send_conversion_eventSend server-side conversion event via Conversions API send_offline_eventSend an offline conversion event list_offline_event_setsList offline event sets create_offline_event_setCreate an offline event set
Budget & Planning (8)
Tool Description list_budget_schedulesList budget schedules create_budget_scheduleCreate a budget schedule update_budget_scheduleUpdate a budget schedule delete_budget_scheduleDelete a budget schedule list_rf_predictionsList Reach & Frequency predictions create_rf_predictionCreate a Reach & Frequency prediction get_rf_predictionGet prediction details delete_rf_predictionDelete a prediction
Brand Safety (5)
Tool Description list_block_listsList publisher block lists create_block_listCreate a block list add_to_block_listAdd URLs/domains to a block list remove_from_block_listRemove entries from a block list delete_block_listDelete a block list
Account & Business (15)
Tool Description get_ad_accountGet ad account details list_ad_accountsList ad accounts for a business update_ad_accountUpdate ad account settings get_account_activitiesGet account activity log list_account_usersList users with access to the account list_businessesList businesses you have access to get_businessGet business details list_business_ad_accountsList ad accounts in a business list_business_usersList users in a business add_business_userAdd a user to a business remove_business_userRemove a user from a business list_business_pagesList Facebook Pages owned by a business list_business_instagram_accountsList Instagram accounts owned by a business list_system_usersList system users for a business create_system_userCreate a system user
Auth & Token (3)
Tool Description exchange_tokenExchange short-lived token for long-lived token refresh_tokenRefresh a long-lived token debug_tokenDebug/inspect token metadata
Ad Library (1)
Tool Description search_ad_librarySearch Meta Ad Library for public ad data
Resources (3)
URI Description ads://accountAd account overview — status, balance, currency, timezone, and total spend ads://campaigns-overviewAll active campaigns with budget information ads://spending-todayToday's spending summary — spend, impressions, clicks, and reach
Prompts (3)
Prompt Description campaign_wizardStep-by-step guide to create a full ad campaign from scratch performance_reportAnalyze ad performance with detailed breakdowns and recommendations audience_builderBuild and refine target audiences using Meta's targeting tools
Permissions Required
Your Meta access token needs the following permissions depending on which tools you use:
Permission Tools ads_managementAll campaign, ad set, ad, and creative CRUD operations ads_readAll read/list operations and insights business_managementBusiness tools, system users, account assignments leads_retrievalLead form and lead data tools catalog_managementCatalog, product set, product, and feed tools pages_read_engagementLead forms linked to pages
License
MIT
