How do I install Meta Ads?

Meta Ads is a local plugin. Install it using npm package: @mikusnuz/meta-ads-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Meta Ads safe to use?

Yes. Meta Ads passed MCP Marketplace's automated security scan with a score of 10/10 (low risk). Every server on MCP Marketplace is security-scanned before it's listed; see the full security report on this page for the findings and permissions.

What credentials does Meta Ads need?

Meta Ads requires the following credentials or environment variables: META_ADS_ACCESS_TOKEN, META_AD_ACCOUNT_ID, META_APP_ID, META_APP_SECRET, META_BUSINESS_ID, META_PIXEL_ID. You can find setup instructions on the server detail page.

What AI apps work with Meta Ads?

Meta Ads uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Meta Ads MCP Server

by Mikusnuz

Marketing & SocialLow Risk10.0MCP RegistryLocal

Free

Server data from the Official MCP Registry

MCP server for Meta Marketing API — Facebook & Instagram ad campaign management

About

MCP server for Meta Marketing API — Facebook & Instagram ad campaign management

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (4 strong, 4 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (13/13 approved).

5 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

What You'll Need

Set these up before or after installing:

Meta Marketing API access tokenRequired

Environment variable: META_ADS_ACCESS_TOKEN

Meta Ad Account ID (e.g. act_123456)Optional

Environment variable: META_AD_ACCOUNT_ID

Meta App IDOptional

Environment variable: META_APP_ID

Meta App SecretRequired

Environment variable: META_APP_SECRET

Meta Business Manager IDOptional

Environment variable: META_BUSINESS_ID

Meta Pixel IDOptional

Environment variable: META_PIXEL_ID

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-mikusnuz-meta-ads": {
      "env": {
        "META_APP_ID": "your-meta-app-id-here",
        "META_PIXEL_ID": "your-meta-pixel-id-here",
        "META_APP_SECRET": "your-meta-app-secret-here",
        "META_BUSINESS_ID": "your-meta-business-id-here",
        "META_AD_ACCOUNT_ID": "your-meta-ad-account-id-here",
        "META_ADS_ACCESS_TOKEN": "your-meta-ads-access-token-here"
      },
      "args": [
        "-y",
        "@mikusnuz/meta-ads-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

Reviews

No reviews yet

Be the first to review this server!

More Marketing & Social MCP Servers

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.

FinAgent

Free

by mcp-marketplace · Finance

Free stock data and market news for any MCP-compatible AI assistant.

mcp-creator-typescript

Free

by mcp-marketplace · Developer Tools

Scaffold, build, and publish TypeScript MCP servers to npm — conversationally

Meta Ads MCP Server

About

Security Report

Findings (1)

What You'll Need

How to Install

Documentation

meta-ads-mcp

When to Use

Installation

Environment Variables

Tools (135)

Campaign Management (25)

Creatives (6)

Media Assets (12)

Audiences & Targeting (16)

Insights & Reporting (6)

Leads (5)

Catalog & Commerce (17)

Automation & Rules (5)

Experiments (5)

Conversions (4)

Budget & Planning (8)

Brand Safety (5)

Account & Business (15)

Auth & Token (3)

Ad Library (1)

Resources (3)

Prompts (3)

Permissions Required

License

Reviews

No reviews yet

More Marketing & Social MCP Servers

Toleno

mcp-creator-python

MarkItDown

MCP Marketplace

FinAgent

mcp-creator-typescript