Complete Google Ads API v21 MCP Server

🎉 FULLY FUNCTIONAL - 40+ tools implemented with complete automation capabilities!

A comprehensive Model Context Protocol (MCP) server that provides full access to Google Ads API v21 functionality. This server enables AI assistants to create, optimize, and manage Google Ads campaigns with complete automation through natural language commands.

🚀 What Makes This Different

This is a COMPLETE implementation! Unlike other repositories that only provide interfaces without implementations, every single tool actually works with full Google Ads API v21 compatibility:

✅ 40+ Tools Implemented - Complete campaign automation
✅ 100% API v21 Compatible - All latest features and fixes
✅ Production Tested - Successfully manages real campaigns at scale
✅ Advanced Automation - Full campaign lifecycle from creation to optimization
✅ Comprehensive Error Handling - Robust retry logic and detailed errors
✅ Complete Documentation - Examples and syntax guides

🛠️ Complete Tool Set (45+ Tools)

🏢 Account Management (3 Tools)

• list_accounts - List all accessible Google Ads accounts
• get_account_info - Detailed account information with optimization scores
• get_account_hierarchy - Complete account structure and relationships

🎯 Campaign Management (10 Tools)

• create_campaign - Create campaigns with advanced targeting and bidding
• update_campaign - Update settings including portfolio bidding strategy assignment
• pause_campaign / resume_campaign - Campaign lifecycle management
• list_campaigns - Filter and search campaigns with performance data
• get_campaign - Comprehensive campaign details and metrics
• delete_campaign - Safe campaign removal
• copy_campaign - Duplicate campaigns with new budgets
• create_ad_schedule - Advanced dayparting with bid adjustments
• get_campaign_overview - Complete dashboard showing campaign structure, keywords, extensions, optimization score

📁 Ad Group Management (3 Tools)

• create_ad_group - Create ad groups with custom bidding
• update_ad_group - Modify ad group settings and bids
• list_ad_groups - Browse ad groups with filters

📝 Advanced Ad Management (10 Tools)

• create_responsive_search_ad - Modern responsive search ads
• create_expanded_text_ad - Traditional expanded text ads
• list_ads / update_ad / pause_ad / enable_ad / delete_ad - Complete ad lifecycle
• compare_ad_performance - Side-by-side ad performance analysis
• get_ad_group_performance_ranking - Rank ads by efficiency metrics
• identify_optimization_opportunities - AI-powered optimization recommendations
• calculate_roas_by_ad - Return on Ad Spend analysis with profitability insights

🧠 Keyword Intelligence (8 Tools)

• add_keywords - Add keywords with custom match types and bids
• add_negative_keywords - Campaign/ad group negative keywords with smart protobuf handling
• list_keywords - Keywords with quality scores and performance data
• update_keyword_bid / delete_keyword / pause_keyword / enable_keyword - Complete keyword lifecycle
• get_keyword_performance - Quality scores and optimization insights

🎨 Modern Extensions (6 Tools)

• create_sitelink_extensions - Additional links with descriptions (API v21 AssetService)
• create_callout_extensions - Compelling callout text (API v21 compatible)
• create_structured_snippet_extensions - Service showcases with header validation
• create_call_extensions - Phone extensions with scheduling
• list_extensions / delete_extension - Extension management

💰 Portfolio Bidding (5 Tools)

• create_portfolio_bidding_strategy - Target CPA, ROAS, Impression Share strategies
• list_bidding_strategies - Portfolio strategies with campaign as

... View full README on GitHub