📦

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.

0 installs

Trust: 34 — Low

Scraping

Ask AI about muze-mcp

I know everything about muze-mcp. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

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