Meta Ads Analyzer
Meta Ads Analyzer skill + MCP server for Claude Code. Breakdown Effect, Learning Phase, and expert-level campaign diagnosis.
What is Meta Ads Analyzer?
Meta Ads Analyzer is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to meta ads analyzer skill + mcp server for claude code. breakdown effect, learning phase, and expert-level campaign diagnosis.
Meta Ads Analyzer skill + MCP server for Claude Code. Breakdown Effect, Learning Phase, and expert-level campaign diagnosis.
This server falls under the Marketing & SEO category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Meta Ads Analyzer skill + MCP server for Claude Code. Breakd
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx meta-ads-analyzerConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Meta Ads Analyzer
Meta Ads Analyzer is a Claude Code skill and MCP server that enables expert-level diagnosis of Facebook and Instagram advertising campaigns. It connects to Meta's Marketing API to retrieve live campaign, ad set, and ad performance data, then applies structured frameworks including Breakdown Effect analysis, Learning Phase diagnosis, Auction Overlap detection, and Creative Fatigue identification. It can also work with exported CSV data or screenshots, making it useful for both automated workflows and manual review sessions.
Prerequisites
- Claude Code (claude.ai/code) or another MCP-compatible client installed
- A Meta Developer account with an app configured for Marketing API access
- A long-lived Meta access token (60-day expiration) with ads_read and ads_management permissions
- Meta App ID and App Secret from the Meta Developer console
- Node.js or Bash available to run the token refresh script
Clone the repository
Clone the meta-ads-analyzer repository from GitHub to your local machine.
git clone https://github.com/mathiaschu/meta-ads-analyzer.git
cd meta-ads-analyzerCopy the MCP configuration template
Copy the example MCP configuration file to create your working .mcp.json file, which stores your Meta API credentials.
cp mcp/mcp.json.example .mcp.jsonAdd your Meta API credentials to .mcp.json
Edit .mcp.json and fill in your Meta App ID, App Secret, and long-lived access token. These can be obtained from the Meta Developer console and the access token tool at developers.facebook.com/tools/access_token.
{
"APP_ID": "your_meta_app_id",
"APP_SECRET": "your_meta_app_secret",
"ACCESS_TOKEN": "your_long_lived_access_token"
}Install the skill into Claude Code
Copy the skill files into Claude Code's skills directory so the analyzer is available as a Claude Code skill.
mkdir -p .claude/skills/meta-ads-analyzer
cp -r skill/* .claude/skills/meta-ads-analyzer/Configure token refresh schedule
Meta access tokens expire after 60 days. Set up a reminder or cron job to run the refresh script before expiration to avoid disruption.
bash scripts/refresh_token.shStart analyzing your campaigns
In Claude Code or your MCP client, invoke the Meta Ads Analyzer skill to retrieve campaign data, diagnose issues, and generate structured reports.
Meta Ads Analyzer Examples
Client configuration (Claude Desktop / MCP)
MCP server configuration for Meta Ads Analyzer.
{
"mcpServers": {
"meta-ads-analyzer": {
"command": "npx",
"args": ["meta-ads-analyzer"],
"env": {
"APP_ID": "your_meta_app_id",
"APP_SECRET": "your_meta_app_secret",
"ACCESS_TOKEN": "your_long_lived_access_token"
}
}
}
}Prompts to try
Example prompts that work well once the Meta Ads Analyzer skill is installed.
- "Analyze my campaigns from the last 7 days and identify the top issues"
- "Why is my CPA increasing on the Summer Sale campaign?"
- "Diagnose why this ad set is stuck in Learning Limited"
- "Check for Auction Overlap issues across my active campaigns"
- "Compare performance across Facebook Feed, Reels, and Stories placements"
- "Generate a full analysis report for my Q2 retargeting campaigns"Troubleshooting Meta Ads Analyzer
Access token expired — API calls return authentication errors
Meta long-lived tokens expire after 60 days. Run 'bash scripts/refresh_token.sh' to generate a new token, then update the ACCESS_TOKEN in your .mcp.json file.
Insufficient permissions error when fetching campaign data
Your Meta access token must have the ads_read and ads_management permissions. Regenerate your token from the Meta Developer console and ensure both permissions are granted during the OAuth flow.
Skill not found in Claude Code after installation
Verify the skill files were copied to the correct path: .claude/skills/meta-ads-analyzer/ relative to your project root. Restart Claude Code after copying the skill files.
Frequently Asked Questions about Meta Ads Analyzer
What is Meta Ads Analyzer?
Meta Ads Analyzer is a Model Context Protocol (MCP) server that meta ads analyzer skill + mcp server for claude code. breakdown effect, learning phase, and expert-level campaign diagnosis. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Meta Ads Analyzer?
Follow the installation instructions on the Meta Ads Analyzer GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Meta Ads Analyzer?
Meta Ads Analyzer works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Meta Ads Analyzer free to use?
Yes, Meta Ads Analyzer is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Meta Ads Analyzer Alternatives — Similar Marketing & SEO Servers
Looking for alternatives to Meta Ads Analyzer? 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 Analyzer 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 Analyzer?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.