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	Seed keyword phrases from which Google generates keyword ideas.
`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	Google Ads geo-target constant IDs for the intended locations. Default: `[]`.
`languageId`	string	Optional	Google Ads language constant ID for the keyword request.
`network`	string	Optional	Google Ads search network selector used for planning. One of: `GOOGLE_SEARCH`, `GOOGLE_SEARCH_AND_PARTNERS`. Default: `"GOOGLE_SEARCH"`.
`includeAdultKeywords`	boolean	Optional	Allow adult keyword ideas where supported by the provider and the selected market. Default: `false`.
`includeAverageCpc`	boolean	Optional	Request average cost-per-click metrics when available. Default: `true`.
`includeDeviceBreakdown`	boolean	Optional	Include device-specific planning metrics when supported. Default: `false`.
`includeKeywordConcepts`	boolean	Optional	Include Google's keyword concept grouping metadata. Default: `true`.
`historyMonths`	integer	Optional	13 months is enough to compute latest-month YoY while limiting response size. Default: `13`.
`startYearMonth`	string	Optional	First year and month of the historical metrics period.
`endYearMonth`	string	Optional	Last year and month of the historical metrics period.
`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>"
    }
  }
}