# google_ads_run_readonly_rpc

> Advanced read-only escape hatch for allowlisted Google Ads services outside GAQL: Audience Insights, Reach Planner, benchmarks, creator/trending insights…

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources) / [Google Ads](https://www.getmcpads.com/docs/sources/google-ads)

Advanced read-only escape hatch for allowlisted Google Ads services outside GAQL: Audience Insights, Reach Planner, benchmarks, creator/trending insights, targeting suggestions, Smart Campaign suggestions, identity verification, invoices, and payments accounts. The operation is an enum; arbitrary paths and all mutations/uploads are impossible.

|  |  |
| --- | --- |
| Source | [Google Ads](https://www.getmcpads.com/docs/sources/google-ads) |
| Kind | Read |
| Discovery | Reachable through `search_tools` and `run_tool` |
| Account parameter | `customerId` |
| Endpoint | https://mcp.getmcpads.com/google-ads/mcp |

## Parameters

| Name | Type | Required | Notes |
| --- | --- | --- | --- |
| `operation` | string | Required | One of: `generateAudienceCompositionInsights`, `generateAudienceDefinition`, `generateAudienceOverlapInsights`, `generateBenchmarksMetrics`, `generateCreatorInsights`, `generateReachForecast`, `generateShareablePreviews`, `generateSuggestedTargetingInsights`, `generateTargetingSuggestionMetrics`, `generateTrendingInsights`, `searchAudienceInsightsAttributes`, `suggestBrands`, `suggestKeywordThemes`, `suggestSmartCampaignAd`, `suggestSmartCampaignBudgetOptions`, `suggestTravelAssets`, `listInsightsEligibleDates`, `suggestKeywordThemeConstants`, `generateConversionRates`, `listBenchmarksAvailableDates`, `listBenchmarksLocations`, `listBenchmarksProducts`, `listBenchmarksSources`, `listPlannableLocations`, `listPlannableProducts`, `listPlannableUserInterests`, `listPlannableUserLists`, `getIdentityVerification`, `listInvoices`, `listPaymentsAccounts`. |
| `customerId` | string | Optional | Required for customer-scoped operations; omit for global planning catalogs. |
| `request` | object | Optional | Official REST JSON request body for POST operations, or query parameters for GET operations. Default: `{}`. |

## Calling it

Through run_tool, since it is not announced

```json
{
  "name": "run_tool",
  "arguments": {
    "name": "google_ads_run_readonly_rpc",
    "args": {
      "operation": "generateAudienceCompositionInsights"
    }
  }
}
```

- [Google Ads metrics](https://www.getmcpads.com/docs/sources/google-ads/metrics): What you can ask for.
- [Google Ads dimensions](https://www.getmcpads.com/docs/sources/google-ads/dimensions): How you can break it down.

---

This page as HTML: https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_run_readonly_rpc
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.