Skip to content
AdlyseMCP Docs
Product guideMCP reference
⌘K
Open Adlyse
⌘K
Overview
QuickstartAuthentication
adlyse-insights
list_ad_accountsget_dashboard_snapshotget_impact_analysislist_guidelinesget_guideline
adlyse-reports
adlyse-ads
adlyse-workflows
adlyse-adminadlyse-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