Blossom Ads

Health Check

Liveness probe for the blossomads MCP server. Returns a small structured object so an agent (or a connection test) can confirm the server is reachable and which MCP protocol revision it speaks. Read-only; carries no tenant data.

List Accounts

List the Google Ads accounts this connection is scoped to (read-only).

List Recommendations

List pending replacement recommendations for the scoped account (read-only).

Get Recommendation

Get full detail for one recommendation (read-only, tenant-guarded).

Apply

Apply a recommendation to Google Ads (blossomads executes the mutation). Permitted only for accounts in agent_delegated apply mode (no-double-apply, P1); idempotent (P3). Destructive — surface a confirmation to the human before calling. The account-lookup + defensive Google-client construction + apply_core orchestration (G4) lives in `app.mcp.apply_entry.run_apply_entry` — the SAME function the REST `POST /agent/v1/recommendations/{id}/apply` route calls (P2 plan Task 2.1), so the two surfaces

Generate Recommendations

Ask blossomads to generate new recommendations now (P6 addendum). blossomads decides what is actually due — the per-type pacing budgets, and grace gates are never bypassed by this tool (`force` is hard-wired False; there is no way for a caller to set it). Async: returns `{"status": "queued", ...}` immediately; discover results by re-polling `list_recommendations`/`recs list`. Requires the `pipeline:generate` scope (Operator preset only) AND the account owner having enabled agent-triggered gener

List Asset Scores

List per-asset scores, worst first (read-only, tenant-guarded). Latest per-asset score plus a rolling-window aggregate (Monday 3149170088 — "find assets consistently ranked bottom-5"). `ad_group_id`/ `campaign_id` are Google Ads id strings, tenant-scoped via the account they belong to.

Get Score History

Full per-asset daily score matrix for ONE ad group (read-only, tenant-guarded). A single-pass "find my bottom-N assets over time" surface — one call returns every scored asset's day-by-day quality_score series for the requested ad group. `ad_group_id` is a Google Ads id string.

Get Scores Summary

Group-level score rollup (Monday 3149170088 follow-up): one ad group, one campaign's ad groups, or the whole account's ad groups (default). `level` is one of `"ad_group"`, `"campaign"`, `"account"`; `id` is the Google ad-group/campaign id string, REQUIRED for `level="ad_group"` or `"campaign"`, ignored for `"account"`. Includes materialized label-group virtual ad groups (label-group ads Phase 2), marked `is_label_group`/`label_name` -- addressable at `level="ad_group"` by their own `ad_group_id

Decline

Decline a recommendation; records feedback so future cycles learn.