Skip to content

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":{}}}'