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.
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.
{
"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
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_accountsReadThe Google Ads and Meta accounts this key or app may use, with the accountId every other tool takes.
check_account_capabilitiesReadWhat MyAd can do in the account now: connection, data access, status, billing, conversion tracking and which changes wait for approval.
get_accountReadOne account for a date range: spend, clicks, impressions, conversions, value and the rates, plus live Google Ads facts.
get_account_healthReadThe latest saved MyAd health check: score, each dimension's grade, open recommendations and data gaps.
run_auditReadRuns a new health check now, one per account every 30 minutes, and returns its score and recommendations.
get_business_profileReadThe 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_recommendationsReadOpen recommendations with the recommendationId the apply and dismiss tools take, the plan and whether applying needs approval.
list_change_historyReadChanges made to this account through MyAd, newest first, with what changed, the result and who decided.
get_change_statusReadOne change request: pending, applying, applied, rejected, failed or expired, and when a pending one expires.
apply_recommendationMakes changesApplies an open recommendation: one that does not add spend runs at once, one that adds spend waits for the owner.
dismiss_recommendationMakes changesDismisses 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_periodsReadTotals for a date range and the same-length period before it, with the change in percent.
get_metrics_timeseriesReadDaily spend, clicks, impressions, conversions, value and the rates, oldest day first.
list_campaignsReadCampaigns with spend, clicks, impressions, conversions, value, the rates and budget; on Google it marks campaigns MyAd's autopilot (托管) manages.
list_ad_groupsReadAd groups (Meta: ad sets) with spend, clicks, impressions, conversions, value, the rates and their campaign.
list_adsReadAds with spend, clicks, impressions, conversions, value, the rates, status and ad text, plus Google approval status and policy reasons.
get_geo_reportReadSpend, clicks, impressions, conversions, value and the rates per country, region or city.
get_device_reportReadSpend, clicks, impressions, conversions, value, the rates and each device's share of spend.
get_schedule_reportReadSpend, 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_keywordsReadKeywords with spend, clicks, conversions, the real average CPC, the max CPC bid, Quality Score and its three parts.
get_search_terms_reportReadThe real search terms that got clicks, with spend, clicks, conversions and average CPC; onlyWaste keeps terms with no conversions.
list_negative_keywordsReadCampaign and ad group negatives with their match type, plus the shared negative lists the campaigns use.
add_negative_keywordsMakes changesAdds up to 20 exact-match negatives to a campaign at once, so those searches stop showing its ads.
pause_keywordsMakes changesPauses up to 20 keywords at once.
enable_keywordsMakes changesAsks the owner to turn up to 20 paused keywords back on; it waits for approval.
add_keywordsMakes changesAsks 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 changesSets 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_summaryReadThis month's budgets: daily amount, shared or not, the campaigns that spend each one and their spend so far.
get_bid_strategyReadEach campaign's bid strategy type, portfolio and the targets set in the account.
list_ad_extensionsReadSitelinks, callouts, structured snippets and calls at account, campaign and ad group level.
list_conversion_actionsReadEvery 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 changesSets 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 changesPauses a campaign at once.
pause_ad_groupMakes changesPauses an ad group (Meta: ad set) at once.
pause_adMakes changesPauses one ad at once.
enable_campaignMakes changesAsks the owner to turn a paused campaign back on; it starts spending, so it waits for approval.
enable_ad_groupMakes changesAsks the owner to turn a paused ad group (Meta: ad set) back on; it waits for approval.
enable_adMakes changesAsks 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