Server data from the Official MCP Registry
CSV-first analytics for Google Ads + Meta Ads: reporting, anomaly detection, budget optimization.
CSV-first analytics for Google Ads + Meta Ads: reporting, anomaly detection, budget optimization.
Valid MCP server (2 strong, 2 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (4/4 approved).
3 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-enzoemir1-adops-mcp": {
"args": [
"-y",
"adops-mcp-server"
],
"command": "npx"
}
}
}From the project's GitHub README.
CSV-first analytics & optimization for Google Ads + Meta Ads — inside Claude, Cursor, and any MCP client.
Export a CSV from Google Ads or Meta Ads Manager → import into AdOps → ask your AI assistant anything about your campaigns.
No OAuth. No developer tokens. No API approval queues. Your data stays on your machine.
Google Ads API and Meta Marketing API are powerful but gated: developer token approval takes days, Meta app review takes weeks, OAuth flows are fragile. For most advertisers those barriers never clear.
AdOps takes a different path. Every ad platform's dashboard already has a Download / Export button that produces a CSV of exactly what you care about: campaign performance, day-segmented metrics, spend, conversions, ROAS. AdOps reads that CSV and runs the same analysis you'd get from a $200/mo optimization suite — anomaly detection, budget allocation, A/B significance, forecasting, industry benchmarks — directly inside your AI assistant.
You stay in control of your data. You don't hand credentials to a third party. You don't wait 3 weeks for a review.
UnifiedCampaign / UnifiedMetrics modelnpm i adops-mcp-server
Add to your MCP client (Claude Desktop claude_desktop_config.json, Cursor, VS Code, Windsurf):
{
"mcpServers": {
"adops": {
"command": "node",
"args": ["path/to/node_modules/adops-mcp-server/dist/index.js"]
}
}
}
Restart your client. Then, inside Claude:
> Seed demo data so I can explore AdOps
(calls ad_demo_seed)
Or import your real data:
> Import ~/Downloads/google-ads-report.csv as a Google Ads CSV
(calls ad_csv_import with platform=google, csv_path=...)
ad_csv_importad_csv_importBoth exports work out-of-the-box with or without day segmentation. Without a Day column, you get one aggregated metric row per campaign. With Day segmentation, you get daily time-series data — which powers forecasting and anomaly detection properly.
| Tool | Description |
|---|---|
ad_demo_seed | Seed a realistic cross-platform demo portfolio (8 campaigns, 30 days of metrics) to try AdOps before importing real data |
ad_csv_import | Import a Google Ads or Meta Ads CSV export — every other tool operates on this data |
ads_export_recommendations | Export budget_analyze recommendations as Google Ads Editor CSV, Meta Ads Manager CSV, JSON, or Markdown — one bulk-paste and your ad dashboard reflects the AI's plan |
platform_connect | Register a data source connection manually (alternative to CSV import, for scripted workflows) |
campaign_list | List and filter campaigns across all imported platforms |
campaign_create | Add a campaign manually (useful for what-if planning) |
campaign_update | Update campaign settings in local storage (budget, status, bidding, schedule) |
campaign_pause_resume | Batch pause or resume up to 50 campaigns |
ads_report | Generate unified cross-platform performance report |
budget_analyze | Analyze budget allocation, produce scaling/pausing recommendations |
budget_reallocate | Transfer budget between campaigns across platforms |
audience_insights | Demographic / geographic / device breakdowns |
creative_specs | Platform-specific image, video, and text requirements reference |
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 (9 verticals) |
forecast_spend | Forecast spend, conversions, ROAS for the next 7/14/30 days |
| 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 |
AdOps normalizes metrics across platforms:
| Metric | Formula | Notes |
|---|---|---|
| CTR | clicks / impressions × 100 | Click-through rate (%) |
| CPC | spend / clicks | Cost per click |
| CPM | spend / impressions × 1000 | Cost per 1000 impressions |
| ROAS | conversion_value / spend | Return on ad spend |
| CPA | spend / conversions | Cost per acquisition |
| Conversion Rate | conversions / clicks × 100 | % |
CSV column mapping:
| AdOps Field | Google Ads CSV | Meta Ads CSV |
|---|---|---|
spend | Cost (USD equivalent auto-converted if micros) | Amount spent (USD/EUR/...) |
impressions | Impressions | Impressions |
clicks | Clicks | Link clicks |
conversions | Conversions | Results (Purchases/Leads/etc.) |
conversion_value | Conv. value | Purchases conversion value |
reach | — | Reach (Meta-only) |
quality_score | Quality Score (if present) | — (Google-only) |
European locale numbers (125,50 = 125.50) and semicolon-delimited CSVs are auto-detected.
AdOps is stateless from the network's point of view — no API keys, no OAuth. The only configuration is where it persists imported data:
| Variable | Description | Default |
|---|---|---|
ADOPS_DATA_DIR | Directory for JSON persistence | ./data |
All other behavior is controlled via tool arguments.
| Tier | Price | Features |
|---|---|---|
| Free | $0 | 1 imported CSV per day, demo mode, all 17 tools read-only |
| Pro | $24/mo | Unlimited imports, full CRUD, all analytics tools |
| Agency | $59/mo | Multi-account, white-label reports, priority support |
Available via GitHub (self-hosted, free) or the MCPize marketplace (managed).
git clone https://github.com/enzoemir1/adops-mcp.git
cd adops-mcp
npm ci
npm run build
npm test # 91 tests across 10 suites
npm run inspect # Open MCP Inspector
91 tests covering:
.csv.gz and Excel .xlsx supportMIT License. See LICENSE for details.
Built by Automatia BCN.
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.