KrystalView Analytics

io.github.KrystalViewPublished by GitHub account KrystalViewv0.1.6Updated Oct 24, 2026

Read-only MCP access to sessions, funnels, campaigns, errors, live visitors, and anomalies.

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Read-only MCP access to KrystalView website analytics: visitor sessions, funnels, campaigns, errors, live visitors and anomalies.

What you can do
  • List and inspect visitor sessions, with filters for URL, country, device, duration, friction and rage clicks, plus full session timelines and events
  • Read aggregate site metrics, scroll-depth reach for a page path, and currently active visitors
  • List conversion funnels and analyze step reach, drop-off and completion evidence
  • Review campaign attribution by UTM source, medium and sessions, campaign sessions, and paid spend with ROAS where ad data is connected
  • Get aggregated browser errors with affected paths and sample sessions, detected traffic, friction, bounce and conversion anomalies, and recent notifications
When to use it
Useful when you want an assistant to answer questions about a site's traffic and UX quality — why traffic dropped, where users abandon a funnel, which campaigns bring high-friction sessions, or which browser errors are unresolved — without opening the KrystalView dashboard.
Requirements
Either the hosted remote endpoint with OAuth (no local install) or the local PyPI package krystalview-mcp run over stdio, which needs Python and the KRYSTALVIEW_API_KEY environment variable. Optional KRYSTALVIEW_BASE_URL and KRYSTALVIEW_TIMEOUT. A KrystalView account and API key generated in the console; network access to the KrystalView API.
Before you install
Requires a KrystalView API key (KRYSTALVIEW_API_KEY) or an OAuth token; keys and tokens are scoped to a single site and read-only, and can be rotated or revoked in the console. Tools are read-only, but the data returned includes visitor sessions, device context, campaign and ad spend figures, and error details, which are sent to the AI client. API keys have configurable rate limits, default 60 requests per minute.

Installation

In SourceWeft

  1. Open KrystalView Analytics in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.KrystalView%2Fkrystalview/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "krystalview-analytics": {
      "type": "http",
      "url": "https://krystalview.com/mcp"
    }
  }
}

README

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.

Connection Options

Hosted Remote MCP

Use this when your client supports remote MCP servers or connector-style OAuth. No local package install is required.

FieldValue
Endpointhttps://krystalview.com/mcp
Transportstreamable-http
AuthenticationOAuth authorization code + PKCE
OAuth metadatahttps://krystalview.com/.well-known/oauth-authorization-server
Protected resource metadatahttps://krystalview.com/.well-known/oauth-protected-resource

During OAuth, KrystalView asks the signed-in user to choose the site the MCP client can read. The issued token is read-only and scoped to that site. The hosted OAuth server supports dynamic client registration, authorization code + PKCE, resource indicators, refresh-token rotation, and token revocation.

For clients that support custom headers instead of OAuth, the hosted endpoint also accepts a KrystalView read API key as either:

http
Authorization: Bearer kv_live_...

or:

http
X-API-Key: kv_live_...

Local stdio MCP Package

Use this when your MCP client runs local stdio servers, such as Claude Desktop, Claude Code, Cursor, or similar developer tools.

Install

bash
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:

json
{  "mcpServers": {    "krystalview": {      "command": "krystalview-mcp",      "env": {        "KRYSTALVIEW_API_KEY": "your-api-key-here"      }    }  }}
Claude Code
bash
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:

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

Available Tools

ToolDescription
get_sessionsList/search visitor sessions with filters (device, location, friction, rage clicks)
get_session_detailDeep dive into a specific session — full timeline, events, navigation path
get_site_statsAggregate performance metrics — sessions, friction, devices, top pages
get_scroll_depthScroll-depth buckets for a specific page path
get_live_visitorsCurrently active visitor count and recent live sessions
get_anomaliesAI-detected anomalies with explanations (traffic spikes/drops, friction surges)
get_funnelsList defined conversion funnels
get_funnel_analysisStep-by-step funnel conversion rates and drop-off analysis
get_campaign_summaryUTM campaign attribution summary
get_campaign_sessionsVisitor sessions from a specific campaign
get_campaign_roasPaid campaign spend, conversions, and ROAS where connected
get_errorsAggregated client-side browser errors
get_notificationsRecent 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

VariableRequiredDefaultDescription
KRYSTALVIEW_API_KEYYes—Your KrystalView API key
KRYSTALVIEW_BASE_URLNohttps://krystalview.com/apiAPI base URL
KRYSTALVIEW_TIMEOUTNo15Request 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
  • OAuth tokens issued by the hosted MCP endpoint are read-only and scoped to the selected site
  • Hosted OAuth supports refresh-token rotation and token revocation
  • Browser-originating MCP/OAuth requests are checked against explicit trusted origins
  • Tools are read-only
  • All requests use HTTPS
  • Keys can be rotated or revoked in the KrystalView console
  • The local stdio package stores no data — it proxies directly to the KrystalView API

License

MIT

Source: README.md at commit f4df256

Tools

13

get_sessions

List Sessions

List recent visitor sessions with filters for URL, country, device, duration, friction, and rage clicks.

Parameterslimitqueryoffsetcountrydevice_typemin_durationmin_frictionhas_rage_clicks

get_session_detail

Get Session Detail

Get full details for a specific visitor session, including pages, events, device context, errors, and friction signals.

Parameterssession_idrequired

get_site_stats

Get Site Stats

Get aggregate site metrics including all sessions, likely human sessions, likely bot/crawler sessions, duration, friction, rage clicks, daily counts, device mix, and top pages.

Parametersdays

get_scroll_depth

Get Scroll Depth

Get cumulative scroll-depth reach buckets for a specific page path.

Parametersdayspathrequired

get_live_visitors

Get Live Visitors

Get currently active visitors and sessions seen in the live activity window.

Takes no parameters.

get_anomalies

Get Anomalies

List detected traffic, friction, bounce, and conversion anomalies for the site.

Parameterslimitunacknowledged_only

get_funnels

List Funnels

List conversion funnels defined for this site.

Takes no parameters.

get_funnel_analysis

Analyze Funnel

Analyze a conversion funnel and show step reach, drop-off, and completion evidence.

Parametersdaysfunnel_idrequired

get_campaign_summary

Get Campaign Summary

Get campaign attribution breakdown by UTM campaign, source, medium, sessions, duration, and bounce rate.

Parametersdays

get_campaign_sessions

Get Campaign Sessions

List sessions attributed to a specific marketing campaign.

Parameterslimitoffsetcampaignrequired

get_campaign_roas

Get Campaign ROAS

Get paid campaign spend, clicks, sessions, attributed conversions, and ROAS where ad data is connected.

Parametersdays

get_errors

Get Browser Errors

Get aggregated browser errors grouped by type and message, with affected paths and sample sessions.

Parameterslimiterror_typeunresolved_only

get_notifications

Get Notifications

Get recent KrystalView notifications such as insights, setup notices, errors, and anomalies.

Parameterslimitoffsetunread_only

Version history

1
  1. v0.1.6LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts