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. The explicit writes are watch_competitor / unwatch_competitor, update_brand_kit, save_site_source, resync_site_source, update_growth_delivery, update_geo_workspace and upsert_ai_visibility_prompts (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), because anonymous org API keys can’t spend money.

Tools#

Tool	Purpose
`list_ad_accounts`	Every connected ad account in the org, across all platforms
`get_dashboard_snapshot`	ABI score & band, waste %, safe-budget-to-add, efficiency, totals, recent-impact
`get_impact_analysis`	Week-over-week metric shifts correlated with recent decisions
`get_competitor_pressure`	Attribute an impression-share drop to competitors’ ad-library ramp
`list_guidelines`	The organization’s guideline docs
`get_guideline`	Full markdown content of one guideline by slug
`get_brand_kit`	The brand kit (name, logos, palette, fonts, footer) and where each value comes from
`update_brand_kit`	Change the brand kit (settings-page parity; user-bound; write)
`list_suggestions`	AI-generated suggested-action cards (the dashboard sidebar feed)
`get_suggestion`	One suggested action with its full context blob
`get_creative_insights`	Insights rollups: angle/mix/fatigue/velocity
`get_strategy_session`	The Brand Profile session + live brief markdown
`list_strategy_claims`	Branch-scoped strategy claims (the canvas as data)
`list_strategy_proposals`	Pending agent-proposed strategy changes
`list_watched_competitors`	The Competitors list + strategy competitors not yet watched
`list_competitor_ads`	Browse a watched competitor’s captured ads (cached; media URLs included)
`watch_competitor`	Start watching a business’s ads (billed sync credit; write)
`unwatch_competitor`	Stop watching (soft; free; write)
`list_audit_events`	What has been done on the organization’s behalf, newest first
`list_organic_properties`	The organization’s site sources (websites) with their data connections and sync state
`get_organic_overview`	Organic search and AI-assistant referral sessions for a site, against the prior window
`get_organic_page_metrics`	One page’s Search Console and GA4 landing-page metrics plus its inventory row
`inspect_page`	Live Search Console URL Inspection for one page (uses Google’s daily quota)
`get_organic_performance`	Search Console clicks, impressions, CTR and position by date, page or query
`get_site_inventory`	The site’s known pages, their declared tags, index state, traffic and issues
`get_ai_visibility`	How often AI assistants mention, recommend or cite the brand (GEO)
`get_geo_workspace`	The selected site’s GEO workspace (optionally with research candidates)
`update_geo_workspace`	Apply a reviewed, site-scoped GEO change (write)
`list_ai_visibility_answers`	The raw AI answers behind the visibility rates, with scoring
`list_ai_visibility_prompts`	The prompts the weekly AI-visibility probe asks
`upsert_ai_visibility_prompts`	Add or remove AI-visibility probe prompts (changes probe cost; write)
`get_growth_evidence`	A reproducible paid, SEO, GA4 and GEO evidence bundle for a date window
`list_site_connection_options`	Google Analytics and Search Console connections available for a site
`save_site_source`	Create or update a site and its data connections (write)
`resync_site_source`	Retry source synchronization for a site (write)
`update_growth_delivery`	Save a site recommendation’s delivery brief or implementation (write)
`get_growth_delivery`	A site recommendation’s delivery brief, implementation and crawl observations

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
adlyse.audit_events@v1
adlyse.organic_snapshot@v1
adlyse.organic_search@v1
adlyse.site_inventory@v1
adlyse.ai_visibility@v2

Common errors#

`error_type`	Typical cause
`auth_error`	Missing, invalid, or revoked API key
`not_found`	The ad account / guideline / competitor doesn’t belong to your org
`validation_error`	Malformed `as_of` date or other invalid parameter
`computation_error`	Impact analysis failed (usually missing data)
`entitlement_error`	The plan doesn’t include the feature (`watch_competitor`)
`invalid_input`	Watch request with no resolvable company website
`user_credential_required`	A person-attributed write (`watch_competitor`, `update_brand_kit`) called with an anonymous org API key
`permission_denied`	`update_brand_kit` by a user who cannot manage the organization