google_ads_generate_keyword_forecast_metrics

Forecast impressions, clicks, CTR, CPC, cost, conversions, and CPA for a temporary keyword campaign.

Forecast impressions, clicks, CTR, CPC, cost, conversions, and CPA for a temporary keyword campaign. Supports targeting, negatives, match type, three bidding strategies, explicit future dates, and an optional independent per-keyword breakdown. This read-only planless RPC does not create a campaign or saved plan.

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 a relevant client account for better estimates.
`keywords`	array	Required
`matchType`	string	Optional	One of: `EXACT`, `PHRASE`, `BROAD`. Default: `"BROAD"`.
`negativeKeywords`	array	Optional	Default: `[]`.
`negativeMatchType`	string	Optional	One of: `EXACT`, `PHRASE`, `BROAD`. Default: `"BROAD"`.
`geoTargetIds`	array	Optional	Default: `[]`.
`languageIds`	array	Optional	Default: `[]`.
`network`	string	Optional	One of: `GOOGLE_SEARCH`, `GOOGLE_SEARCH_AND_PARTNERS`. Default: `"GOOGLE_SEARCH"`.
`biddingStrategy`	string	Optional	One of: `MANUAL_CPC`, `MAXIMIZE_CLICKS`, `MAXIMIZE_CONVERSIONS`. Default: `"MANUAL_CPC"`.
`maxCpcBid`	number	Optional	Bid in standard account-currency units; required for MANUAL_CPC.
`dailyBudget`	number	Optional	Daily amount in standard currency units; required for maximize strategies and optional for MANUAL_CPC.
`maxCpcBidCeiling`	number	Optional	Optional standard-currency CPC ceiling for MAXIMIZE_CLICKS.
`conversionRate`	number	Optional	Expected conversion rate as a decimal, e.g. 0.02 for 2%.
`currencyCode`	string	Optional	Optional ISO 4217 conversion currency; account currency is used by default.
`startDate`	string	Optional	Optional inclusive future forecast start YYYY-MM-DD; supply with endDate.
`endDate`	string	Optional	Optional inclusive forecast end YYYY-MM-DD, no more than one year ahead; supply with startDate.
`includeKeywordBreakdown`	boolean	Optional	Make independent one-keyword forecast calls in addition to the combined campaign forecast. Default: `false`.
`keywordBreakdownLimit`	integer	Optional	Safety cap for additional rate-limited Keyword Planner requests. Default: `10`.

Calling itLink to this section

jsonThrough run_tool, since it is not announced

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