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 Campaign Tools

List Google Ads campaigns with filters by status, channel type, bidding strategy, and budget.

Tools for listing Google Ads campaigns under a customer (ad account).

list_campaigns

List Google Ads campaigns for a customer. Returns each campaign's ID, name, status, serving status, advertising channel type and subtype, bidding strategy, start/end date, optimization score, budget, and targets.

Filtering is exposed through optional list parameters that translate into WHERE … IN (…) clauses on the underlying GAQL query. Pass any combination to narrow the result set.

Parameters

Parameter Type Description
customer_id string Google Ads customer ID (the account to query). 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. Required when querying an account accessed via an MCC.
page_token string | undefined Pagination token from a previous response. Omit for the first page.
resource_names string[] | undefined Optional campaign resource names to filter by.
campaign_ids string[] | undefined Optional campaign IDs to filter by.
names string[] | undefined Optional campaign names to filter by.
statuses string[] | undefined Optional status filter: enum names like "ENABLED", "PAUSED", "REMOVED". When omitted, removed campaigns are excluded.
serving_statuses string[] | undefined Optional campaign serving-status filter.
advertising_channel_types string[] | undefined Optional advertising_channel_type filter (e.g., "SEARCH", "DISPLAY", "VIDEO", "PERFORMANCE_MAX").
advertising_channel_sub_types string[] | undefined Optional advertising_channel_sub_type filter.
bidding_strategy_types string[] | undefined Optional bidding_strategy_type filter.
budget_resource_names string[] | undefined Optional linked campaign budget resource names.
budget_amount_micros number[] | undefined Optional exact-match budget amount filter (in micros: 1,000,000 micros = 1 unit of currency).
budget_delivery_methods string[] | undefined Optional budget delivery method filter.
optimization_scores number[] | undefined Optional exact-match optimization score filter.
target_cpa_micros number[] | undefined Optional exact-match target CPA filter (in micros).
target_roas number[] | undefined Optional exact-match target ROAS filter.
limit number | undefined Optional upper bound on rows returned. Pass null/undefined to return all matches (subject to API paging).

Example

Natural Language

Show me all enabled campaigns in customer 123-456-7890
List Search campaigns in customer 1234567890 paused in the last week

Direct Query

{
  "tool": "list_campaigns",
  "arguments": {
    "customer_id": "123-456-7890",
    "statuses": ["ENABLED"],
    "advertising_channel_types": ["SEARCH"],
    "limit": 50
  }
}
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