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#

ToolDescriptionlist_accessible_customersList all accessible Google Ads accounts (MCC + sub-accounts)get_customer_infoGet account details (name, type, etc.)list_campaignsList all campaigns (active + paused)create_campaignCreate a complete Search Ads campaign (budget, ad group, keywords, ads)get_performanceGet all campaigns performance (impressions, clicks, cost, CTR, CPC)get_campaign_performanceGet daily performance for a specific campaignkeyword_researchResearch keywords — get suggestions and search volumeenable_campaignEnable a paused campaignpause_campaignPause an active campaign

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#

User RequestTool to Use"Show my Google Ads accounts"list_accessible_customers"List my campaigns"list_campaigns"How are my ads doing?"get_performance"Campaign X performance"get_campaign_performance"Research keywords for ..."keyword_research"Create a search ad for ..."create_campaign"Pause campaign X"pause_campaign"Enable campaign X"enable_campaign

Step 3: Execute#

Check Performance

text

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

Keyword Research

text

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

Create Campaign

text

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#

LocationIDTaiwan2158United States2840Japan2392Hong Kong2344Singapore2702

Common Language IDs#

LanguageIDChinese (Traditional)1018Chinese (Simplified)1017English1000Japanese1005

Error Handling#

ErrorSolutionAccount not foundRun list_accessible_customers to get valid IDsPermission deniedReconnect Google Ads at adagent.10xboost.orgBudget too lowGoogle Ads has minimum budget requirements per marketCampaign creation failedVerify all required fields (headlines >= 3, descriptions >= 2)Token expiredReconnect Google Ads at adagent.10xboost.org (refresh token is long-lived)

Documentation#

Product website: adagent.10xboost.org