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
adlyse-insights

adlyse-insights

Endpoint: https://mcp.adlyse.com/mcp/insights/

Exposes Adlyse’s proprietary performance-marketing judgments — ABI, waste, safe-budget, recent-impact, competitor intelligence — plus brand guidelines and the suggestion feed. This is the moat: no ad platform surfaces these judgments themselves.

Read-mostly: watch_competitor / unwatch_competitor are the only explicit writes (and get_competitor_pressure’s cold path can auto-discover and subscribe competitors). watch_competitor is billed and requires a user-bound credential (OAuth or personal API key) — anonymous org API keys can’t spend money.

Tools#

ToolPurpose
list_ad_accountsEvery connected ad account in the org, across all platforms
get_dashboard_snapshotABI score & band, waste %, safe-budget-to-add, efficiency, totals, recent-impact
get_impact_analysisWeek-over-week metric shifts correlated with recent decisions
get_competitor_pressureAttribute an impression-share drop to competitors’ ad-library ramp
list_guidelinesThe organization’s guideline docs
get_guidelineFull markdown content of one guideline by slug
list_suggestionsAI-generated suggested-action cards (the dashboard sidebar feed)
get_suggestionOne suggested action with its full context blob
get_creative_insightsCreative analytics rollups: angle/mix/fatigue/velocity
get_strategy_sessionThe Brand Profile session + live brief markdown
list_strategy_claimsBranch-scoped strategy claims (the canvas as data)
list_strategy_proposalsPending agent-proposed strategy changes
list_watched_competitorsThe Brand Watch list + strategy competitors not yet watched
list_competitor_adsBrowse a watched competitor’s captured ads (cached; media URLs included)
watch_competitorStart watching a business’s ads (billed sync credit; write)
unwatch_competitorStop watching (soft; free; write)

Source tags#

Responses from this server carry one of these source values:

  • adlyse.ad_accounts@v1
  • adlyse.dashboard_compute@v1
  • adlyse.impact_analysis@v1
  • adlyse.competitor_pressure@v1
  • adlyse.guidelines@v1
  • adlyse.suggestions@v1
  • adlyse.creative_insights@v1
  • adlyse.strategy@v1
  • adlyse.brand_watch@v1

Common errors#

error_typeTypical cause
auth_errorMissing, invalid, or revoked API key
not_foundThe ad account / guideline / competitor doesn’t belong to your org
validation_errorMalformed as_of date or other invalid parameter
computation_errorImpact analysis failed (usually missing data)
entitlement_errorThe plan doesn’t include the feature (watch_competitor)
invalid_inputWatch request with no resolvable company website
user_credential_requiredBilled write (watch_competitor) called with an anonymous org API key
PreviousAuthenticationNextlist_ad_accounts