Skip to content
MCP server

Google Ads MCP: your account, inside your AI assistant

38 MCP tools for Google Ads. Read spend, campaigns, keywords and search terms from the live account, and pause or change it — anything that adds spend waits for your approval in MyAd.

Google API terms. This MyAd endpoint reads the Google Ads accounts connected to MyAd and changes them as described below. It is not a replacement for or sublicense of Google's API. Write tools act on your own connected account only. See the Privacy Policy and Terms for data-use details.

Why an MCP server instead of another dashboard

Advertising tools keep building dashboards nobody has time to open. An MCP server meets you where the work already happens — inside the AI assistant you use every day.

  • No context switching. Ask for a CPA breakdown while you're already in your editor.
  • Composable. Chain tools: get_search_terms_report → add_negative_keywords → get_change_status, in one prompt.
  • Auditable. Every tool call is logged, and every change that ran appears in MyAd's change log (优化记录) with its result.
  • Guardrailed. Keys are scoped per account, a budget or bid may at most double in one request, and anything that adds spend needs your approval.
.mcp.json
{
  "mcpServers": {
    "google-ads": {
      "type": "http",
      "url": "https://myad.si/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer $MYAD_API_KEY"
      }
    }
  }
}

Then, in your assistant:

› Which searches wasted money in Acme Store this month, and can you block them?

✓ list_accounts → Acme Store (Google Ads)

✓ get_search_terms_report → 214 terms, 18 with no conversions

✓ add_negative_keywords → 18 exact negatives added

38 tools

What the Google Ads MCP server exposes

Accounts and health, performance reports, keywords and search terms, budgets and bids, and changes.

Each tool is marked Read or Makes changes. Pausing and lowering run at once; anything that can add spend — enabling, new keywords, a higher budget or bid — becomes a request the account owner approves in MyAd within 48 hours.

Accounts & health

Find the accounts, see what works in one, and run or read a health check.

list_accountsRead

The Google Ads and Meta accounts this key or app may use, with the accountId every other tool takes.

check_account_capabilitiesRead

What MyAd can do in the account now: connection, data access, status, billing, conversion tracking and which changes wait for approval.

get_accountRead

One account for a date range: spend, clicks, impressions, conversions, value and the rates, plus live Google Ads facts.

get_account_healthRead

The latest saved MyAd health check: score, each dimension's grade, open recommendations and data gaps.

run_auditRead

Runs a new health check now, one per account every 30 minutes, and returns its score and recommendations.

get_business_profileRead

The owner's saved business profile: name, website, industry, customers, selling points and competitors.

Recommendations & history

Read the health recommendations, act on one, and follow every change.

list_recommendationsRead

Open recommendations with the recommendationId the apply and dismiss tools take, the plan and whether applying needs approval.

list_change_historyRead

Changes made to this account through MyAd, newest first, with what changed, the result and who decided.

get_change_statusRead

One change request: pending, applying, applied, rejected, failed or expired, and when a pending one expires.

apply_recommendationMakes changes

Applies an open recommendation: one that does not add spend runs at once, one that adds spend waits for the owner.

dismiss_recommendationMakes changes

Dismisses an open recommendation so it leaves the list; nothing in the ad account changes.

Performance reports

Account, campaign, ad group, ad, day, place, device and hour numbers.

compare_periodsRead

Totals for a date range and the same-length period before it, with the change in percent.

get_metrics_timeseriesRead

Daily spend, clicks, impressions, conversions, value and the rates, oldest day first.

list_campaignsRead

Campaigns with spend, clicks, impressions, conversions, value, the rates and budget; on Google it marks campaigns MyAd's autopilot (托管) manages.

list_ad_groupsRead

Ad groups (Meta: ad sets) with spend, clicks, impressions, conversions, value, the rates and their campaign.

list_adsRead

Ads with spend, clicks, impressions, conversions, value, the rates, status and ad text, plus Google approval status and policy reasons.

get_geo_reportRead

Spend, clicks, impressions, conversions, value and the rates per country, region or city.

get_device_reportRead

Spend, clicks, impressions, conversions, value, the rates and each device's share of spend.

get_schedule_reportRead

