Skip to content
AdlyseDocs
Product guideMCP reference
⌘K
Open Adlyse
⌘K
Overview
QuickstartAuthentication
adlyse-insights
list_ad_accountsget_dashboard_snapshotget_impact_analysisget_competitor_pressurelist_guidelinesget_brand_kitupdate_brand_kitsave_brand_assetget_guidelinelist_suggestionsget_suggestionget_strategy_sessionlist_strategy_claimslist_strategy_proposalsget_creative_insightslist_watched_competitorslist_competitor_adswatch_competitorunwatch_competitorlist_audit_eventslist_organic_propertiesget_organic_overviewget_organic_page_metricsinspect_pageget_organic_performanceget_site_inventorycheck_site_healthget_ai_visibilitylist_ai_visibility_answerslist_ai_visibility_promptsupsert_ai_visibility_promptsrun_ai_visibility_checksget_growth_evidencelist_site_connection_optionslist_site_key_eventssave_site_sourceremove_site_sourceresync_site_sourceupdate_growth_deliveryget_growth_deliveryget_geo_workspaceupdate_geo_workspace
adlyse-ads
adlyse-workflows
adlyse-admin
adlyse-all
  1. Overview
  2. adlyse-insights

list_suggestions

List AI-generated suggested actions for the organization — the same cards surfaced in the Adlyse dashboard sidebar, produced by the suggestion pipeline (e.g. pause a wasteful campaign, raise a budget). Cards from an in-flight pipeline run are hidden so you only see adjudicated rows. Ordered urgent → low, then newest first.

Use get_suggestion for one card’s full context. Accepting/executing a suggestion is done in the Adlyse dashboard.

Parameters#

NameTypeRequiredDefaultDescription
statusstringnopending | accepted | rejected | executed | expired
prioritystringnourgent | high | medium | low
action_typestringnoActionRegistry type filter (e.g. "UPDATE_BUDGET")
limitintegerno50Max cards (max 200)
offsetintegerno0Pagination offset

Returns#

json
{
  "suggestions": [
    {
      "id": "saction_abc123",
      "title": "Pause campaign 'Brand – Broad'",
      "rationale": "14d CPA is $112 vs $40 target…",
      "priority": "high",
      "status": "pending",
      "confidence_score": 0.9,
      "action_type": "PAUSE_ENTITY",
      "action_data": { },
      "source_assistant_id": "assistant_…",
      "source_thread_id": null,
      "expires_at": null,
      "created_at": "2026-07-08T10:00:00+00:00"
    }
  ],
  "total": 12,
  "offset": 0,
  "limit": 50,
  "has_more": false,
  "source": "adlyse.suggestions@v1"
}

The list view omits each card’s (potentially large) context blob — fetch it via get_suggestion.

Errors#

error_typeWhen
auth_errorMissing / invalid API key
Previousget_guidelineNextget_suggestion