Gatescrispy/mcp-google-ads-ultimate

MCP Google Ads Ultimate

The most comprehensive Google Ads MCP server in the world - 145 specialized tools for advanced advertising management

🚀 Overview

The MCP Google Ads Ultimate is a Model Context Protocol (MCP) server that provides comprehensive access to Google Ads API functionality. Built specifically for advanced advertising management, it offers 145 specialized tools across 5 development phases:

• Phase 1: Core Management (30 tools)
• Phase 2: Campaign Optimization (42 tools)
• Phase 3: Audience & Targeting (25 tools)
• Phase 4: Advanced Features (25 tools)
• Phase 5: Integration & Analytics (23 tools)

✨ Key Features

�� Core Management

• Account management and hierarchy
• Campaign creation and optimization
• Ad group management
• Keyword and bidding strategies
• Budget allocation and monitoring

📊 Campaign Optimization

• Performance analysis and reporting
• Automated bidding strategies
• Quality score optimization
• Conversion tracking setup
• A/B testing capabilities

👥 Audience & Targeting

• Custom audience creation
• Demographic targeting
• Geographic optimization
• Remarketing strategies
• Similar audience expansion

🤖 Advanced Features

• Machine learning optimization
• Automated rule creation
• Smart campaign management
• Cross-platform integration
• Predictive analytics

🔗 Integration & Analytics

• GA4 integration
• CRM data synchronization
• Call tracking setup
• Data warehouse connections
• Compliance and governance

🏥 VT Imagerie Specialization

This MCP server includes specialized tools for medical imaging centers:

• Medical conversion tracking
• Patient journey analytics
• Healthcare compliance features
• Medical keyword optimization
• Healthcare audience targeting

📦 Installation

Prerequisites

• Python 3.8+
• Google Ads API access
• Service account credentials

Quick Start

# Clone the repository
git clone https://github.com/Gatescrispy/mcp-google-ads-ultimate.git
cd mcp-google-ads-ultimate

# Install dependencies
pip install -e .

# Configure credentials
cp config/google-ads.example.yaml config/google-ads.yaml
# Edit config/google-ads.yaml with your credentials

Configuration

# config/google-ads.yaml
developer_token: "YOUR_DEVELOPER_TOKEN"
client_id: "YOUR_CLIENT_ID"
client_secret: "YOUR_CLIENT_SECRET"
refresh_token: "YOUR_REFRESH_TOKEN"
login_customer_id: "1234567890"

🛠️ Usage

Basic Usage

from mcp_google_ads_ultimate.server import GoogleAdsUltimateServer

# Initialize server
server = GoogleAdsUltimateServer()

# Get account information
account_info = server.get_account_info("123-456-7890")

# Create campaign
campaign_data = {
    "name": "Medical Imaging Campaign",
    "budget": 1000,
    "targeting": "medical_imaging"
}
campaign = server.create_campaign_vt("123-456-7890", campaign_data)

Advanced Features

# Automated optimization
server.setup_automated_rules_vt("123-456-7890", "performance_optimization")

# Audience insights
insights = server.get_audience_insights_vt("123-456-7890", "medical_audience")

# Predictive analytics
predictions = server.setup_predictive_analytics_vt("123-456-7890", "conversion_prediction")

📚 Documentation

• - All 145 available tools
• - Detailed setup instructions
• - Technical documentation
• - Usage examples and tutorials

🧪 Testing

# Run all tests
pytest

# Run specific phase tests
pytest tests/test_phase1.py
pytest tests/test_phase2.py
pytest tests/test_phase3.py
pytest tests/test_phase4.py

# Run with coverage
pytest --cov=mcp_google_ads_ultimate

🤝 Contributing

We welcome contributions! Please see our for details.

Development Setup

# Clone and setup
git clone https://github.com/Gatescrispy/mcp-google-ads-ultimate.git
cd mcp-google-ads-ultimate
pip install -e ".[dev]"

# Run quality checks
black src/ tests/
isort src/ tests/
flake8 src/ tests/
mypy src/

📊 Performance

• 145 tools implemented and tested
• 92% success rate in comprehensive testing
• Real-time optimization capabilities
• Healthcare compliance features
• Multi-phase architecture for scalability

🔗 Related Projects

• MCP GA4 Ultimate - Google Analytics 4 MCP
• MCP GTM Ultimate - Google Tag Manager MCP
• MCP GSC Enhanced - Google Search Console MCP

📄 License

This project is licensed under the MIT License - see the file for details.

🙏 Acknowledgments

• Google Ads API team for comprehensive documentation
• MCP community for the protocol specification
• VT Imagerie for healthcare specialization insights
• All contributors and users of this project

Made with ❤️ for the MCP community