adwhiz（广告洞察）

AdWhiz — Google Ads & Meta Ads MCP Server

AdWhiz is a hosted MCP server that connects your AI coding tool to the Google Ads API and Meta (Facebook) Graph API through a secure, authenticated proxy. It exposes 102 tools across 7 categories so you can audit, create, and manage ad campaigns across both platforms using plain English.

All API calls are authenticated via your personal ADWHIZ_API_KEY and routed through the AdWhiz server at mcp.adwhiz.ai. No Google or Meta credentials are stored by the skill — authentication is handled entirely server-side after you link your ad accounts at https://adwhiz.ai/connect.

Security & Permissions Model

• OAuth 2.0: User authenticates with Google and/or Meta via AdWhiz's web

UI. Refresh tokens (Google) and long-lived access tokens (Meta) are encrypted at rest (AES-256-GCM) and never exposed to the agent.

• API key scoping: Each ADWHIZ_API_KEY is bound to a single user's

connected accounts. Cross-user access is not possible.

• Write safety: All Google Ads write tools create entities in PAUSED

status by default. Meta write tools require explicit status parameters.

• Mutation logging: Every mutation is recorded in the get_operation_log

tool for full auditability.

• Read-only by default: 39 of 102 tools are strictly read-only and cannot

modify your accounts.

• Confirmation required: Write tools require user confirmation before

executing via the agent's standard permission flow.

• No arbitrary code execution: The MCP server is a hosted HTTP service.

No code is downloaded or executed on the user's machine beyond the thin MCP client wrapper.

Google Ads Tools (70)

Account (2 tools) — Read-only

Read (20 tools) — Read-only

Write (45 tools) — Requires user confirmation

Audit (2 tools) — Read-only analysis

Query (1 tool) — Read-only, bounded

Meta (Facebook) Ads Tools (32)

Meta Read (15 tools) — Read-only

Meta Write (16 tools) — Requires user confirmation

Meta Audit (1 tool) — Read-only analysis

MCP Server Configuration

AdWhiz uses HTTP transport to connect to the hosted MCP server. No npm packages are downloaded or executed at runtime.

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

REST API (Alternative to MCP)

For platforms that cannot use the MCP protocol (GPT Actions, Dify, Coze, or any HTTP-based workflow), AdWhiz also exposes all 102 tools as a standard REST API with an OpenAPI 3.1.0 spec:

• OpenAPI spec: https://mcp.adwhiz.ai/api/v1/openapi.json
• Tool listing: https://mcp.adwhiz.ai/api/v1/tools
• Tool execution: POST https://mcp.adwhiz.ai/api/v1/tools/{tool_name}

# Example: list campaigns via REST API
curl -X POST https://mcp.adwhiz.ai/api/v1/tools/list_campaigns \
  -H "Authorization: Bearer $ADWHIZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"customer_id": "1234567890"}'

Import the OpenAPI spec URL into any platform that supports OpenAPI actions to auto-discover all 102 tools.

Quick Install

clawhub install adwhiz

This adds the MCP server configuration above to your settings. You will be prompted to provide your ADWHIZ_API_KEY.

Getting Your API Key

1. Sign up at https://adwhiz.ai
2. Connect your Google Ads and/or Meta Ads account via OAuth
3. Copy your API key from the dashboard settings page

Example Prompts

Google Ads

• "Audit my Google Ads account and show the top 5 waste areas"
• "Pause all campaigns with CPA above $150"
• "Add these negative keywords to my Search campaigns: [list]"
• "Create a new Search campaign targeting lawyers in New York with $100/day budget"
• "Show me search terms wasting money and suggest negatives"
• "What is my account's average Quality Score this month?"

Meta Ads

• "Audit my Meta Ads account and show the health score"
• "List all active Meta campaigns with their spend and CTR"
• "Pause the Meta campaign with the highest frequency"
• "Show me daily spend trends for my Meta account over the last 30 days"
• "Which Meta ad sets have the worst CPA?"

Data Handling

• AdWhiz only accesses the ad accounts you explicitly linked
• No campaign data is stored beyond the duration of each API request
• Mutation logs are retained for 30 days for auditability
• You can revoke access at any time from https://adwhiz.ai/connect

Documentation

Full documentation: https://adwhiz.ai/docs