meta-ads-mcp

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

{
  "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 (135)

Campaign Management (25)

| 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 | | copy_campaign | Copy an existing campaign with ad sets and ads | | 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 | | copy_adset | Copy an existing ad set to same or different campaign | | get_adset_targeting_sentence | Get human-readable targeting description | | 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 | | copy_ad | Copy an existing ad to same or different ad set | | get_ad_preview | Generate ad preview HTML | | get_delivery_estimate | Get delivery estimate for an ad |

Creatives (6)

| 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 | | generate_preview | Generate ad preview from creative spec without an existing ad |

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 (16)

| 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 | | add_users_to_audience | Add users to a custom audience | | remove_users_from_audience | Remove users from a custom audience | | create_lookalike_audience | Create a lookalike audience | | get_audience_health | Get audience health, delivery status, and match rate | | list_saved_audiences | List saved audiences | | get_saved_audience | Get saved audience details | | search_targeting | Search targeting interests, behaviors, demographics | | search_locations | Search targetable locations | | search_targeting_map | Browse targeting category tree | | get_reach_estimate | Estimate audience reach for targeting spec | | get_targeting_suggestions | Get related targeting suggestions |

Insights & Reporting (6)

| Tool | Description | |---|---| | get_account_insights | Account-level performance metrics | | get_campaign_insights | Campaign-level performance metrics | | get_adset_insights | Ad set-level performance metrics | | get_ad_insights | Ad-level performance metrics | | create_async_report | Create an async insights report | | get_async_report | Poll async report status and results |

Leads (5)

| Tool | Description | |---|---| | get_form_leads | Get leads from a lead form | | get_lead | Get a single lead by ID | | create_lead_form | Create a new lead generation form on a page | | list_lead_forms | List lead gen forms for a page | | get_lead_form | Get lead form details |

Catalog & Commerce (17)

| Tool | Description | |---|---| | list_catalogs | List product catalogs | | get_catalog | Get catalog details | | create_catalog | Create a product catalog | | update_catalog | Update a catalog | | list_product_sets | List product sets in a catalog | | create_product_set | Create a product set | | get_product_set | Get product set details | | update_product_set | Update a product set | | list_products | List products in a catalog | | get_product | Get product details | | update_product | Update a product | | list_feeds | List data feeds for a catalog | | create_feed | Create a data feed | | upload_feed | Upload data to a feed | | get_feed_uploads | Get feed upload history | | batch_products | Batch create, update, or delete products (up to 5,000/request) | | get_batch_status | Check status of a catalog batch operation |

Automation & Rules (5)

| Tool | Description | |---|---| | list_rules | List automated rules | | get_rule | Get rule details | | create_rule | Create an automated rule | | update_rule | Update a rule | | delete_rule | Delete a rule |

Experiments (5)

| Tool | Description | |---|---| | list_experiments | List A/B test experiments | | create_experiment | Create an experiment | | get_experiment | Get experiment details | | update_experiment | Update an experiment | | get_experiment_results | Get experiment results |

Conversions (4)

| Tool | Description | |---|---| | send_conversion_event | Send server-side conversion event via Conversions API | | send_offline_event | Send an offline conversion event | | list_offline_event_sets | List offline event sets | | create_offline_event_set | Create an offline event set |

Budget & Planning (8)

| Tool | Description | |---|---| | list_budget_schedules | List budget schedules | | create_budget_schedule | Create a budget schedule | | update_budget_schedule | Update a budget schedule | | delete_budget_schedule | Delete a budget schedule | | list_rf_predictions | List Reach & Frequency predictions | | create_rf_prediction | Create a Reach & Frequency prediction | | get_rf_prediction | Get prediction details | | delete_rf_prediction | Delete a prediction |

Brand Safety (5)

| Tool | Description | |---|---| | list_block_lists | List publisher block lists | | create_block_list | Create a block list | | add_to_block_list | Add URLs/domains to a block list | | remove_from_block_list | Remove entries from a block list | | delete_block_list | Delete a block list |

Account & Business (15)

| Tool | Description | |---|---| | get_ad_account | Get ad account details | | list_ad_accounts | List ad accounts for a business | | update_ad_account | Update ad account settings | | get_account_activities | Get account activity log | | list_account_users | List users with access to the account | | list_businesses | List businesses you have access to | | get_business | Get business details | | list_business_ad_accounts | List ad accounts in a business | | list_business_users | List users in a business | | add_business_user | Add a user to a business | | remove_business_user | Remove a user from a business | | list_business_pages | List Facebook Pages owned by a business | | list_business_instagram_accounts | List Instagram accounts owned by a business | | list_system_users | List system users for a business | | create_system_user | Create a system user |

Auth & Token (3)

| Tool | Description | |---|---| | exchange_token | Exchange short-lived token for long-lived token | | refresh_token | Refresh a long-lived token | | debug_token | Debug/inspect token metadata |

Ad Library (1)

| Tool | Description | |---|---| | search_ad_library | Search Meta Ad Library for public ad data |

Resources (3)

| URI | Description | |---|---| | ads://account | Ad account overview — status, balance, currency, timezone, and total spend | | ads://campaigns-overview | All active campaigns with budget information | | ads://spending-today | Today's spending summary — spend, impressions, clicks, and reach |

Prompts (3)

| Prompt | Description | |---|---| | campaign_wizard | Step-by-step guide to create a full ad campaign from scratch | | performance_report | Analyze ad performance with detailed breakdowns and recommendations | | audience_builder | Build 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_management | All campaign, ad set, ad, and creative CRUD operations | | ads_read | All read/list operations and insights | | business_management | Business tools, system users, account assignments | | leads_retrieval | Lead form and lead data tools | | catalog_management | Catalog, product set, product, and feed tools | | pages_read_engagement | Lead forms linked to pages |

License

MIT