MCP Server

Active

MIT

io.github.mikusnuz/meta-ads MCP Server

io.github.mikusnuz/meta-ads

135 tools for Facebook & Instagram ad campaign management via Meta Marketing API v26.0

What is the io.github.mikusnuz/meta-ads MCP server?

The meta-ads MCP server provides 135 tools for managing Facebook and Instagram ad campaigns, audiences, creatives, insights, catalogs, and more through Meta's Marketing API v26.0. It enables AI agents to create and optimize ad campaigns, manage audiences and targeting, upload media assets, track performance, and automate ad operations.

This server gives you programmatic control over Meta ad accounts. Use it to create campaigns and ad sets, manage creatives and media, build and refine audiences, check performance metrics, run A/B tests, manage product catalogs for dynamic ads, set up automation rules, and search the Facebook Ad Library. Essential for anyone automating ad operations or building AI-driven campaign management workflows.

How to install io.github.mikusnuz/meta-ads

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

META_ADS_ACCESS_TOKEN
required
secret
Meta Marketing API access token
META_AD_ACCOUNT_ID
Meta Ad Account ID (e.g. act_123456)
META_APP_ID
Meta App ID
META_APP_SECRET
secret
Meta App Secret
META_BUSINESS_ID
Meta Business Manager ID
META_PIXEL_ID
Meta Pixel ID

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "meta-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/meta-ads-mcp"
      ],
      "env": {
        "META_ADS_ACCESS_TOKEN": "<YOUR_META_ADS_ACCESS_TOKEN>",
        "META_AD_ACCOUNT_ID": "<YOUR_META_AD_ACCOUNT_ID>",
        "META_APP_ID": "<YOUR_META_APP_ID>",
        "META_APP_SECRET": "<YOUR_META_APP_SECRET>",
        "META_BUSINESS_ID": "<YOUR_META_BUSINESS_ID>",
        "META_PIXEL_ID": "<YOUR_META_PIXEL_ID>"
      }
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

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

Use cases

Create and manage full Facebook and Instagram ad campaign funnels from campaign setup through ad delivery
Monitor ad performance in real-time and pause underperforming campaigns based on ROAS or other metrics
Build and refine custom audiences, lookalike audiences, and saved audiences for precise targeting
Run A/B tests between ad creatives and ad sets to optimize campaign performance
Manage product catalogs and data feeds for dynamic product ads and retargeting campaigns
Automate ad operations with rules that pause, adjust budgets, or modify ads based on performance thresholds

io.github.mikusnuz/meta-ads MCP server FAQ

What is the meta-ads MCP server?

It's an MCP server that provides 135 tools for programmatic management of Facebook and Instagram ad campaigns via Meta's Marketing API v26.0. You can create campaigns, manage audiences, upload creatives, track performance, run experiments, and automate ad operations.

Is this server free to use?

The server itself is free (MIT licensed), but you need a Meta Business Account with an active ad account and a valid access token to use it. Meta's advertising services have their own costs.

How do I install this in Cursor or Claude?

Add it to your MCP configuration with: `npx -y @mikusnuz/meta-ads-mcp`. You'll need to set environment variables for META_ADS_ACCESS_TOKEN and META_AD_ACCOUNT_ID at minimum.

What authentication is required?

You need a Meta Marketing API access token (META_ADS_ACCESS_TOKEN) and your ad account ID (META_AD_ACCOUNT_ID). Optional: APP_ID, APP_SECRET, BUSINESS_ID, and PIXEL_ID for specific features.

What permissions does my access token need?

Depends on what you use: ads_management (campaign/ad CRUD), ads_read (read/insights), business_management (business tools), leads_retrieval (lead forms), catalog_management (product catalogs), and pages_read_engagement (lead forms on pages).

Can I manage multiple ad accounts?

The server is configured for one ad account per instance via META_AD_ACCOUNT_ID. To manage multiple accounts, you'd need separate MCP server instances with different tokens and account IDs.

README (reference)

Source of truth, from the repository.

meta-ads-mcp

MCP server for the Meta Marketing API v26.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 set

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 a URL or local file
`get_image`	Get image details
`delete_image`	Delete an image
`list_videos`	List ad videos
`upload_video`	Upload a video from a URL or local file
`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

Related MCP servers

io.github.mikusnuz/npm

Maintained

MCP server for npm package management — publish, version, search, audit, and more

JavaScript

MIT

View repository →

io.github.mikusnuz/pexbot-mcp

Maintained

PexBot simulated spot/futures trading, competitions, portfolios, and AI analytics.

JavaScript

MIT

View repository →

io.github.mikusnuz/umami

Maintained

MCP server for Umami Analytics API v2 — websites, stats, events, reports, and realtime

TypeScript

MIT

View repository →

io.github.mikusnuz/app-publish

Active

Unified MCP server for App Store Connect and Google Play Console — manage iOS and Android app releases, metadata, and reviews from Claude.

TypeScript

MIT

View repository →

Mila

Create and manage documents, spreadsheets, and presentations from your AI assistant.

View repository →

Velog

Claude 나 Codex 에서 벨로그(velog.io) 글을 읽고 쓰고 백업한다. 다이어그램과 시퀀스도 그린다. 공개 발행은 사람이 켤 때만 열린다.

View repository →