`google_ads_list_negative_keyword_lists`

List Google Ads Negative Keyword Lists

Google

Description

List shared negative keyword lists at the account level. Optionally includes the keywords within each list and which campaigns each list is attached to. Use for auditing shared exclusion lists and finding coverage gaps.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_ads_list_negative_keyword_lists",
    "arguments": {
      "customer_id": "1234567890",
      "reason": "Audit shared negative keyword lists"
    }
  }
}

hopkin google negative-keyword-lists list

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
`--list-id`	`string`	Optional	Filter to a specific shared set ID to see its keywords and campaign associations
`--include-keywords`	`boolean`	Optional	Include the keywords in each list. Defaults to false for overview.
`--include-campaign-associations`	`boolean`	Optional	Include which campaigns each list is attached to. Defaults to false.
`--limit`	`integer`	Optional	Number of lists per page (default: 20, max: 100)
`--cursor`	`string`	Optional	Pagination cursor from previous response

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

All lists
With keywords
Single list detail

Parameters

Name	Type	Required	Description
`customer_id`	`string`	Required	The Google Ads Customer ID (10 digits, with or without dashes)pattern: ^[\d-]+$
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (6)

Name	Type	Required	Description
`login_customer_id`	`string`	Optional	MCC (Manager) Customer ID; required for managed accountspattern: ^[\d-]+$
`list_id`	`string`	Optional	Filter to a specific shared set ID to see its keywords and campaign associationspattern: ^\d+$
`include_keywords`	`boolean`	Optional	Include the keywords in each list. Defaults to false for overview.
`include_campaign_associations`	`boolean`	Optional	Include which campaigns each list is attached to. Defaults to false.
`limit`	`integer`	Optional	Number of lists per page (default: 20, max: 100)min: 1, max: 100
`cursor`	`string`	Optional	Pagination cursor from previous responseminLength: 1

Examples

All lists

{
  "customer_id": "1234567890",
  "reason": "Audit shared negative keyword lists"
}

hopkin google negative-keyword-lists list --customer-id 1234567890

With keywords

{
  "customer_id": "1234567890",
  "include_keywords": true,
  "reason": "View all negative keyword list contents"
}

hopkin google negative-keyword-lists list --customer-id 1234567890 --include-keywords true

Single list detail

{
  "customer_id": "1234567890",
  "list_id": "5555555555",
  "include_keywords": true,
  "include_campaign_associations": true,
  "reason": "Full audit of a specific list"
}

hopkin google negative-keyword-lists list --customer-id 1234567890 --list-id 5555555555 --include-keywords true --include-campaign-associations true