krystalview-mcp 0.1.5

KrystalView MCP Server — AI agent access to website analytics, session replay, funnels, campaigns, errors, and anomaly detection.

KrystalView MCP Server

Give your AI agents direct access to website analytics. Query visitor sessions, investigate UX friction, analyze conversion funnels, review campaigns and errors, and get anomaly alerts — all from Claude, Cursor, or any MCP-compatible client.

Quick Start

Install

pip install krystalview-mcp

Configure

Generate an API key in your KrystalView console under Settings > API Keys.

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "krystalview": {
      "command": "krystalview-mcp",
      "env": {
        "KRYSTALVIEW_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

claude mcp add krystalview -- krystalview-mcp
# Then set your API key:
export KRYSTALVIEW_API_KEY="your-api-key-here"

Cursor

Add to your MCP settings:

{
  "krystalview": {
    "command": "krystalview-mcp",
    "env": {
      "KRYSTALVIEW_API_KEY": "your-api-key-here"
    }
  }
}

Available Tools

Tool	Description
get_sessions	List/search visitor sessions with filters (device, location, friction, rage clicks)
get_session_detail	Deep dive into a specific session — full timeline, events, navigation path
get_site_stats	Aggregate performance metrics — sessions, friction, devices, top pages
get_scroll_depth	Scroll-depth buckets for a specific page path
get_live_visitors	Currently active visitor count and recent live sessions
get_anomalies	AI-detected anomalies with explanations (traffic spikes/drops, friction surges)
get_funnels	List defined conversion funnels
get_funnel_analysis	Step-by-step funnel conversion rates and drop-off analysis
get_campaign_summary	UTM campaign attribution summary
get_campaign_sessions	Visitor sessions from a specific campaign
get_campaign_roas	Paid campaign spend, conversions, and ROAS where connected
get_errors	Aggregated client-side browser errors
get_notifications	Recent KrystalView notifications and insights

Example Prompts

Once connected, try asking your AI assistant:

• "How's my site performing this week?"
• "Show me frustrated mobile users from the last 24 hours"
• "Why did our traffic drop yesterday?"
• "Where are users dropping off in the checkout funnel?"
• "Find sessions with rage clicks on the pricing page"
• "Which campaigns are driving the most high-friction sessions?"
• "Show me unresolved browser errors with sample session IDs"
• "Are there any anomalies I should know about?"

Environment Variables

Variable	Required	Default	Description
KRYSTALVIEW_API_KEY	Yes	—	Your KrystalView API key
KRYSTALVIEW_BASE_URL	No	https://krystalview.com/api	API base URL
KRYSTALVIEW_TIMEOUT	No	15	Request timeout in seconds

Rate Limits

API keys have configurable rate limits (default: 60 requests per minute). Rate limit headers are included in every response. If you hit the limit, the server returns a clear error with retry timing.

Security

• API keys are scoped to a single site — agents can only access data for the site the key was created for
• Tools are read-only
• All requests use HTTPS
• Keys can be rotated or revoked in the KrystalView console
• No data is stored by the MCP server — it proxies directly to the KrystalView API

License

MIT