Meta Ads
📇 ☁️ - MCP server for Meta Marketing API v25.0 — 123 tools for Facebook & Instagram ad camp
What is Meta Ads?
Meta Ads is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 📇 ☁️ - mcp server for meta marketing api v25.0 — 123 tools for facebook & instagram ad camp
📇 ☁️ - MCP server for Meta Marketing API v25.0 — 123 tools for Facebook & Instagram ad camp
This server falls under the Marketing & SEO category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP protocol support
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @mikusnuz/meta-ads-mcpManual Installation
npx -y @mikusnuz/meta-ads-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Meta Ads
The Meta Ads MCP server exposes 135 tools covering the Meta Marketing API v25.0, giving AI assistants full programmatic control over Facebook and Instagram advertising campaigns. It handles the complete ad lifecycle — campaign creation, ad set targeting, creative uploads, audience building, A/B experiments, budget optimization, and performance reporting — all through natural language. Marketing teams, performance marketers, and developers who manage Meta ad accounts will be able to query spend, pause underperformers, launch new campaigns, and generate reports without leaving their AI client.
Prerequisites
- A Meta (Facebook) Business account with an active ad account
- A Meta Marketing API access token with ads_management and ads_read permissions
- Your numeric ad account ID (found in Meta Business Manager under Account Info — the number without the 'act_' prefix)
- Node.js 18+ installed (the server runs via npx)
- An MCP-compatible client such as Claude Desktop or Cursor
Create a Meta app and generate an access token
Go to developers.facebook.com, create an app of type 'Business', add the Marketing API product, and generate a System User access token with ads_management and ads_read permissions from Meta Business Manager > System Users.
Find your ad account ID
In Meta Business Manager, go to Business Settings > Ad Accounts. The numeric ID shown (e.g. 123456789) is your META_AD_ACCOUNT_ID. Do not include the 'act_' prefix.
Configure your MCP client
Add the server to your Claude Desktop or Cursor config. The server is published on npm as @mikusnuz/meta-ads-mcp and can be launched directly with npx. Only META_ADS_ACCESS_TOKEN and META_AD_ACCOUNT_ID are required; the optional variables unlock business management and pixel tools.
{
"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"
}
}
}
}Restart your client and verify the connection
Restart Claude Desktop. Ask the AI to show your current ad account overview or list active campaigns. A successful response confirms the token and account ID are correct.
Explore campaign management and reporting
Use natural language to create campaigns, inspect ad set targeting, pull performance insights, pause low-ROAS campaigns, or set up lookalike audiences. The server's 135 tools cover the full Meta Marketing API surface.
Meta Ads Examples
Client configuration
Complete Claude Desktop config for the Meta Ads MCP server with required and optional environment variables.
{
"mcpServers": {
"meta-ads": {
"command": "npx",
"args": ["-y", "@mikusnuz/meta-ads-mcp"],
"env": {
"META_ADS_ACCESS_TOKEN": "EAABsbCS...",
"META_AD_ACCOUNT_ID": "123456789",
"META_APP_ID": "987654321",
"META_APP_SECRET": "abc123secret",
"META_BUSINESS_ID": "111222333",
"META_PIXEL_ID": "444555666"
}
}
}
}Prompts to try
Example prompts covering campaign management, performance analysis, audience building, and creative tasks.
- "Show me today's ad spend and ROAS across all active campaigns"
- "Pause all ad sets with a ROAS below 1.5 in the last 7 days"
- "Create a new campaign targeting US women aged 25-45 interested in fitness with a $50/day budget"
- "Generate a 30-day performance report for campaign ID 987654 broken down by age group"
- "Build a lookalike audience from my existing customer list for the US market"
- "Set up an A/B test between two ad creatives for my summer sale campaign"Troubleshooting Meta Ads
Error 190: Access token has expired or is invalid
System User tokens do not expire but can be revoked. Regular user tokens expire after 60 days. Regenerate a long-lived system user token in Meta Business Manager > System Users > Generate New Token, then update META_ADS_ACCESS_TOKEN in your config.
Error 100: Ad account not found or permission denied
Ensure META_AD_ACCOUNT_ID contains only the numeric ID without the 'act_' prefix (e.g. '123456789' not 'act_123456789'). Also verify the system user has been granted access to the ad account in Business Manager > Ad Accounts > Add People.
Business management tools return permission errors
Tools that manage business assets or pixels require META_BUSINESS_ID and META_PIXEL_ID to be set, and the access token must have business_management permission in addition to ads_management. Add these optional env vars and ensure the token's permissions include business_management.
Frequently Asked Questions about Meta Ads
What is Meta Ads?
Meta Ads is a Model Context Protocol (MCP) server that 📇 ☁️ - mcp server for meta marketing api v25.0 — 123 tools for facebook & instagram ad camp It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Meta Ads?
Install via npm with the command: npx -y @mikusnuz/meta-ads-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Meta Ads?
Meta Ads works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Meta Ads free to use?
Yes, Meta Ads is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Meta Ads Alternatives — Similar Marketing & SEO Servers
Looking for alternatives to Meta Ads? Here are other popular marketing & seo servers you can use with Claude, Cursor, and VS Code.
TopRank
★ 2.6kGoogle Ads analysis and operations — read performance, manage keywords, bids, and campaigns.
Open SEO
★ 2.1kOpen source alternative to Semrush and Ahrefs
ASO Skills
★ 1.4kAI agent skills for App Store Optimization (ASO) and app marketing. Built for indie developers, app marketers, and growth teams who want Cursor, Claude Code, or any Agent Skills-compatible AI assistant to help with keyword research, metadata optimiza
Google Meta Ads GA4
★ 994MCP server for Google Ads, Meta Ads & GA4 — works with ChatGPT, Claude, Cursor, n8n, Windsurf & more. 250+ tools for campaign management, analytics & optimization.
Meta Ads
★ 923A Model Context Protocol server that allows AI models to access, analyze, and manage Meta advertising campaigns, enabling LLMs to retrieve performance data, visualize ad creatives, and provide strategic insights for Facebook and Instagram platforms.
Google Search Console
★ 882Connects Google Search Console with Claude AI to enable SEO professionals to analyze their SEO data through natural language conversations, providing access to property information, search analytics, URL inspection, and sitemap management.
Browse More Marketing & SEO MCP Servers
Explore all marketing & seo servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Meta Ads in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Meta Ads?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.