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

Tool	Description
INLINECODE1	List all accessible Google Ads accounts (MCC + sub-accounts)
INLINECODE2

Get account details (name, type, etc.) | | list_campaigns | List all campaigns (active + paused) | | create_campaign | Create a complete Search Ads campaign (budget, ad group, keywords, ads) | | get_performance | Get all campaigns performance (impressions, clicks, cost, CTR, CPC) | | get_campaign_performance | Get daily performance for a specific campaign | | keyword_research | Research keywords — get suggestions and search volume | | enable_campaign | Enable a paused campaign | | pause_campaign | Pause 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 Request	Tool to Use
"Show my Google Ads accounts"	INLINECODE12
"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

CODEBLOCK0

Keyword Research

CODEBLOCK1

Create Campaign

CODEBLOCK2

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

Location	ID
Taiwan	2158
United States

2840 | | Japan | 2392 | | Hong Kong | 2344 | | Singapore | 2702 |

Common Language IDs

Language	ID
Chinese (Traditional)	1018
Chinese (Simplified)

1017 | | English | 1000 | | Japanese | 1005 |

Error Handling

Error	Solution
Account not found	Run list_accessible_customers to get valid IDs
Permission denied

Reconnect Google Ads at adagent.10xboost.org | | Budget too low | Google Ads has minimum budget requirements per market | | Campaign creation failed | Verify all required fields (headlines >= 3, descriptions >= 2) | | Token expired | Reconnect Google Ads at adagent.10xboost.org (refresh token is long-lived) |

Documentation

Product website: adagent.10xboost.org