Content Insights

Insights are AI-generated observations about your content performance. They surface patterns and opportunities you might miss from looking at raw metrics.

Insight types

Type	Description
top_performer	A piece of content is significantly outperforming your average engagement rate
posting_time	A consistent pattern in which days or hours produce better engagement
topic_cluster	A set of topics that consistently drive high engagement
platform_shift	Engagement is rising on one platform and declining on another
decay_alert	A high-performing piece of older content is losing engagement and may benefit from a follow-up
strategy_suggestion	A synthesized recommendation based on multiple signals

Insight severity

Severity	Meaning
opportunity	Something you could do to improve
info	An interesting pattern worth knowing
warning	Something declining or at risk

Viewing insights

Insights appear in the insights panel on the analytics dashboard. Each card shows the type, severity, a title, and a description with specific data points.

Acting on insights

Each insight includes an action button. Depending on the type:

• Top performer insights link to the content item so you can study what worked
• Topic cluster insights open a pre-filled brief for a follow-up piece on the same topic
• Posting time insights show recommended posting times and link to the scheduling panel
• Decay alerts link to the original content and suggest a refresh or repurpose

Generating insights via MCP

{
  "tool": "get_insights",
  "arguments": {
    "limit": 10
  }
}

Returns active (non-dismissed) insights sorted by severity and recency.

Dismissing insights

Insights can be dismissed once you have acted on them or if they are not relevant.

{
  "tool": "dismiss_insight",
  "arguments": {
    "insightId": "insight_abc123"
  }
}

Dismissed insights do not reappear.

Insights from analytics

The suggest_brief_from_analytics tool takes a step further -- it analyzes your top-performing content and generates a complete brief (not just an insight) that you can immediately generate content from.

{
  "tool": "suggest_brief_from_analytics",
  "arguments": {
    "platform": "linkedin"
  }
}