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 Tools

List Google Ads ads with filters by campaign, ad group, status, type, and policy.

Tools for listing Google Ads ads under a customer.

list_ads

List Google Ads ads for a customer. Returns each ad's ID, resource name, ad type, status, policy review and approval status, final URLs, display URL, and parent ad group ID.

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_ad resource names to filter by.
campaign_ids string[] | undefined Optional parent campaign IDs to filter by.
ad_group_ids string[] | undefined Optional parent ad group IDs to filter by.
ad_group_resource_names string[] | undefined Optional parent ad group resource names to filter by.
ad_ids string[] | undefined Optional ad IDs to filter by.
names string[] | undefined Optional ad names to filter by.
statuses string[] | undefined Optional ad_group_ad.status filter: "ENABLED", "PAUSED", "REMOVED". Defaults to excluding removed ads.
types string[] | undefined Optional ad type filter (e.g., "RESPONSIVE_SEARCH_AD", "EXPANDED_TEXT_AD", "VIDEO_AD").
display_urls string[] | undefined Optional display URL filter.
final_urls string[] | undefined Optional final-URL filter: matches when the ad contains any of the provided URLs.
review_statuses string[] | undefined Optional policy review status filter.
approval_statuses string[] | undefined Optional policy approval status filter (e.g., "APPROVED", "DISAPPROVED", "APPROVED_LIMITED").
limit number | undefined Optional upper bound on rows returned.

Example

Natural Language

List all responsive search ads in ad group 778899 in customer 123-456-7890
Show me disapproved ads in customer 1234567890

Direct Query

{
  "tool": "list_ads",
  "arguments": {
    "customer_id": "123-456-7890",
    "ad_group_ids": ["778899"],
    "types": ["RESPONSIVE_SEARCH_AD"],
    "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