Spend, clicks, impressions, conversions, value and the rates per weekday or per hour.

Keywords & search terms

What people searched, what you bid on, and the negatives that block waste.

list_keywordsRead

Keywords with spend, clicks, conversions, the real average CPC, the max CPC bid, Quality Score and its three parts.

get_search_terms_reportRead

The real search terms that got clicks, with spend, clicks, conversions and average CPC; onlyWaste keeps terms with no conversions.

list_negative_keywordsRead

Campaign and ad group negatives with their match type, plus the shared negative lists the campaigns use.

add_negative_keywordsMakes changes

Adds up to 20 exact-match negatives to a campaign at once, so those searches stop showing its ads.

pause_keywordsMakes changes

Pauses up to 20 keywords at once.

enable_keywordsMakes changes

Asks the owner to turn up to 20 paused keywords back on; it waits for approval.

add_keywordsMakes changes

Asks the owner to add up to 20 keywords to an ad group; once approved they are created enabled with the ad group's default bid.

update_keyword_bidMakes changes

Sets a keyword's max CPC bid in a manual CPC campaign: a lower bid runs at once, a higher one waits for the owner.

Budgets, bids & assets

This month's budgets, each campaign's bid strategy, extensions and conversion actions.

get_budget_summaryRead

This month's budgets: daily amount, shared or not, the campaigns that spend each one and their spend so far.

get_bid_strategyRead

Each campaign's bid strategy type, portfolio and the targets set in the account.

list_ad_extensionsRead

Sitelinks, callouts, structured snippets and calls at account, campaign and ad group level.

list_conversion_actionsRead

Every conversion action with status, type, counting, whether it counts in the Conversions column, and its numbers.

Changes

Pause and enable campaigns, ad groups and ads, and set one budget.

set_campaign_budgetMakes changes

Sets a campaign's daily budget: a lower budget runs at once, a higher one waits for the owner and may at most double it.

pause_campaignMakes changes

Pauses a campaign at once.

pause_ad_groupMakes changes

Pauses an ad group (Meta: ad set) at once.

pause_adMakes changes

Pauses one ad at once.

enable_campaignMakes changes

Asks the owner to turn a paused campaign back on; it starts spending, so it waits for approval.

enable_ad_groupMakes changes

Asks the owner to turn a paused ad group (Meta: ad set) back on; it waits for approval.

enable_adMakes changes

Asks the owner to turn a paused ad back on; it waits for approval.

Try a raw request

Any language or tool that can POST JSON works. This is the same endpoint the configured clients use.

curl -X POST https://myad.si/api/v1/mcp \
  -H "Authorization: Bearer $MYAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_search_terms_report",
      "arguments": { "accountId": "123-456-7890", "onlyWaste": true }
    }
  }'

Google Ads MCP questions

What is the Google Ads MCP server?

It is a MyAd Model Context Protocol server that lets an AI assistant work on the Google Ads accounts you have connected to MyAd. Every tool answers from the live account, and list_accounts shows which accounts a key or an app may use.

Can the AI actually change my campaigns?

Yes, within limits. Pausing a campaign, ad group or ad, adding negative keywords, pausing keywords, and lowering a daily budget or a keyword bid run at once. Enabling something paused, adding keywords, or raising a budget or bid can add spend, so each becomes a request you approve in MyAd within 48 hours. Campaigns MyAd's autopilot (托管) manages are refused.

How do I authenticate?

With an API key from MyAd, scoped to read or to write and limited to the accounts you choose, or by connecting an app over OAuth. Write tools need a key with write scope.

Do I need the MyAd dashboard?

Yes. Accounts are connected there, keys are created there, and the change requests that need your approval are decided there.

Which Google Ads campaign types are supported?

The read tools report the account's campaigns, ad groups, ads, keywords and reports whatever the campaign type. The write tools are pausing and enabling, keywords and negatives, one campaign's daily budget and one keyword's bid.

Connect Google Ads to your AI assistant

Connect Google Ads and Meta Ads in under 60 seconds. Spot wasted budget, improve ROAS, and automate the busywork.

  • No credit card
  • Read-only by default
  • Cancel anytime