How getmcpads-com/google-ads-mcp-server works
This repository is a standalone Google Ads MCP server. The main workflow is an MCP client requesting account or performance data, the registered Google Ads tools planning or dispatching reads to Google, and returning results through MCP. It also supports keyword planning, catalog/resource discovery, and opt-in campaign writes with previews. The graph follows documented capabilities and visible imports/calls; unsampled subsystem links are omitted where their runtime wiring cannot be verified.
Main entry points: client.ts Google Ads client · index.ts Google Ads registration · query-planner.ts GAQL query planner · server.ts MCP server
Components 23
Server entry
- MCP server
src/server.ts - Credentials config
src/config.ts - Google Ads registration
src/platforms/google-ads/index.ts
Read planning
- Read tools
src/platforms/google-ads/tools.ts - GAQL query planner
src/platforms/google-ads/query-planner.ts - Metric catalog
src/platforms/google-ads/metric-catalog.ts - Dimension catalog
src/platforms/google-ads/dimension-catalog.ts - Compatibility rules
src/platforms/google-ads/compatibility-rules.ts - Filter catalog
src/platforms/google-ads/filter-catalog.ts - Google Ads client
src/platforms/google-ads/client.ts
Account and research
- Keyword Planner
src/platforms/google-ads/keyword-planner.ts - Account discovery
src/platforms/google-ads/discovery-tools.ts - Read-only RPC
src/platforms/google-ads/read-rpc.ts - MCP resources
src/platforms/google-ads/resources.ts
Campaign changes
- Campaign writes
src/platforms/google-ads/writes.ts - Extended writes
src/platforms/google-ads/extended-writes.ts
Shared services
- Tool quality
src/tool-quality.ts - Parameter descriptions
src/parameter-descriptions.ts - Error formatting
src/core/errors.ts - Rate limiting
src/core/rate-limiter.ts - Money conversion
src/core/money.ts
Other components
- MCP client
- Google Ads API
Connections 26
- MCP client → MCP server: sends requests
README.md - MCP server → Credentials config: uses config
src/server.ts - MCP server → Google Ads registration: registers tools
src/server.ts - MCP server → Tool quality: installs metadata
src/server.ts - Google Ads registration → Read tools: registers reads
src/platforms/google-ads/index.ts - Read tools → GAQL query planner: plans queries
src/platforms/google-ads/tools.ts - GAQL query planner → Metric catalog: resolves metrics
src/platforms/google-ads/query-planner.ts - GAQL query planner → Dimension catalog: resolves dimensions
src/platforms/google-ads/query-planner.ts - GAQL query planner → Compatibility rules: checks selection
src/platforms/google-ads/query-planner.ts - GAQL query planner → Filter catalog: builds filters
src/platforms/google-ads/query-planner.ts - Read tools → Google Ads client: executes reads
src/platforms/google-ads/tools.ts - Google Ads client → GAQL query planner: plans requests
src/platforms/google-ads/client.ts - Google Ads client → Google Ads API: calls API
README.md - Google Ads registration → Account discovery: registers discovery
src/platforms/google-ads/index.ts - Account discovery → Google Ads client: uses client
src/platforms/google-ads/discovery-tools.ts - Google Ads registration → MCP resources: registers resources
src/platforms/google-ads/index.ts - Google Ads registration → Campaign writes: registers writes
src/platforms/google-ads/index.ts - Campaign writes → Extended writes: delegates writes
src/platforms/google-ads/writes.ts - Google Ads registration → Extended writes: registers extensions
src/platforms/google-ads/index.ts - Campaign writes → Money conversion: converts amounts
src/platforms/google-ads/writes.ts - Tool quality → Parameter descriptions: adds descriptions
src/tool-quality.ts - Read tools → Error formatting: formats failures
src/platforms/google-ads/tools.ts - Google Ads client → Rate limiting: limits requests
src/platforms/google-ads/client.ts - Keyword Planner → Google Ads client: uses client
src/platforms/google-ads/keyword-planner.ts - Read-only RPC → Google Ads client: uses client
src/platforms/google-ads/read-rpc.ts - Google Ads API → MCP client: returns results
README.md