MCP server for Meta Marketing API v25.0
meta-ads-mcp
MCP server for the Meta Marketing API v25.0 — 123 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, andcreate_creativeto build a full funnel - "Check how my ads are performing today" — use
get_account_insightsorget_campaign_insightswith today's date range - "Pause all campaigns with ROAS below 2" — use
list_campaigns+get_campaign_insightsto find underperformers, thenupdate_campaignto pause - "Set up A/B test between two ad creatives" — use
create_experimentto run a controlled test between ad sets - "Create a lookalike audience from my customers" — use
create_custom_audience,add_users_to_audience, thencreate_lookalike_audience - "Upload ad images and create a carousel ad" — use
upload_imagefor each image, thencreate_creativewith carousel format - "Get a detailed performance report for last 30 days" — use
create_async_reportfor large date ranges, thenget_async_reportto retrieve - "Search the Facebook Ad Library for competitor ads" — use
search_ad_libraryto find public ad data - "Set up automated rules to pause underperforming ads" — use
create_rulewith conditions like CPA > threshold - "Manage my product catalog for dynamic ads" — use
create_catalog,create_feed, andupload_feedto set up dynamic product ads
Installation
{
"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_TOKEN |
Yes | Meta Marketing API access token |
META_AD_ACCOUNT_ID |
Yes | Ad account ID (numeric, without act_ prefix) |
META_APP_ID |
Optional | App ID — required for token exchange/debug |
META_APP_SECRET |
Optional | App secret — required for token exchange/debug |
META_BUSINESS_ID |
Optional | Business Manager ID — required for business tools |
META_PIXEL_ID |
Optional | Pixel ID — required for conversion tools |
Tools (123)
Campaign Management (22)
| Tool | Description |
|---|---|
list_campaigns |
List campaigns with filtering and pagination |
get_campaign |
Get campaign details by ID |
create_campaign |
Create a new campaign |
update_campaign |
Update campaign settings |
delete_campaign |
Delete a campaign |
get_campaign_adsets |
List ad sets within a campaign |
get_campaign_ads |
List ads within a campaign |
get_campaign_leads |
Get leads from a campaign |
list_adsets |
List ad sets with filtering |
get_adset |
Get ad set details by ID |
create_adset |
Create a new ad set |
update_adset |
Update ad set settings |
delete_adset |
Delete an ad set |
get_adset_ads |
List ads within an ad set |
get_adset_leads |
Get leads from an ad set |
list_ads |
List ads with filtering |
get_ad |
Get ad details by ID |
create_ad |
Create a new ad |
update_ad |
Update ad settings |
delete_ad |
Delete an ad |
get_ad_preview |
Generate ad preview HTML |
get_delivery_estimate |
Get delivery estimate for an ad |
Creatives (5)
| Tool | Description |
|---|---|
list_creatives |
List ad creatives |
get_creative |
Get creative details |
create_creative |
Create a new ad creative |
update_creative |
Update an ad creative |
create_dynamic_creative |
Create a dynamic creative |
Media Assets (12)
| Tool | Description |
|---|---|
list_images |
List ad images |
upload_image |
Upload an image from URL |
get_image |
Get image details |
delete_image |
Delete an image |
list_videos |
List ad videos |
upload_video |
Upload a video from URL |
get_video |
Get video details |
delete_video |
Delete a video |
list_canvases |
List Instant Experience canvases |
get_canvas |
Get canvas details |
create_canvas |
Create a canvas |
delete_canvas |
Delete a canvas |
Audiences & Targeting (15)
| Tool | Description |
|---|---|
list_custom_audiences |
List custom audiences |
get_audience |
Get audience details |
create_custom_audience |
Create a custom audience |
update_audience |
Update audience settings |
delete_audience |
Delete an audience |
Tools (44)
list_campaignsList campaigns with filtering and paginationget_campaignGet campaign details by IDcreate_campaignCreate a new campaignupdate_campaignUpdate campaign settingsdelete_campaignDelete a campaignget_campaign_adsetsList ad sets within a campaignget_campaign_adsList ads within a campaignget_campaign_leadsGet leads from a campaignlist_adsetsList ad sets with filteringget_adsetGet ad set details by IDcreate_adsetCreate a new ad setupdate_adsetUpdate ad set settingsdelete_adsetDelete an ad setget_adset_adsList ads within an ad setget_adset_leadsGet leads from an ad setlist_adsList ads with filteringget_adGet ad details by IDcreate_adCreate a new adupdate_adUpdate ad settingsdelete_adDelete an adget_ad_previewGenerate ad preview HTMLget_delivery_estimateGet delivery estimate for an adlist_creativesList ad creativesget_creativeGet creative detailscreate_creativeCreate a new ad creativeupdate_creativeUpdate an ad creativecreate_dynamic_creativeCreate a dynamic creativelist_imagesList ad imagesupload_imageUpload an image from URLget_imageGet image detailsdelete_imageDelete an imagelist_videosList ad videosupload_videoUpload a video from URLget_videoGet video detailsdelete_videoDelete a videolist_canvasesList Instant Experience canvasesget_canvasGet canvas detailscreate_canvasCreate a canvasdelete_canvasDelete a canvaslist_custom_audiencesList custom audiencesget_audienceGet audience detailscreate_custom_audienceCreate a custom audienceupdate_audienceUpdate audience settingsdelete_audienceDelete an audienceEnvironment Variables
META_ADS_ACCESS_TOKENrequiredMeta Marketing API access tokenMETA_AD_ACCOUNT_IDrequiredAd account ID (numeric, without act_ prefix)META_APP_IDApp ID — required for token exchange/debugMETA_APP_SECRETApp secret — required for token exchange/debugMETA_BUSINESS_IDBusiness Manager ID — required for business toolsMETA_PIXEL_IDPixel ID — required for conversion toolsConfiguration
{"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"}}}}