muze-mcp
Provides Meta and Google Ads intelligence for AI assistants, enabling users to analyze performance, track competitors, and manage ad campaigns through natural language. It features 17 tools for generating creative concepts, scraping competitor ads, and performing deep account-level analysis.
Ask AI about muze-mcp
Powered by Claude Β· Grounded in docs
I know everything about muze-mcp. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
muze-mcp
Muze CMO MCP server β Meta and Google Ads intelligence for Claude and other AI assistants.
17 tools: analyze ad performance, generate creative concepts, track competitors, and manage ads β all from chat.
Installation
pip install muze-mcp
Get your API key at app.muzecmo.com/settings/api-keys.
Claude Desktop setup
Add to ~/.claude.json:
{
"mcpServers": {
"muze-cmo": {
"command": "muze-mcp",
"env": {
"MUZE_API_KEY": "mz_live_YOUR_KEY_HERE"
}
}
}
}
Restart Claude Desktop β all 17 tools appear immediately.
Claude.ai Custom Connector
- Open Claude.ai β Settings β Connectors β Add custom connector
- Enter
https://backend.muzecmo.com/mcp - Paste your
mz_live_key when prompted - Done
Available tools
| Tool | What it does |
|---|---|
get_my_accounts | Resolve Meta account ID and Google customer ID (call first) |
get_meta_performance | Meta Ads spend, CTR, ROAS, conversions |
get_google_performance | Google Ads spend, CTR, ROAS, conversions |
list_campaigns | List campaigns with IDs and budget |
analyze_campaign_ads | AI analysis of all ads in a campaign |
analyze_single_ad | AI analysis of one ad |
get_account_analysis | Fetch stored account-level AI analysis |
analyze_account_ads | Re-run full account AI analysis (confirm required) |
generate_ad_from_url | Generate ad concept from a product URL |
list_products | List products for creative generation |
generate_ad_concepts | Generate concepts for an existing product |
list_competitors | List tracked competitor brands |
get_competitor_ads | View competitor ad library |
scrape_competitor_ads | Start async competitor scrape |
get_scrape_status | Poll scrape job status |
pause_ad | Pause a live Meta ad (confirm required) |
resume_ad | Resume a paused Meta ad (confirm required) |
Environment variables
| Variable | Required | Description |
|---|---|---|
MUZE_API_KEY | Yes | Your mz_live_ API key |
MUZE_BASE_URL | No | Override API URL (default: https://backend.muzecmo.com/api/v1) |
MUZE_DEFAULT_ACCOUNT_ID | No | Skip get_my_accounts if you always use one Meta account |
MUZE_DEFAULT_CUSTOMER_ID | No | Skip get_my_accounts if you always use one Google account |
