API Reference

Google Ads / API Reference

gads_generate_audience_insights

Google Ads tool (extended/low-level coverage). For common tasks prefer the RECOMMENDED google_ads_* actions; use these only for advanced operations those don't cover. Get audience composition insights for specified user lists.

This is a write tool: it generates audience insights in your Google Ads account. Claude asks you to confirm before it runs.

Ask Claude

You do not call this tool yourself. Ask for the outcome and the client picks the tool:

Generate audience insights in my Google Ads account.

It takes 0 required and 4 optional parameters.

Parameters

ParameterTypeRequiredDescription
user_list_idsarrayNoUser List Ids
user_interest_idsarrayNoUser Interest Ids
dimensionsarrayNoDimensions
customer_idstringNoCustomer Id

Related Google Ads tools

Before you can call it

This tool needs a connected Google Ads account. The Google Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.

Workflows that use this

Rather than calling tools one at a time, these skills run a whole procedure against the same account:

Start using MCP Ads