# Install:  uvx mcp-google-ads-multi

# Ask your AI:
"Show me campaign performance for account my-client last month"
"What search terms drove conversions for client-acme in Q2?"
"Compare my-account's spend between January and February"
"Which keywords have quality scores below 5 for campaign 123?"

flowchart TD
    Client[MCP client] -->|stdio or SSE| Server[gads/server.py]

    subgraph Local config
        Env[environment] --> Accounts[accounts.json]
        Accounts --> Auth[OAuth or service account]
    end

    Server --> AccountsMod[gads/accounts.py]
    Server --> Query[gads/query.py]
    Server --> Retry[gads/retry.py]
    AccountsMod --> Auth
    Query -->|GAQL| Ads[Google Ads API]
    Retry -->|backoff| Ads
    Ads -->|metrics| Server
    Server -->|tool result| Client

flowchart TD
    Ask([User asks for Ads data]) --> Tool[Select MCP tool]
    Tool --> Account{Account named?}
    Account -->|yes| LoadNamed[Load named account]
    Account -->|no| LoadDefault[Load default account]
    LoadNamed --> Auth[Resolve credentials]
    LoadDefault --> Auth
    Auth --> Query[Build GAQL query]
    Query --> Execute[Call Google Ads API]
    Execute --> Retry{Rate limited?}
    Retry -->|yes| Backoff[Retry with backoff]
    Retry -->|no| Return[Return metrics]
    Backoff --> Execute

mkdir -p ~/.config/mcp-google-ads
cp accounts.example.json ~/.config/mcp-google-ads/accounts.json
# Edit it — add your accounts

{
  "mcpServers": {
    "google-ads": {
      "command": "uvx",
      "args": ["mcp-google-ads-multi"],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "your-developer-token",
        "GOOGLE_ADS_ACCOUNTS_CONFIG": "/Users/you/.config/mcp-google-ads/accounts.json"
      }
    }
  }
}

{
  "default": "my-account",
  "accounts": {
    "my-account": {
      "type": "oauth",
      "client_id": "YOUR_CLIENT_ID.apps.googleusercontent.com",
      "client_secret": "YOUR_CLIENT_SECRET",
      "token_file": "~/.config/mcp-google-ads/my-account.token"
    },
    "client-acme": {
      "type": "oauth",
      "client_id": "YOUR_CLIENT_ID.apps.googleusercontent.com",
      "client_secret": "YOUR_CLIENT_SECRET",
      "token_file": "~/.config/mcp-google-ads/client-acme.token"
    }
  }
}