Meta-ads-analyzer to Marketing section
About
Performance marketing diagnostics MCP server for Meta Ads. 15 tools for spend leak detection, creative fatigue analysis, audience decay monitoring, benchmarking, and custom SQL queries. Read-only SQLite security by default.
Details
- Author
- shibanshu12
- Downloads
- 365
- Categories
- Developer Tools, Marketing
Jump to
- Creative fatigue detection (frequency >3 + declining CTR)
- Audience decay identification (frequency <2 + dropping CVR)
- Spend leaks analysis (>40% budget at <1.5x ROAS)
- Retargeting cannibalization detection
- Placement and device performance breakdowns
- Custom SQL queries and data health checks
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Meta-ads-analyzer to Marketing sectionCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install pip install meta-ads-analyzer, then add the server to your Claude Desktop config with the META_ADS_DB_PATH environment variable pointing to a SQLite database. Optionally pull your own Meta Ads data using the provided pipeline and your API credentials, or test immediately with included sample data.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"meta-ads-analyzer to marketing section": {
"meta-ads-analyzer": {
"command": "uv",
"args": [
"run",
"--with",
"meta-ads-analyzer",
"meta-ads-analyzer"
],
"env": {
"META_ADS_DB_PATH": "/path/to/your/meta_ads_data.db"
}
}
}
}
}McpServers
{
"meta-ads-analyzer": {
"command": "uv",
"args": [
"run",
"--with",
"meta-ads-analyzer",
"meta-ads-analyzer"
],
"env": {
"META_ADS_DB_PATH": "/path/to/your/meta_ads_data.db"
}
}
}📊 Meta Ads Analyzer
> Ask Claude about your ad campaigns the way you'd ask a senior media buyer.
An MCP server that turns your Meta Ads data into a conversational analytics layer. Unlike other Meta Ads MCP tools that wrap the live API, this one stores your historical data locally and lets you query it with natural language.
<!-- 
-->
<!-- Uncomment after recording your demo -->
Why this exists
Ads Manager gives you charts. But try answering:
- "Which creatives are fatigued right now?"
- "Where am I leaking spend below 1.5x ROAS?"
- "Is my audience decaying or is it a creative problem?"
You can't — not without exporting CSVs and building dashboards. This tool gives Claude direct access to your campaign data with built-in marketing intelligence, so you just ask.
Built-in intelligence
| Tool | What it detects |
|------|----------------|
| Creative fatigue | Frequency > 3 + declining CTR = fatigued creative |
| Audience decay | Frequency < 2 + dropping CVR = exhausted audience |
| Spend leaks | >40% budget at <1.5x ROAS = wasted money |
| Retargeting cannibalization | Retargeting > 25% of spend = cannibalizing prospecting |
| Placement optimization | Which placements (Feed, Stories, Reels) deliver best ROI |
| Hourly patterns | Best/worst hours for your campaigns |
Plus: campaign rankings, daily trends, demographic breakdowns, country-level ROI, device performance, and custom SQL.
Requirements
- Python 3.10+ on your machine
- Claude Pro or Max subscription — MCP servers only work with Claude Desktop, Claude Code, or Claude.ai (not ChatGPT, Gemini, or free Claude)
- Meta Ads account — to pull your own data (or try with included sample data, no account needed)
Works with any MCP-compatible client: Claude Desktop (Mac/Windows), Claude Code (terminal), Claude.ai (web), Cursor, Windsurf.
Quick start
Install
pip install meta-ads-analyzer
Add to Claude Desktop
Open your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json) and add:
{
"mcpServers": {
"meta-ads-analyzer": {
"command": "python3",
"args": ["-m", "meta_ads_analyzer"],
"env": {
"META_ADS_DB_PATH": "~/meta_ads_data.db"
}
}
}
}
Restart Claude Desktop. Done.
Try with sample data (no Meta account needed)
git clone https://github.com/shibanshu12/meta-ads-analyzer.git
cd meta-ads-analyzer
pip install .
META_ADS_DB_PATH=./examples/sample_data.db python -m meta_ads_analyzer
Use with your own Meta Ads data
Step 1: Get your Meta API credentials
1. Go to Meta for Developers → create an app
2. Open Tools → Graph API Explorer
3. Generate an access token with ads_read permission
4. Find your ad account ID in Ads Manager URL — looks like act_123456789
Step 2: Pull your data
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
