Server For Google Ads Meta Ads GA4

Connect Claude, Cursor, and any MCP-compatible AI agent directly to your ad platforms. Stop switching tabs. Stop copy-pasting spreadsheets. Let your AI read, analyze, and optimize your Google Ads, Meta Ads, and GA4 data — all from a single conversation.

---

🎯 The Problem

Performance marketers, agencies, and growth teams waste hours every week on:

• Manual campaign analysis — logging into Google Ads, Meta Business Suite, and GA4 separately to check what's working.
• Context switching — jumping between dashboards, spreadsheets, and Slack to piece together a coherent picture.
• Delayed reactions — underperforming campaigns and budget waste go unnoticed until the weekly report lands (too late).
• Repetitive reporting — rebuilding the same performance decks every Monday morning.

Your AI assistant (Claude, Cursor, etc.) is brilliant — but it has zero visibility into your ad accounts. Until now.

---

💡 The Solution: 4-Agent Pipeline

This MCP server exposes a 4-agent pipeline that turns raw ad data into actionable decisions — all accessible from your AI client:

Agent	Role
Campaign Reader	Pulls live campaign data from Google Ads API & Meta Ads API — budgets, impressions, clicks, conversions, and more.
Performance Analyzer	Identifies underperforming campaigns, budget waste, and anomalies across all connected platforms.
Insight Generator	Delivers AI-powered optimization recommendations — bid adjustments, audience shifts, creative fatigue alerts.
Report Builder	Generates structured weekly performance reports ready to share with stakeholders or clients.

┌─────────────────────────────────────────────────────────────────┐
│                     MCP Client (Claude / Cursor)                │
└──────────────────────────────┬──────────────────────────────────┘
                               │  MCP Protocol (stdio / HTTP)
                               ▼
┌─────────────────────────────────────────────────────────────────┐
│                   MCP Server (FastAPI + Python)                  │
│  ┌──────────────┐ ┌──────────────────┐ ┌─────────────────────┐  │
│  │Campaign Reader│→│Performance Analyzer│→│  Insight Generator │  │
│  └──────┬───────┘ └──────────────────┘ └──────────┬──────────┘  │
│         │                                         │             │
│         ▼                                         ▼             │
│  ┌──────────────┐                      ┌─────────────────────┐  │
│  │ Google Ads API│                      │   Report Builder    │  │
│  │  Meta Ads API │                      └─────────────────────┘  │
│  │    GA4 API    │                                              │
│  └──────────────┘                                              │
└─────────────────────────────────────────────────────────────────┘

---

🛠 Tech Stack

Layer	Technology
Language	Python 3.11+
Protocol	MCP (Model Context Protocol)
Framework	FastAPI
APIs	Google Ads API, Meta Marketing API, Google Analytics Data API (GA4)
Testing	pytest
CI/CD	GitHub Actions
Containerization	Docker

---

📦 Installation

Prerequisites

• Python 3.11+
• Google Ads Developer Token
• Meta Business App with Marketing API access
• Google Cloud project with GA4 Data API enabled

1. Clone & Install

git clone https://github.com/phanindraintelligenzit-afk/mcp-server-for-google-ads-meta-ads-ga4.git
cd mcp-server-for-google-ads-meta-ads-ga4
pip install -e ".[dev]"

2. Configure Environment

cp .env.example .env
# Fill in your API credentials:
# - GOOGLE_ADS_DEVELOPER_TOKEN
# - GOOGLE_ADS_CLIENT_ID / CLIENT_SECRET / REFRESH_TOKEN
# - META_APP_ID / APP_SECRET / ACCESS_TOKEN
# - GA4_PROPERTY_ID

3. Claude Desktop Config

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "google-ads-meta-ga4": {
      "command": "python",
      "args": ["-m", "mcp_server"],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_TOKEN",
        "META_ACCESS_TOKEN": "YOUR_TOKEN",
        "GA4_PROPERTY_ID": "YOUR_PROPERTY_ID"
      }
    }
  }
}

4. Cursor Config

Add to your Cursor settings.json under mcpServers:

{
  "mcpServers": {
    "google-ads-meta-ga4": {
      "command": "python",
      "args": ["-m", "mcp_server"],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_TOKEN",
        "META_ACCESS_TOKEN": "YOUR_TOKEN",
        "GA4_PROPERTY_ID": "YOUR_PROPERTY_ID"
      }
    }
  }
}

---

🚀 Quick Start

Once configured, restart Claude Desktop or Cursor. The MCP server tools will be available automatically.

Example Prompts

"Show me all active Google Ads campaigns with CTR below 2% this week."
"Compare Meta Ads vs Google Ads ROAS for the last 30 days."
"Generate a weekly performance report for my GA4 property."
"Which campaigns are wasting budget? Give me optimization recommendations."
"Pull conversion data from GA4 and cross-reference with Google Ads campaigns."

MCP Client Config Examples

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "ad-platforms": {
      "command": "python",
      "args": ["-m", "mcp_server"],
      "cwd": "/path/to/mcp-server-for-google-ads-meta-ads-ga4"
    }
  }
}

Cursor (.cursor/mcp.json in project root):

{
  "mcpServers": {
    "ad-platforms": {
      "command": "python",
      "args": ["-m", "mcp_server"],
      "cwd": "/path/to/mcp-server-for-google-ads-meta-ads-ga4"
    }
  }
}

---

🔧 API / Tools Available

Tool	Description
list_campaigns	List all campaigns from Google Ads and/or Meta Ads
get_campaign_metrics	Fetch impressions, clicks, spend, conversions for a campaign
analyze_performance	Identify underperformers, budget waste, and anomalies
get_recommendations	AI-powered optimization suggestions
generate_report	Build a structured weekly performance report
get_ga4_data	Pull sessions, conversions, and engagement from GA4
compare_platforms	Side-by-side Google Ads vs Meta Ads analysis
audit_budget_allocation	Detect overspend and reallocation opportunities

---

🎯 Use Cases

• Performance Marketers — Automate daily monitoring and get instant optimization recommendations without leaving your AI workspace.
• Agencies — Generate client-ready reports in seconds, audit multiple ad accounts, and surface cross-client insights.
• Growth Teams — Unify Google Ads, Meta Ads, and GA4 data into a single source of truth for faster, data-driven decisions.
• Freelancers & Consultants — Deliver enterprise-grade analysis without enterprise-grade tooling costs.

---

💰 Pricing

Tier	What's Included
Free Repo	Full source code (MIT). Clone, test, and deploy yourself.
Done-for-You Setup	$1,000 – $3,000 — We configure the server, connect your ad accounts, customize the pipeline, and get you live in days.

Contact us for custom enterprise deployments or multi-account agency setups.

---

🗺 Roadmap

• Google Ads API integration
• Meta Ads API integration
• GA4 Data API integration
• 4-agent pipeline (Campaign Reader → Performance Analyzer → Insight Generator → Report Builder)
• Slack / email report delivery
• Automated bid adjustment suggestions with approval workflow
• TikTok Ads API integration
• LinkedIn Ads API integration
• Custom dashboard UI
• Multi-account agency management panel

---

📄 License

MIT License — see LICENSE for details.

---

Built by AIdentify — AI Automation Marketplace.