MCP Tools

The Google Keyword Planner MCP server exposes three tools. All tools require valid credentials -- see Configuration.

Tool Overview

Tool	Purpose
generate_keyword_ideas	Generate related keywords from seed keywords and/or a URL, with search volume and CPC data
get_historical_metrics	Get historical search volume, competition, and CPC for a specific list of keywords
get_keyword_forecast	Project impressions, clicks, and cost for keywords at a given max CPC bid

Common Notes

Search volume precision: Without active ad spend on the account, Google returns search volumes as ranges rather than exact numbers. Any minimal ad spend unlocks precise monthly volumes.

Rate limits: The Keyword Planner API has quotas. For large batches, prefer get_historical_metrics with a list of known keywords over multiple generate_keyword_ideas calls.

Language codes: Language is specified as a resource name like languageConstants/1000 (English). See the Google Ads API reference for other language codes.