List all Microsoft Advertising accounts the signed-in user can access (id, name, number, customer id). Start here to get an account_id.

List campaigns in an account: id, name, status, type, daily budget.

List ad groups in a campaign: id, name, status, cpc bid.

List keywords in an ad group: id, text, match type, status, bid.

List ads in an ad group: id, type, status, final urls.

List campaign-level negative keywords (id, text, match type).

Pull a performance report. Numbers come back already typed (floats/ints; percentages as plain numbers, e.g. 1.89 means 1.89%).

Args: account_id: Ads account id. report_type: account | campaign | ad_group | ad | keyword | search_term | geographic. - search_term = actual user search queries (best for finding waste + new keywords) - keyword / ad_group / ad = entity performance incl. quality score - geographic = performance by country/state/city predefined_time: Today, Yesterday, LastSevenDays, Last14Days, Last30Days, ThisWeek, LastWeek, LastFourWeeks, ThisMonth, LastMonth, LastThreeMonths, LastSixMonths, ThisYear, LastYear. Ignored if start_date+end_date given. start_date / end_date: custom range YYYY-MM-DD (both required for custom). aggregation: Summary, Daily, Weekly, Monthly, Hourly (TimePeriod column is auto-dropped for Summary). campaign_ids: optional scope to specific campaigns. columns: optional explicit column list (defaults are sensible per report).

Find search terms that burned money with little/no return — spend >= min_spend and conversions <= max_conversions — sorted by spend descending. These are prime candidates to add as negative keywords.

Pause or enable a campaign. status = "Active" or "Paused". WARNING: "Active" lets the campaign spend. Confirm with the user first.

Set a campaign's daily budget (account currency). WARNING: raising budget raises potential spend. Confirm increases with the user.

Pause or enable an ad group. status = "Active" or "Paused".

Update a keyword's status ("Active"/"Paused") and/or bid (account currency). Provide at least one of status or bid.

Add campaign-level negative keywords to stop ads showing for those terms. match_type = "Exact" or "Phrase". Returns the new negative keyword ids.

Remove campaign-level negative keywords by id (from list_negative_keywords).

List account-level negative-keyword lists (shared across campaigns): id, name, how many campaigns it's attached to, and item count.

Add negative keywords to a shared list (applies to every campaign the list is attached to). Prefer this over per-campaign negatives when an account uses a shared negatives list. match_type = "Exact" or "Phrase".

Create a Search campaign (Manual CPC). Defaults to PAUSED so it never spends until you explicitly enable it. Returns the new campaign_id.

Create an ad group in a campaign (English, given default CPC bid). Defaults to PAUSED. Returns the new ad_group_id.

Add keywords to an ad group. Each item: {text, match_type (Broad|Phrase|Exact), bid (optional float), status (optional, default Active)}. Returns new keyword ids.

Add a Responsive Search Ad. Needs 3-15 headlines (<=30 chars each) and 2-4 descriptions (<=90 chars each). path1/path2 are optional display-url paths. Returns the new ad id.

One-call health snapshot: account KPIs + per-campaign breakdown + flags (zero-conversion spenders, campaigns losing impressions to budget). Best starting point for "how are my ads doing?".

Compare the last days days vs the immediately preceding days days. Returns each metric's current, prior, delta, and % change. report_type: account (default) or campaign/keyword/etc. for the totals scope.

Audit the account and return a prioritized action list plus the supporting detail: wasted search terms, wasted keywords, low-quality-score keywords, keywords above target CPA (if target_cpa given), top keywords to scale, and campaigns limited by budget. Read-only — suggests, doesn't change anything.

Find wasted search terms (spend with no conversions) and add them as campaign negative keywords. dry_run=True (default) returns the plan only; set dry_run=False to actually apply. Confirm with the user before applying.

Converting search queries that aren't already exact keywords — suggestions to add as keywords (with the ad group they triggered in). The growth mirror of find_wasted_spend.

Create a full Search campaign in one call: campaign + ad group + keywords + a Responsive Search Ad. Everything is created PAUSED. keywords may be plain strings or {text, match_type, bid} objects. Needs 3-15 headlines and 2-4 descriptions for the ad.