Research & Benchmarks Optimization AI Ads Analytics Why Madgicx? About Us Blog Careers Case Studies Events Glossary Guides Answers Pricing Login Try for Free
MCP docs menu

Google Ads MCP Ad Group Tools

List Google Ads ad groups (the equivalent of Facebook ad sets) with filters.

Tools for listing Google Ads ad groups under a customer.

Ad groups = ad sets

In Google Ads, an ad group is the structural equivalent of a Facebook ad set. It groups ads under a campaign and holds bid settings (CPC/CPM/CPV, target CPA, target ROAS).

list_ad_groups

List Google Ads ad groups for a customer. Returns each ad group's ID, name, status, type, parent campaign ID, and bid settings (CPC/CPM/CPV micros, target CPA micros, target ROAS).

Filters compose through optional list parameters. Combine them to narrow the result set.

Parameters

Parameter Type Description
customer_id string Google Ads customer ID. Accepts dashed (123-456-7890) or digits-only (1234567890) format. Required.
login_customer_id string | undefined Manager (MCC) customer ID for the login-customer-id header.
page_token string | undefined Pagination token from a previous response.
resource_names string[] | undefined Optional ad group resource names to filter by.
campaign_ids string[] | undefined Optional parent campaign IDs to filter by.
campaign_resource_names string[] | undefined Optional parent campaign resource names to filter by.
ad_group_ids string[] | undefined Optional ad group IDs to filter by.
names string[] | undefined Optional ad group names to filter by.
statuses string[] | undefined Optional status filter: "ENABLED", "PAUSED", "REMOVED". Defaults to excluding removed ad groups.
types string[] | undefined Optional ad group type filter (e.g., "SEARCH_STANDARD", "DISPLAY_STANDARD", "VIDEO_BUMPER").
cpc_bid_micros number[] | undefined Optional exact-match CPC bid filter (in micros).
cpm_bid_micros number[] | undefined Optional exact-match CPM bid filter (in micros).
cpv_bid_micros number[] | undefined Optional exact-match CPV bid filter (in micros).
target_cpa_micros number[] | undefined Optional exact-match target CPA filter (in micros).
target_roas number[] | undefined Optional exact-match target ROAS filter.
effective_target_cpa_micros number[] | undefined Optional exact-match effective target CPA filter (in micros).
effective_target_roas number[] | undefined Optional exact-match effective target ROAS filter.
limit number | undefined Optional upper bound on rows returned.

Example

Natural Language

List all enabled ad groups in campaign 22334455
Show me ad groups in customer 123-456-7890 with target ROAS set

Direct Query

{
  "tool": "list_ad_groups",
  "arguments": {
    "customer_id": "123-456-7890",
    "campaign_ids": ["22334455"],
    "statuses": ["ENABLED"]
  }
}
Official Meta Business Partner

Connect your AI assistant to your ad accounts. The 7-day free trial includes both MCPs.

Sign in with your Madgicx login, add the server addresses and ask in plain words. Meta changes wait for your confirmation, and the Google Ads MCP only reads.

Try for Free ($0 Trial)
200,000+ advertisers
$10B+ annual ad spend visibility
4.6 / 5 on G2, from 220+ reviews