AdOps MCP

AI-powered cross-platform ad management for the Model Context Protocol

Manage Google Ads and Meta Ads campaigns, analyze cross-platform performance, optimize budgets, and detect anomalies — all through AI assistants like Claude, Cursor, and VS Code.

---

Features

• Unified campaign management for Google Ads and Meta Ads
• 14 MCP tools covering the full advertising lifecycle
• 4 MCP resources for quick dashboard access
• Cross-platform performance reporting with normalized metrics
• AI-powered budget optimization with actionable recommendations
• Statistical anomaly detection (CPC spikes, CTR drops, spend surges)
• A/B test analysis with confidence scoring
• Industry benchmark comparison (9 verticals)
• Spend and conversion forecasting (7/14/30 days)
• Platform-specific creative specs reference
• 42 automated tests (unit + E2E user workflows), TypeScript strict mode, Zod validation

---

Quick Start

Install from npm

npm i adops-mcp-server

Add to your MCP client

{
  "mcpServers": {
    "adops": {
      "command": "node",
      "args": ["path/to/node_modules/adops-mcp-server/dist/index.js"]
    }
  }
}

Build from source

git clone https://github.com/enzoemir1/adops-mcp.git
cd adops-mcp
npm ci && npm run build

---

Tools

Tool	Description
platform_connect	Register a Google Ads or Meta Ads account connection
campaign_list	List and filter campaigns across all connected platforms
campaign_create	Create a new campaign with unified parameters
campaign_update	Update campaign settings (budget, status, bidding, schedule)
campaign_pause_resume	Batch pause or resume up to 50 campaigns at once
ads_report	Generate unified cross-platform performance report
budget_analyze	Analyze budget allocation with optimization recommendations
budget_reallocate	Transfer budget between campaigns across platforms
audience_insights	Get demographic, geographic, and device breakdowns
creative_specs	Get platform-specific image, video, and text requirements
anomaly_detect	Detect performance anomalies with configurable sensitivity
ab_test_analyze	Compare two campaigns with statistical significance testing
competitor_benchmark	Compare your metrics against industry averages
forecast_spend	Forecast spend, conversions, and ROAS for the next period

---

Resources

Resource	Description
ads://overview	Cross-platform dashboard summary
ads://campaigns	All active campaigns with key metrics
ads://budget	Budget allocation across platforms
ads://alerts	Recent performance anomalies and warnings

---

Configuration

All integrations are optional. The server works without API keys using local storage for campaign management and analytics.

Variable	Platform	Required	Description
GOOGLE_ADS_DEVELOPER_TOKEN	Google	For live sync	API developer token
GOOGLE_ADS_CLIENT_ID	Google	For live sync	OAuth2 client ID
GOOGLE_ADS_CLIENT_SECRET	Google	For live sync	OAuth2 client secret
GOOGLE_ADS_REFRESH_TOKEN	Google	For live sync	OAuth2 refresh token
GOOGLE_ADS_CUSTOMER_ID	Google	For live sync	Ad account ID (10 digits)
META_APP_ID	Meta	For live sync	Facebook App ID
META_APP_SECRET	Meta	For live sync	Facebook App Secret
META_ACCESS_TOKEN	Meta	For live sync	System user access token
META_AD_ACCOUNT_ID	Meta	For live sync	Ad account ID (act_XXX)

See .env.example for a compl

... View full README on GitHub