Generate Google Ads keyword historical metrics

Customer ID

Google Ads serving customer ID; use the client account, not its MCC managerRequired · customerId

Keywords

Keywords to analyze; Google may combine near-exact close variantsRequired · keywords

Geo target IDs

Geo target criterion IDs, e.g. 2250 for France; empty means all geographiesOptional · geoTargetIds

Language ID

Optional language criterion ID, e.g. 1002 for French; omit for all languagesOptional · languageId

Network

Google Ads search network selector used for planning (GOOGLE_SEARCH or GOOGLE_SEARCH_AND_PARTNERS)Optional · network

Include adult keywords

Allow adult keyword ideas where supported by the provider and the selected marketOptional · includeAdultKeywords

Include average cpc

Request legacy average CPC in addition to top-of-page bid rangesOptional · includeAverageCpc

Include device breakdown

Return aggregate searches by device across all requested keywordsOptional · includeDeviceBreakdown

Include monthly search volumes

Include every monthly point in the MCP outputOptional · includeMonthlySearchVolumes

History months

History length when no explicit YYYY-MM range is supplied; 24 enables YoY calculationOptional · historyMonths

Start year month

Optional inclusive historical range start YYYY-MMOptional · startYearMonth

End year month

Optional inclusive historical range end YYYY-MMOptional · endYearMonth

Workspace ID

Authorized workspace ID from list_accounts/list_workspacesOptional · workspace_id

Price

$0.005 per call

Billing

The provider’s price, with no markup. Billed for measured usage.

Your agent reads the schema and the price with inspect_tool before it runs the tool.

MCP call

Copy

cURL command

Copy

TypeScript

Copy

Tool ID

Copy

• Generate Google ad group themesGoogle Ads$0.005
• Generate Google Ads keyword forecast metricsGoogle Ads$0.005
• Generate Google Ads keyword ideasGoogle Ads$0.005
• Google Ads keyword ideas for a siteDataForSEOUsage based
• Google Ads keyword ideas from seed keywordsDataForSEOUsage based
• Google Ads keyword search volumeDataForSEOUsage based
• Google Ads traffic forecast for keywordsDataForSEOUsage based
• Compare all 8