Which integrations are available for this server?

Provides unified campaign management for Facebook Ads (as part of Meta Ads), including listing campaigns, creating/updating campaigns, generating performance reports, and accessing Facebook Ads API data through platform connections. Provides unified campaign management for Google Ads, including listing campaigns, creating/updating campaigns, generating performance reports, budget analysis, and accessing Google Ads API data through platform connections. Provides unified campaign management for Meta Ads (Facebook Ads), including listing campaigns, creating/updating campaigns, generating performance reports, budget analysis, and accessing Meta Ads API data through platform connections.

AdOps MCP

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

License: MIT TypeScript MCP

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.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

Need Help?

Related Servers

adops-mcp

AdOps MCP

Features

Quick Start

Install from npm

Add to your MCP client

Build from source

Tools

Resources

Configuration

Unified Metrics

Pricing

Development

Testing

License

Resources

Latest Blog Posts

MCP directory API