Tools reference
The full list of MCP tools, grouped by category.
MyAd exposes 38 MCP tools over the Model Context Protocol. Each takes a JSON object of arguments and returns structured content. 24 of them only read the account; 14 can change it.
“Any” means the tool works with any connected account. “Google Ads” and “Google Ads, Meta” mean it only works on that platform’s accounts: 22 of the 38 work with Meta, and with the tools that have no platform all 38 work with Google Ads.
Accounts & health
| Tool | What it does | Access | Platforms |
|---|---|---|---|
list_accounts |
The accounts this key or app may use, with the accountId every other tool takes. Call it first. |
Read | Any |
check_account_capabilities |
What MyAd can do in the account now: connection, data access, status, billing, conversion tracking and which changes wait for approval. | Read | Google Ads, Meta |
get_account |
One account for a date range: spend, clicks, impressions, conversions, value and the rates, plus live platform facts. | Read | Google Ads, Meta |
get_account_health |
The latest saved health check: score, each dimension’s grade, open recommendations and data gaps. | Read | Google Ads, Meta |
run_audit |
Runs a new health check now, one per account every 30 minutes, and returns its score and recommendations. | Read | Google Ads, Meta |
get_business_profile |
The owner’s saved business profile: name, website, industry, customers, selling points and competitors. | Read | Any |
Recommendations & history
| Tool | What it does | Access | Platforms |
|---|---|---|---|
list_recommendations |
Open recommendations with the recommendationId the apply and dismiss tools take, the plan, and whether applying needs approval. |
Read | Google Ads, Meta |
list_change_history |
Changes made to this account through MyAd, newest first, with what changed, the result and who decided. | Read | Google Ads, Meta |
get_change_status |
One change request: pending, applying, applied, rejected, failed or expired, and when a pending one expires. | Read | Any |
apply_recommendation |
Applies an open recommendation: without added spend it runs at once, with added spend it waits for the owner. | Write | Google Ads, Meta |
dismiss_recommendation |
Dismisses an open recommendation so it leaves the list; nothing in the ad account changes. | Write | Google Ads, Meta |
Performance reports
| Tool | What it does | Access | Platforms |
|---|---|---|---|
compare_periods |
Totals for a date range and the same-length period before it, with the change in percent. | Read | Google Ads, Meta |
get_metrics_timeseries |
Daily spend, clicks, impressions, conversions, value and the rates, oldest day first. | Read | Google Ads, Meta |
list_campaigns |
Campaigns with spend, clicks, impressions, conversions, value, the rates and budget; on Google it marks campaigns MyAd’s autopilot (托管) manages. | Read | Google Ads, Meta |
list_ad_groups |
Ad groups (Meta: ad sets) with spend, clicks, impressions, conversions, value, the rates and their campaign. | Read | Google Ads, Meta |
list_ads |
Ads with spend, clicks, impressions, conversions, value, the rates, status and ad text, plus Google approval status and policy reasons; Meta adds frequency and CTR against the previous period. | Read | Google Ads, Meta |
get_geo_report |
Spend, clicks, impressions, conversions, value and the rates per country, region or city. | Read | Google Ads |
get_device_report |
Spend, clicks, impressions, conversions, value, the rates and each device’s share of spend. | Read | Google Ads |
get_schedule_report |
Spend, clicks, impressions, conversions, value and the rates per weekday or per hour. | Read | Google Ads |
Keywords & search terms
| Tool | What it does | Access | Platforms |
|---|---|---|---|
list_keywords |
Keywords with spend, clicks, conversions, the real average CPC, the max CPC bid, Quality Score and its three parts. | Read | Google Ads |
get_search_terms_report |
The real search terms that got clicks, with spend, clicks, conversions and average CPC; onlyWaste keeps terms with no conversions. |
Read | Google Ads |
list_negative_keywords |
Campaign and ad group negatives with their match type, plus the shared negative lists the campaigns use. | Read | Google Ads |
add_negative_keywords |
Adds up to 20 exact-match negatives to a campaign at once, so those searches stop showing its ads. | Write | Google Ads |
pause_keywords |
Pauses up to 20 keywords at once. | Write | Google Ads |
enable_keywords |
Asks the owner to turn up to 20 paused keywords back on. | Write | Google Ads |
add_keywords |
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. | Write | Google Ads |
update_keyword_bid |
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. | Write | Google Ads |
Budgets, bids & assets
| Tool | What it does | Access | Platforms |
|---|---|---|---|
get_budget_summary |
This month’s budgets: daily amount, shared or not, the campaigns that spend each one and their spend so far. | Read | Google Ads |
get_bid_strategy |
Each campaign’s bid strategy type, portfolio and the targets set in the account. | Read | Google Ads |
list_ad_extensions |
Sitelinks, callouts, structured snippets and calls at account, campaign and ad group level. | Read | Google Ads |
list_conversion_actions |
Every conversion action with status, type, counting, whether it counts in the Conversions column, and its numbers. | Read | Google Ads |
Changes
| Tool | What it does | Access | Platforms |
|---|---|---|---|
set_campaign_budget |
Sets a campaign’s own daily budget in the account currency (shared budgets are refused): lower runs at once, higher waits for the owner and may at most double it. | Write | Google Ads |
pause_campaign |
Pauses a campaign at once. | Write | Google Ads, Meta |
pause_ad_group |
Pauses an ad group (Meta: ad set) at once. | Write | Google Ads, Meta |
pause_ad |
Pauses one ad at once. | Write | Google Ads, Meta |
enable_campaign |
Asks the owner to turn a paused campaign back on; it starts spending, so it waits for approval. | Write | Google Ads, Meta |
enable_ad_group |
Asks the owner to turn a paused ad group (Meta: ad set) back on. | Write | Google Ads, Meta |
enable_ad |
Asks the owner to turn a paused ad back on. | Write | Google Ads, Meta |
How changes are approved
Pausing a campaign, ad group, ad or keyword; adding negative keywords; lowering a daily budget or a keyword bid; and a recommendation that does not add spend all run at once. Anything that can add spend — enabling a paused campaign, ad group, ad or keywords, adding keywords, a higher budget or bid (at most 2× in one request), or a recommendation that adds spend — becomes a pending request the account owner approves or rejects in MyAd within 48 hours; after that it expires. Approval reads the account again and refuses a stale request, and a request that adds spend needs an extra confirmation. Campaigns MyAd’s autopilot (托管) manages are refused. Every change that ran appears in list_change_history and in MyAd’s change log (数据 → 优化记录), and get_change_status reports one request.
Live directory
The API serves the same catalogue:
curl -s https://myad.si/api/v1/tools
{
"success": true,
"data": {
"count": 38,
"tools": [
{
"name": "list_accounts",
"title": "List ad accounts",
"description": "The Google Ads and Meta ad accounts this key or app may use, with the accountId every other tool takes, …",
"scope": "read",
"platforms": null,
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
},
"inputSchema": { "type": "object", "properties": {} }
}
]
}
}
scope is read or write, platforms is a list such as ["google_ads", "meta_ads"] or null when the tool is not tied to one platform, and annotations and inputSchema are the MCP fields of the same tool. The example shows only the first entry; the rest follow in the same order as tools/list.
Example call
curl -s 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":"list_accounts","arguments":{}}}'