google_ads_generate_keyword_historical_metrics

Get Keyword Planner search-volume history for supplied keywords. One of 38 Google Ads tools on the Get MCP Ads MCP gateway.

Get Keyword Planner search-volume history for supplied keywords. Returns average monthly searches, monthly volumes (up to 48 months), latest volume, computed 3-month and YoY changes, competition, CPC/bid ranges, close variants, and optional device totals. This is a read-only planless RPC.

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.
`keywords`	array	Required	Keywords to analyze; Google may combine near-exact close variants.
`geoTargetIds`	array	Optional	Geo target criterion IDs, e.g. 2250 for France; empty means all geographies. Default: `[]`.
`languageId`	string	Optional	Optional language criterion ID, e.g. 1002 for French; omit for all languages.
`network`	string	Optional	One of: `GOOGLE_SEARCH`, `GOOGLE_SEARCH_AND_PARTNERS`. Default: `"GOOGLE_SEARCH"`.
`includeAdultKeywords`	boolean	Optional	Default: `false`.
`includeAverageCpc`	boolean	Optional	Request legacy average CPC in addition to top-of-page bid ranges. Default: `true`.
`includeDeviceBreakdown`	boolean	Optional	Return aggregate searches by device across all requested keywords. Default: `false`.
`includeMonthlySearchVolumes`	boolean	Optional	Include every monthly point in the MCP output. Set false to trim an allowed response; Google's upstream series and the 50,000-point guard are unchanged. Default: `true`.
`historyMonths`	integer	Optional	History length when no explicit YYYY-MM range is supplied; 24 enables YoY calculation. Default: `24`.
`startYearMonth`	string	Optional	Optional inclusive historical range start YYYY-MM.
`endYearMonth`	string	Optional	Optional inclusive historical range end YYYY-MM.

Calling itLink to this section

jsonThrough run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "google_ads_generate_keyword_historical_metrics",
    "args": {
      "customerId": "<string>",
      "keywords": "<array>"
    }
  }
}