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

Overview of all tools available through the Google Ads MCP server.

The Google Ads MCP server exposes 6 read-only tools: identity, account/campaign/ad-group/ad discovery, and performance insights. All tools authenticate via your Madgicx OAuth token and run against the Google Ads accounts linked to your active team.

Read-only server

No mutations are performed on Google Ads accounts. For starting/pausing campaigns, budget changes, or naming automation, use the Facebook Ads MCP (only Facebook is supported for write operations today).

Identity

  • whoiam Retrieve user identity, team info, and Google Ads token status

Ad Accounts

Campaigns

Ad Groups

  • list_ad_groups List ad groups (Google's equivalent of Facebook ad sets)

Ads

  • list_ads List ads with filtering by campaign, ad group, status, and policy

Insights

  • get_insights Performance metrics at customer / campaign / ad group / ad level with optional segment breakdowns

How Tools Work

Tool Selection

The AI identifies which tool can answer your question

Permission Check

The MCP server verifies your team has the required mcp_full permission

Token Injection

The team's Google Ads refresh token is injected into the request. Your OAuth token is never sent to Google directly

Response

Results are returned to the AI, which formats them for you

Using Tools

You don't need to know tool names to use them. Simply ask your question naturally:

Identity

What team am I connected to and is my Google Ads token active?

Discovery

What Google Ads accounts can I access?
List all enabled campaigns in customer 123-456-7890
Show me ad groups in campaign 22334455

Insights

Cost and conversions for the last 30 days, broken down by campaign
Top 10 ad groups by ROAS in customer 123-456-7890 last month
Daily impressions and clicks per device for campaign 22334455 in November

Next Steps

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