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 |
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. Optional: login_customer_id (aka MCC/manager account id) overrides env. |
| get_performance | Get performance (level: account|campaign|ad_group|ad). Optional: login_customer_id (aka MCC/manager account id) overrides env. |
| 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 | Get GAQL help with local documentation and official Google Ads API links. Use topic for specific areas or search for keywords. |
| set_session_credentials | Establish a session with Google Ads credentials (multi-tenant mode only). |
| get_credential_status | Get credential status for a session (multi-tenant mode). |
| end_session | End a session and clear credentials (multi-tenant mode). |
| refresh_access_token | Refresh the access token for a session (multi-tenant mode). Requires GOOGLE_OAUTH_CLIENT_ID/SECRET. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |