Meta Ads MCP: Facebook and Instagram ads
Mikusnuz Meta Ads MCP
An MCP server for the Meta Marketing API v26: 134 tools for Facebook and Instagram ad campaigns, audiences, creatives and reports
- 94 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The token opens the ad account: the agent can create, change and delete campaigns and spend real budget
- The tools handle audiences, leads and customer data
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/mikusnuz-meta-ads-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The token opens the ad account: the agent can create, change and delete campaigns and spend real budget
- The tools handle audiences, leads and customer data
This is third-party code. Review the repository files before installing.
What it does
meta-ads-mcp gives an agent access to the Meta Marketing API: 134 tools for managing Facebook and Instagram ads. They are grouped by task: campaigns (25), creatives, media assets, audiences and targeting, insights reports, leads, catalogs and product feeds, automation rules, experiments, conversions, budget and planning, brand safety, account and business data, tokens, plus an ad library search. With them an agent can build a funnel from `create_campaign`, `create_adset`, `create_creative` and `create_ad`, pull numbers with `get_account_insights`, pause campaigns with ROAS below a threshold, set up an A/B test with `create_experiment` or create a lookalike audience from a customer list. Large reports use `create_async_report` and `get_async_report`. In version 1.6 `create_adset` and `update_adset` accept `validate_only`, which asks Meta to check the request without writing. The server starts with `npx -y @mikusnuz/meta-ads-mcp`, and an access token and an ad account ID are required. Token exchange, business tools and conversions also need an app ID and secret, a Business Manager ID and a pixel.
Who it is for. Marketers and business owners with a Meta ad account who ask Claude Code to build a campaign, check performance or pause weak ads.
Good fit when
- You want to build a full funnel: campaign, ad set, creative and the ad itself
- You need today's results for an account or campaign
- You want to pause campaigns with ROAS below two
- You prepare an A/B test of two creatives
- You need a 30-day report, which asynchronous reports handle
Not a fit when
- You need one summary without write rights: the server can change and delete campaigns, so create a token with minimal rights for reading
- A person decides the budget: the agent can change bids and spending limits
- You work with Google Ads, TikTok or another account: the server covers Meta only
Example request
Show today's ad account results, find campaigns with ROAS below 2 and suggest which to pause. Change nothing without my confirmation.MCP
- Transport
- stdio
- Authentication
- API key
Environment variables
META_ADS_ACCESS_TOKENrequired, secret- Meta Marketing API access token
META_AD_ACCOUNT_IDrequired- Numeric ad account ID without the act_ prefix
META_APP_ID- App ID for token exchange and extension
META_APP_SECRETsecret- App secret for token exchange and extension
META_BUSINESS_ID- Business Manager ID for business tools
META_PIXEL_ID- Pixel ID for conversion tools
Limitations
Node.js 20 or later, a Meta access token and an ad account are required. The tools really write: creating audiences and ads is not a dry run unless `validate_only` is set where supported. For ads targeting the EU, version 1.6 needs `dsa_beneficiary` and `dsa_payor` or account defaults. Some detailed report breakdowns need an Ads Manager opt-in, and an empty response does not always mean zero results. Ads spend real money, so start with a token limited to one account.
How to disable. Remove the `meta-ads` entry from the MCP configuration and revoke the token in Meta. Without revoking, the token keeps working for anyone who obtained it.
FAQ
Which variables are required?
The access token `META_ADS_ACCESS_TOKEN` and the numeric ad account ID `META_AD_ACCOUNT_ID` without the `act_` prefix. The others (`META_APP_ID`, `META_APP_SECRET`, `META_BUSINESS_ID`, `META_PIXEL_ID`) serve specific tool groups.
Can the agent spend my budget?
Yes. The tools create and update campaigns, ad sets and ads, and ads spend money. Use a token with limited rights and ask the agent to show a plan before writing.
Is there a trial mode?
`create_adset` and `update_adset` accept `validate_only: true`, which asks Meta to check the request without executing it. Audience creation has no trial mode and is a real write.
Can I look at competitor ads?
The `search_ad_library` tool searches public data in the Meta ad library.
What about ads for the EU?
Since version 1.6, EU targeting needs `dsa_beneficiary` and `dsa_payor` values or an account default. The payer is not filled in automatically.
Discussion
No questions or reviews yet.
Related
MCP serversMCP server for Facebook and Instagram ads: campaigns, creatives, budgets and analytics through a conversation with the agent
An MCP server that searches brands' public ads in the Facebook Ads Library and analyzes their images and videos
The official remote MCP server of Metricool: the agent publishes posts, reads social analytics and runs ad campaigns
Instagram MCP
instagram-mcp
An MCP server for the Instagram Graph API: the agent publishes posts, carousels and reels, replies to comments and reads business account analytics
A VK Ads MCP server with a turnkey installer: 136 tools, VK community research and a skill for several agents at once
VK Ads MCP server
VK Реклама MCP
An MCP server for VK Ads: campaigns, groups, banners, statistics and balance through chat, with in-chat account connection instead of manual OAuth
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Meta Ads MCP: Facebook and Instagram ads (this card) | no | API key | 94 | |
| Meta Ads MCP | yes | OAuth | 1,367 | another Meta Ads server with a different tool set |
| Facebook Ads MCP Server | yes | API key | 370 | a Facebook Ads server with a different tool set |
| Facebook Ads Library MCP | no | API key | 327 | ad library search only, no campaign management |
README in short
The README opens with example tasks and hints about which tools to call, then briefly describes what is new in versions 1.5 and 1.6. Installation, a table of environment variables and a catalog of 134 tools in 15 groups with descriptions follow.