HYPD.AI Search Ads

The account's conversion goals — types, counting settings, revenue values, and statuses. Relevant when conversion columns in reports look empty or double-counted; partial_errors reports goals Microsoft could not return.

msads_list_conversion_goals

The images in the account's media library: each one's id, width and height in pixels, and a URL to view it. Pass image_ids for just those. Performance Max asset groups link them by id, by shape: landscape 1.91:1 (at least 703x368), square 1:1 (470x470), portrait 1:2 (470x940), wide 4:1 (608x152), logos 1:1 (128x128), landscape logos 4:1 (512x128). Nothing is uploaded; pick ids here for msads_draft_campaign_build.

msads_list_images

The keywords of one ad group — text, match type, bid, and status. Takes the ad_group_id from msads_list_ad_groups; for what actually got searched, use msads_get_search_terms instead.

msads_list_keywords

The account's shared negative keyword lists — ids, names and item counts: what the account is deliberately NOT bidding on. Useful when search terms leak through despite negatives; a list's negative keywords and campaigns are on msads_get_negative_keyword_lists.

msads_list_negative_keyword_lists

The negative keywords set on ad groups or campaigns themselves, with their ids, text and match type: what msads_draft_keyword_changes removes by id. Pass entity_type (ad_group or campaign) and up to 50 entity_ids; for ad groups also campaign_id, the campaign they are all in. Shared lists are on msads_list_negative_keyword_lists instead; partial_errors names an entity Microsoft could not read.

msads_list_negative_keywords

The account's portfolio bid strategies: each one's id, name, scheme (e.g. MaxConversions), target CPA, target ROAS (a ratio, 4 is 400%) or max CPC, and the campaigns on it. Pass bid_strategy_ids (up to 100) for just those; a campaign's own strategy is on msads_list_campaigns rows.

msads_list_bid_strategies

The account's shared budgets — amounts, types, and which campaigns draw on them; partial_errors reports budgets Microsoft could not return. Campaign-level budgets appear on msads_list_campaigns rows instead.

msads_list_budgets

Returns the Microsoft Ads guide — call it first in a new conversation. Covers what each msads_* tool reads, the workflow (list accounts, walk campaign structure, then run performance reports), what to do when no accounts are connected, and starter prompts.

init

Performance Max asset-group performance for one account over a date window — the PMax counterpart to campaign performance. Rows are CSV records (every value a string), columns lists the header order, and truncated flags a cut-off result — narrow the window when it is true.

msads_get_asset_group_performance

Campaign-level performance for one account over a date window: impressions, clicks, spend, conversions, and revenue per campaign. Rows are CSV records (every value a string), columns lists the header order, and truncated flags a cut-off result — narrow the window when it is true.

msads_get_campaign_performance

Keyword-level performance for one account over a date window: impressions, clicks, spend, conversions, and quality signals per keyword. Rows are CSV records (every value a string), columns lists the header order, and truncated flags a cut-off result — narrow the window when it is true.

msads_get_keyword_performance

The actual search queries that triggered the account's ads over a date window, with per-term performance — the raw material for negative keywords and match-type decisions. Rows are CSV records (every value a string), columns lists the header order, and truncated flags a cut-off result — narrow the window when it is true.

msads_get_search_terms

Searches HYPD's help center for articles that answer a question about HYPD itself: connecting or reconnecting ad accounts, plans, billing and credits, privacy and data access, what HYPD can do, and setting HYPD up in Claude, ChatGPT or other AI clients. Returns the matching articles' text and links; answer from them and cite them. Not for advertising advice or the user's account data; use the platform tools for those.

hypd_search_help