google_ads_generate_keyword_ideas

Discover Keyword Planner ideas from up to 20 seed keywords, a URL, keywords plus URL, or a whole site.

Discover Keyword Planner ideas from up to 20 seed keywords, a URL, keywords plus URL, or a whole site. Returns historical volume, monthly trends, computed 3-month/YoY changes, competition, bids, close variants, optional concepts, and pagination. Read-only; no plan is saved.

Source: Google Ads
Kind: Read
Discovery: Reachable through search_tools and run_tool
Account parameter: customerId
Endpoint: https://mcp.getmcpads.com/google-ads/mcp

ParametersLink to this section

Name	Type	Required	Notes
`customerId`	string	Required	Google Ads serving customer ID; use the client account, not its MCC manager.
`seedKeywords`	array	Optional
`url`	string	Optional	Specific page URL to crawl; combine with seedKeywords if desired.
`site`	string	Optional	Whole-domain seed; exclusive with seedKeywords/url.
`geoTargetIds`	array	Optional	Default: `[]`.
`languageId`	string	Optional
`network`	string	Optional	One of: `GOOGLE_SEARCH`, `GOOGLE_SEARCH_AND_PARTNERS`. Default: `"GOOGLE_SEARCH"`.
`includeAdultKeywords`	boolean	Optional	Default: `false`.
`includeAverageCpc`	boolean	Optional	Default: `true`.
`includeDeviceBreakdown`	boolean	Optional	Default: `false`.
`includeKeywordConcepts`	boolean	Optional	Default: `true`.
`historyMonths`	integer	Optional	13 months is enough to compute latest-month YoY while limiting response size. Default: `13`.
`startYearMonth`	string	Optional
`endYearMonth`	string	Optional
`pageSize`	integer	Optional	Google supports up to 10,000; keep pages small for interactive MCP use and use larger pages only for controlled exports. Default: `100`.
`pageToken`	string	Optional	nextPageToken from a prior identical request.

Calling itLink to this section

jsonThrough run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "google_ads_generate_keyword_ideas",
    "args": {
      "customerId": "<string>"
    }
  }
}