Skip to content

Generate Google Ads keyword forecast metrics

Forecast impressions, clicks, CTR, CPC, cost, conversions, and CPA for a temporary keyword campaign. Works on your own Google Ads account, connected through Get MCP Ads. Needs customer id and keywords.

Inputs

2 required
Customer ID
Google Ads serving customer ID; use a relevant client account for better estimatesRequired · customerId
Keywords
Keyword phrases to analyze; use the language and market of the intended audienceRequired · keywords
Match type
Google Ads keyword match type for the forecast (EXACT, PHRASE or BROAD)Optional · matchType
Negative keywords
Keyword phrases excluded from the keyword forecastOptional · negativeKeywords
Negative match type
Match type applied to the negative keywords (EXACT, PHRASE or BROAD)Optional · negativeMatchType
Geo target IDs
Google Ads geo-target constant IDs for the intended locationsOptional · geoTargetIds
Language IDs
Google Ads language constant IDs for the intended audienceOptional · languageIds
Network
Google Ads search network selector used for planning (GOOGLE_SEARCH or GOOGLE_SEARCH_AND_PARTNERS)Optional · network
Bidding strategy
Supported bidding strategy for this temporary forecast (MANUAL_CPC, MAXIMIZE_CLICKS or MAXIMIZE_CONVERSIONS)Optional · biddingStrategy
Max cpc bid
Bid in standard account-currency units; required for MANUAL_CPCOptional · maxCpcBid
Daily budget
Daily amount in standard currency units; required for maximize strategies and optional for MANUAL_CPCOptional · dailyBudget
Max cpc bid ceiling
Optional standard-currency CPC ceiling for MAXIMIZE_CLICKSOptional · maxCpcBidCeiling
Conversion rate
Expected conversion rate as a decimal, e.g. 0.02 for 2%Optional · conversionRate
Currency code
Optional ISO 4217 conversion currency; account currency is used by defaultOptional · currencyCode
Start date
Optional inclusive future forecast start YYYY-MM-DD; supply with endDateOptional · startDate
End date
Optional inclusive forecast end YYYY-MM-DD, no more than one year ahead; supply with startDateOptional · endDate
Include keyword breakdown
Make independent one-keyword forecast calls in addition to the combined campaign forecastOptional · includeKeywordBreakdown
Keyword breakdown limit
Safety cap for additional rate-limited Keyword Planner requestsOptional · keywordBreakdownLimit
Workspace ID
Authorized workspace ID from list_accounts/list_workspacesOptional · workspace_id

Pricing

Price
$0.005 per call
Billing
The provider’s price, with no markup. Billed for measured usage.

Call

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

MCP call
cURL command
TypeScript
Tool ID

Alternatives

Google Keyword Planner

Connect your agent to 2,400+ tools for free

Sign in with Google or GitHub. No card required.