Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GOOGLE_ADS_AUTH_TYPE | Yes | Authentication type for Google Ads API | |
| GOOGLE_ADS_API_VERSION | No | API version override (default v19). Example: v21 | v19 |
| GOOGLE_ADS_CUSTOMER_ID | No | 10‑digit Ads customer ID. If omitted, tools will list accessible accounts and ask you to pick one | |
| GOOGLE_ADS_ACCESS_TOKEN | No | Direct token override for dev/tests (bypasses ADC) | |
| GOOGLE_ADS_GCLOUD_USE_CLI | No | Optional CLI token fallback (true/false) | |
| GOOGLE_ADS_DEVELOPER_TOKEN | Yes | Developer token (required for Ads API calls) | |
| GOOGLE_ADS_CREDENTIALS_PATH | No | Required for oauth and service_account modes - path to credentials file | |
| GOOGLE_ADS_LOGIN_CUSTOMER_ID | No | Manager (MCC) account ID; only needed when acting on a child through an MCC |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| manage_auth | Manage Google Ads auth: status; switch/refresh via gcloud; set_project/set_quota_project; optional oauth_login using env client id/secret to create ADC file. |
| execute_gaql_query | Execute GAQL. Aliases accepted: customerId, pageSize, pageToken, autoPaginate, maxPages, outputFormat. |
| get_performance | Get performance (level: account|campaign|ad_group|ad). Aliases accepted: customerId, pageSize, pageToken, autoPaginate, maxPages, outputFormat. |
| list_resources | List GAQL FROM-able resources via google_ads_field (category=RESOURCE, selectable=true) or list accounts. output_format=table|json|csv. |
| gaql_help | Targeted GAQL guidance from Google docs. Hints: set quick_tips=true for offline cheat-sheet; topics=[overview,grammar,structure,date_ranges,case_sensitivity,ordering,cookbook]. |