AdWhiz
Windsurf

Google Ads MCP for Windsurf

AdWhiz connects Windsurf's Cascade AI to your Google Ads account via MCP. Audit your account, manage campaigns, and analyze performance directly from the Windsurf IDE — without opening the Google Ads UI.

Get MCP Access

How to Set Up AdWhiz in Windsurf

  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. 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. 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. 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.

支持任何兼容 MCP 的 AI 工具

Claude CodeCursorWindsurfContinue.devClineZedOpenClaw

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

AdWhiz + Windsurf: Common Questions

Yes. AdWhiz MCP tools are fully compatible with Cascade's agentic mode, where Cascade can autonomously chain multiple tool calls together. However, AdWhiz's safety model still requires explicit user confirmation before any mutation is executed — even in agentic mode.

Yes. If you have a Google Ads Manager Account (MCC), AdWhiz can access all child accounts under it. You can specify which customer ID to operate on in each prompt, or set a default customer ID in your AdWhiz settings.

Yes. The AdWhiz MCP server runs via npx and is cross-platform. Windows, macOS, and Linux are all supported. Make sure Node.js 18+ is installed on your system.

AdWhiz plans include a monthly API call quota that applies regardless of which AI tool you use. The Developer plan includes 1,000 API operations per month. Professional and Agency plans have higher limits. Audit operations count as one call. Complex multi-step mutations may count as several.

Start Managing Google Ads from Windsurf

Get MCP access and connect your Google Ads account to Windsurf in under 5 minutes.

或加入邮件列表