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 complete template.

---

Unified Metrics

AdOps normalizes metrics across platforms into a single schema:

Metric	Formula	Description
CTR	clicks / impressions x 100	Click-through rate (%)
CPC	spend / clicks	Cost per click
CPM	spend / impressions x 1000	Cost per 1000 impressions
ROAS	revenue / spend	Return on ad spend
CPA	spend / conversions	Cost per acquisition
Conversion Rate	conversions / clicks x 100	Conversion rate (%)

Platform field mapping:

AdOps Field	Google Ads	Meta Ads
spend	cost_micros / 1,000,000	amount_spent
impressions	impressions	impressions
clicks	clicks	clicks
conversions	conversions	actions[type=purchase]
Campaign > Ad Group	Ad Group	Ad Set

---

Pricing

Tier	Price	Features
Free	$0	1 platform, read-only reports, creative specs, 50 calls/day
Pro	$29/mo	2 platforms, full CRUD, anomaly detection, budget optimization
Agency	$59/mo	Unlimited, forecasting, benchmarking, priority support

Available on MCPize.

---

Development

npm run dev        # Hot reload development
npm run build      # Production build
npm test           # Run 42 tests (unit + E2E)
npm run inspect    # Open MCP Inspector

---

Testing

42 tests across 5 test suites:

• Storage: Connection CRUD, campaign search, metrics aggregation, batch inserts
• Analytics: Metric calculations, performance reports, forecasting, benchmarks
• Optimizer: Budget analysis, reallocation, scaling/pausing recommendations
• Anomaly: CPC spike detection, conversion drops, sensitivity levels, severity sorting
• E2E Workflow: 14 real user scenarios — connect platforms, create campaigns, generate reports, optimize budgets, run A/B tests, detect anomalies, forecast spend, benchmark vs industry

npm test

---

License

MIT License. See LICENSE for details.

Built by Automatia BCN.