Google Ads Agent

Create, manage, and optimize Google Search Ads campaigns directly from Claude Code. Powered by AdAgent.

Security & Data Handling

• MCP link is a credential: Your MCP Server URL (https://adagent.10xboost.org/api/mcp/google-ads/{user_id}/mcp) contains your user ID for credential lookup. Treat it like a password — do not share it publicly.
• Token scope: The service uses your Google Ads OAuth refresh token to access your ad accounts. It can create campaigns, modify budgets, enable/pause campaigns, and read performance data.
• Token storage: Your Google Ads OAuth tokens are encrypted with Fernet (AES-128-CBC + HMAC) and stored in MongoDB. They are never exposed in API responses.
• Multi-tenant isolation: Each request is scoped to your user credentials via ASGI middleware. You can only access your own ad accounts.
• No local credentials: No local API keys, environment variables, or secrets are needed. All auth is embedded in the MCP link.
• Third-party service: This skill relies on AdAgent, an AI-powered ad management platform.

Prerequisites

1. Sign up at adagent.10xboost.org with Google
2. Connect Google Ads — authorize AdAgent to access your Google Ads account
3. Get your MCP link: Copy your Google Ads MCP Server URL from the dashboard
4. Add to Claude: Paste the MCP link as a Connector — no install, no API key needed

Available Tools

Workflow

Step 1: List Accounts

Call list_accessible_customers to see all available Google Ads accounts. Then get_customer_info for details.

Step 2: Determine What the User Wants

Step 3: Execute

Check Performance

get_performance(
  start_date="2026-03-01",
  end_date="2026-03-30"
)

Keyword Research

keyword_research(
  keywords=["AI agent", "automation tool"],
  location_ids=["2158"],   // 2158=Taiwan, 2840=US
  language_id="1000"        // 1000=Chinese
)

Create Campaign

create_campaign(
  name="Spring Sale 2026",
  daily_budget_usd=10.0,
  keywords=["AI agent", "automation tool", "AI assistant"],
  ad_headlines=["Build Your AI Agent", "Automate Your Work", "Try AI Agent Free"],
  ad_descriptions=["Create powerful AI agents in minutes.", "Boost productivity with AI automation."],
  final_url="https://example.com",
  location_ids=["2158"],
  language_id="1000"
)

Important: Campaigns are created in PAUSED state. Use enable_campaign to activate.

Step 4: Present Results

• Performance: Show key metrics in a table (impressions, clicks, CTR, CPC, cost, conversions)
• Keyword research: Show keywords ranked by search volume with competition level
• Campaign creation: Confirm campaign ID and remind user it's paused until enabled

Common Location IDs

Common Language IDs

Error Handling

Documentation

Product website: adagent.10xboost.org