Google Ads MCP for Windsurf

How to Set Up AdWhiz in Windsurf

1. 1

   Create your AdWhiz account and get your API key

   Sign up at adwhiz.ai and navigate to Settings > API Keys. Generate a new API key for your Windsurf workspace. Copy the full key value — you will need it in the configuration step below.

2. 2

   Open the Windsurf MCP Panel

   In Windsurf, click the Cascade icon in the left sidebar to open the Cascade panel. At the top of the panel, click the tools icon (or go to Cascade > Configure MCP Servers) to open the MCP configuration view.

3. 3

   Add AdWhiz as a new MCP server

   In the MCP configuration panel, click 'Add Server'. Set the transport type to 'stdio', the command to 'npx', and add the arguments and environment variable as shown below. Save the configuration.

   // Windsurf MCP config (mcp_config.json):
   {
     "mcpServers": {
       "adwhiz": {
         "command": "npx",
         "args": ["-y", "@adwhiz/mcp-server"],
         "env": {
           "ADWHIZ_API_KEY": "your-api-key-here"
         }
       }
     }
   }

4. 4

   Authorize Google Ads and start using AdWhiz in Cascade

   After saving, Windsurf will load the AdWhiz MCP server. The first time you use an AdWhiz tool, you will be prompted to complete the Google Ads OAuth authorization. After that, all AdWhiz tools are available directly in Cascade AI chat.

   // Example Cascade AI prompts in Windsurf:
   // "Run a full audit on my Google Ads account"
   // "Which campaigns have the highest wasted spend this month?"
   // "Pause the {campaign name} campaign"
   // "Add site-wide negative keywords for [terms] at the account level"

AdWhiz works with any MCP-compatible AI coding tool.

What You Can Do with AdWhiz in Windsurf

• Google Ads account audit from Windsurf Cascade
• Campaign and ad group management via Cascade AI
• Keyword management with match type control
• Negative keyword discovery and bulk addition
• Sitelink and asset management
• Budget and bidding strategy management
• Conversion tracking setup and validation
• Dry-run mode for safe mutation previews
• Full audit log for every account change
• Google Ads API v23 with use_proto_plus support