`google_ads_generate_ad_group_themes`

Generate Google Ads Ad Group Themes

Google

Description

Suggest which ad group each keyword belongs to. Takes a list of keywords and existing ad group resource names, returns keyword-to-ad-group assignment suggestions with recommended match types. Also identifies unusable ad groups. Example: organize ["running shoes", "trail shoes", "yoga mat", "yoga block"] across your existing ad groups.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_ads_generate_ad_group_themes",
    "arguments": {
      "customer_id": "1234567890",
      "keywords": [
        "running shoes",
        "trail shoes",
        "yoga mat",
        "yoga block"
      ],
      "ad_groups": [
        "customers/1234567890/adGroups/111",
        "customers/1234567890/adGroups/222"
      ],
      "reason": "Organize keywords into ad groups"
    }
  }
}

hopkin google generate-ad-group-themes

Flag	Type	Required	Description
`--customer-id`	`string`	Required	The Google Ads Customer ID (10 digits, with or without dashes)
`--login-customer-id`	`string`	Optional	MCC (Manager) Customer ID; required for managed accounts
`--keywords`	`array`	Required	Keywords to find ad group assignments for (1-2000 keywords)
`--ad-groups`	`array`	Required	Ad group resource names (e.g., "customers/1234567890/adGroups/111222333") to consider as placement targets

{
  "mcpServers": {
    "google-ads": {
      "url": "https://google.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`customer_id`	`string`	Required	The Google Ads Customer ID (10 digits, with or without dashes)pattern: ^[\d-]+$
`keywords`	`array`	Required	Keywords to find ad group assignments for (1-2000 keywords)
`ad_groups`	`array`	Required	Ad group resource names (e.g., "customers/1234567890/adGroups/111222333") to consider as placement targets
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (1)

Name	Type	Required	Description
`login_customer_id`	`string`	Optional	MCC (Manager) Customer ID; required for managed accountspattern: ^[\d-]+$

Examples

Assign keywords to ad groups

{
  "customer_id": "1234567890",
  "keywords": [
    "running shoes",
    "trail shoes",
    "yoga mat",
    "yoga block"
  ],
  "ad_groups": [
    "customers/1234567890/adGroups/111",
    "customers/1234567890/adGroups/222"
  ],
  "reason": "Organize keywords into ad groups"
}

hopkin google generate-ad-group-themes --customer-id 1234567890 --keywords running shoes,trail shoes,yoga mat,yoga block --ad-groups customers/1234567890/adGroups/111,customers/1234567890/adGroups/222