Documentation

Create an account and choose a plan at www.adwhiz.ai/pricing. All plans include every tool — the difference is API call volume and the number of Google Ads accounts you can connect.

Go to www.adwhiz.ai/connect and authorize your Google Ads account via Google OAuth. AdWhiz only requests read and write access through the official Google Ads API. You can revoke access at any time from your Google Account settings.

AdWhiz works with any tool that supports the MCP protocol — Claude Code, Cursor, Windsurf, OpenClaw, Copilot, Gemini CLI, and more. Two authentication methods are available:

Add the AdWhiz Google Ads MCP server to my project.
Server URL: https://mcp.adwhiz.ai/mcp
Type: streamable-http

{
  "mcpServers": {
    "adwhiz": {
      "type": "streamable-http",
      "url": "https://mcp.adwhiz.ai/mcp"
    }
  }
}

{
  "mcpServers": {
    "adwhiz": {
      "type": "streamable-http",
      "url": "https://mcp.adwhiz.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

If you prefer manual setup, add the AdWhiz MCP server directly to your openclaw.json. Two transport options are available:

{
  "mcpServers": {
    "adwhiz": {
      "transport": "http",
      "url": "https://mcp.adwhiz.ai/mcp"
    }
  }
}

{
  "mcpServers": {
    "adwhiz": {
      "transport": "http",
      "url": "https://mcp.adwhiz.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "adwhiz": {
      "command": "npx",
      "args": ["-y", "@adwhiz/mcp-server"],
      "env": {
        "ADWHIZ_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

If you are an OpenClaw agent reading this page to self-install AdWhiz, follow these steps:

1. 1Use the HTTP transport with OAuth (Option A) — just add the server URL. No API key needed; a browser consent page will open on first use.
2. 2If the user’s MCP client does not support OAuth, fall back to HTTP with API key (Option B). The user can create an API key at https://www.adwhiz.ai/dashboard.
3. 3If Node.js is available and the user prefers local execution, use the stdio transport (Option C) with an API key.
4. 4Add the appropriate mcpServers entry to the user’s `openclaw.json` configuration file using the config snippets above.
5. 5Verify the connection by calling the `list_accounts` tool — it should return the user’s Google Ads account(s).
6. 6If the user has not completed Google Ads OAuth yet, direct them to https://www.adwhiz.ai/connect to authorize their account.

# Agent self-install summary:
# 1. Prefer HTTP + OAuth (no API key needed)
# 2. Fallback: HTTP + API key, or stdio + API key (needs Node.js)
# 3. Write mcpServers config to openclaw.json
# 4. Test with list_accounts tool
# 5. If Google Ads not connected → direct user to adwhiz.ai/connect
#
# Skill manifest: openclaw/skills/adwhiz/SKILL.md
# MCP endpoint: https://mcp.adwhiz.ai/mcp
# Auth: OAuth (auto) or Bearer API key
# npm package: @adwhiz/mcp-server (stdio only)

Customer ID

Every tool requires a customer_id parameter — a 10-digit number with no dashes (e.g. 9044845197). Use the list_accounts tool to find yours if you are unsure.

Micros (currency)

The Google Ads API stores monetary values in micros: 1,000,000 micros = $1.00. AdWhiz automatically converts micros to dollars in all responses, so you never need to do the math yourself.

Safety defaults

New campaigns and new ads are always created in PAUSED status. You must explicitly call set_campaign_status or set_ad_status with status: ENABLED before anything goes live.

Operation log

Every mutation (create, update, pause, remove) is recorded server-side. Use get_operation_log in your AI tool at any time to review a chronological list of recent changes made via AdWhiz.

Date ranges

Performance tools accept GAQL date preset strings. Commonly used presets:

My AI tool doesn’t see the AdWhiz tools

Check that your MCP config file (e.g. .mcp.json) is in the correct location and that the JSON is valid. Verify the API key is correct in your dashboard. Restart your AI tool completely after any config change.

I get a “subscription inactive” error

Your subscription may have lapsed or the billing card failed. Log in to www.adwhiz.ai/dashboard to check your subscription status, or contact support@adwhiz.ai.

I get a “monthly limit reached” error

You have exhausted your API call quota for the current billing cycle. Upgrade your plan from the dashboard, or wait until the next billing cycle resets your quota.

How do I add another Google Ads account?

Go to www.adwhiz.ai/connect and complete the Google OAuth flow again. Each authorization grants access to one Google Ads account (or MCC). Repeat for each account you want to manage.

Is my data safe?

Yes. AdWhiz uses AES-256-GCM encryption for refresh tokens stored at rest, communicates with Google via the official OAuth2-authenticated Google Ads API v23, and never stores your raw ad data long-term. You can revoke access at any time from your Google Account settings.