Submit
enzoemir1

AdOps MCP

Community enzoemir1
Updated

AI-powered cross-platform ad management MCP server for Google Ads & Meta Ads

AdOps MCP

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

License: MITTypeScriptMCP

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.

MCP Server · Populars

MCP Server · New