Generate Google Ads keyword ideas

Customer ID

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

Seed keywords

Seed keyword phrases from which Google generates keyword ideasOptional · seedKeywords

URL

Specific page URL to crawl; combine with seedKeywords if desiredOptional · url

Site

Whole-domain seed; exclusive with seedKeywords/urlOptional · site

Geo target IDs

Google Ads geo-target constant IDs for the intended locationsOptional · geoTargetIds

Language ID

Google Ads language constant ID for the keyword requestOptional · 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 average cost-per-click metrics when availableOptional · includeAverageCpc

Include device breakdown

Include device-specific planning metrics when supportedOptional · includeDeviceBreakdown

Include keyword concepts

Include Google's keyword concept grouping metadataOptional · includeKeywordConcepts

History months

13 months is enough to compute latest-month YoY while limiting response sizeOptional · historyMonths

Start year month

First year and month of the historical metrics periodOptional · startYearMonth

End year month

Last year and month of the historical metrics periodOptional · endYearMonth

Page size

Google supports up to 10,000; keep pages small for interactive MCP use and use larger pages only for controlled exportsOptional · pageSize

Page token

NextPageToken from a prior identical requestOptional · pageToken

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 historical metricsGoogle 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