`google_ads_list_mcc_child_accounts`

List MCC Child Accounts

Google

Description

List child accounts under a specific MCC (Manager) account. When calling other tools for these child accounts, you MUST pass login_customer_id with the MCC Customer ID. For all accessible accounts regardless of hierarchy, use google_ads_list_accounts instead.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_ads_list_mcc_child_accounts",
    "arguments": {
      "mcc_id": "1234567890",
      "reason": "List MCC child accounts"
    }
  }
}

hopkin google mcc-child-accounts list

Flag	Type	Required	Description
`--mcc-id`	`string`	Required	The MCC (Manager) Customer ID whose child accounts to list (10 digits, dashes accepted)
`--search`	`string`	Optional	Search child accounts by name or customer ID (case-insensitive partial match)
`--limit`	`integer`	Optional	Number of accounts per page (default: 20, max: 100)
`--cursor`	`string`	Optional	Pagination cursor from previous response
`--refresh`	`boolean`	Optional	Force a fresh fetch of labels for this MCC scope. Defaults to false (cache-first).
`--label-filter`	`array`	Optional	Filter by labels. Accepts an array whose entries are any of: label name (e.g. "Big Boom"), bare label ID (e.g. "9876543210"), or full label resource name (e.g. "customers/1234567890/labels/9876543210"). Names are resolved against cached labels for the relevant customer scope. Unknown names return an empty result with a warning rather than an error.

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

Parameters

Name	Type	Required	Description
`mcc_id`	`string`	Required	The MCC (Manager) Customer ID whose child accounts to list (10 digits, dashes accepted)pattern: ^[\d-]+$
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (5)

Name	Type	Required	Description
`search`	`string`	Optional	Search child accounts by name or customer ID (case-insensitive partial match)minLength: 1
`limit`	`integer`	Optional	Number of accounts per page (default: 20, max: 100)min: 1, max: 100
`cursor`	`string`	Optional	Pagination cursor from previous responseminLength: 1
`refresh`	`boolean`	Optional	Force a fresh fetch of labels for this MCC scope. Defaults to false (cache-first).
`label_filter`	`array`	Optional	Filter by labels. Accepts an array whose entries are any of: label name (e.g. "Big Boom"), bare label ID (e.g. "9876543210"), or full label resource name (e.g. "customers/1234567890/labels/9876543210"). Names are resolved against cached labels for the relevant customer scope. Unknown names return an empty result with a warning rather than an error.

Examples

List children

{
  "mcc_id": "1234567890",
  "reason": "List MCC child accounts"
}

hopkin google mcc-child-accounts list --mcc-id 1234567890

Search children

{
  "mcc_id": "1234567890",
  "search": "marketing",
  "reason": "Find child accounts"
}

hopkin google mcc-child-accounts list --mcc-id 1234567890 --search marketing