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

1. Open Claude.ai → Settings → Connectors → Add custom connector
2. Enter https://backend.muzecmo.com/mcp
3. Paste your mz_live_ key when prompted
4. 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