KrystalView Analytics

krystalview/krystalview-mcp

Connects Claude or any MCP client to your KrystalView analytics dashboard via API. Exposes six tools: query visitor sessions with filters for friction signals like rage clicks, pull detailed session timelines, fetch site-wide stats, retrieve AI-detected anomalies with explanations, and analyze conversion funnels for drop-off points. Useful when you want to investigate UX issues or traffic changes conversationally instead of clicking through dashboards. Requires a KrystalView API key scoped to a single site, installed via pip. Rate limited at 60 requests per minute by default, configurable in your console.

tools: 13
auth: Secret needed
transport: STDIO, HTTP
env vars: 2
last updated: Jun 10, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://krystalview.com/mcp --name krystalview

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http krystalview https://krystalview.com/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 13 tools

Verified live against the running server on Nov 6, 2026.

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

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

Parameters* required

countrystring

Country name filter.

device_typestring

Device type filter.one of desktop · mobile

has_rage_clicksboolean

Only sessions with rage clicks.

limitinteger

Maximum results to return.default: 20

min_durationinteger

Minimum session duration in seconds.

min_frictioninteger

Minimum friction score.

offsetinteger

Pagination offset.default: 0

querystring

Search entry or exit URLs, for example /pricing.

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

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

Parameters* required

session_id*string

Session primary key from get_sessions.

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

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.

Parameters* required

daysinteger

Lookback period in days.default: 7

get_scroll_depthGet cumulative scroll-depth reach buckets for a specific page path.2 params

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

Parameters* required

daysinteger

Lookback period in days.default: 30

path*string

Page path to analyze, for example /pricing.

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

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

No parameters. Call it with no arguments.

get_anomaliesList detected traffic, friction, bounce, and conversion anomalies for the site.2 params

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

Parameters* required

limitinteger

Maximum results to return.default: 20

unacknowledged_onlyboolean

Only include unacknowledged anomalies.default: false

get_funnelsList conversion funnels defined for this site.

List conversion funnels defined for this site.

No parameters. Call it with no arguments.

get_funnel_analysisAnalyze a conversion funnel and show step reach, drop-off, and completion evidence.2 params

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

Parameters* required

daysinteger

Lookback period in days.default: 30

funnel_id*integer

Funnel ID from get_funnels.

get_campaign_summaryGet campaign attribution breakdown by UTM campaign, source, medium, sessions, duration, and bounce rate.1 params

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

Parameters* required

daysinteger

Lookback period in days.default: 30

get_campaign_sessionsList sessions attributed to a specific marketing campaign.3 params

List sessions attributed to a specific marketing campaign.

Parameters* required

campaign*string

UTM campaign name.

limitinteger

Maximum results to return.default: 20

offsetinteger

Pagination offset.default: 0

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

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

Parameters* required

daysinteger

Lookback period in days.default: 30

get_errorsGet aggregated browser errors grouped by type and message, with affected paths and sample sessions.3 params

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

Parameters* required

error_typestring

Filter by error type.

limitinteger

Maximum results to return.default: 20

unresolved_onlyboolean

Only include unresolved errors.default: true

get_notificationsGet recent KrystalView notifications such as insights, setup notices, errors, and anomalies.3 params

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

Parameters* required

limitinteger

Maximum results to return.default: 10

offsetinteger

Pagination offset.default: 0

unread_onlyboolean

Only include unread notifications.default: false

Configuration

KRYSTALVIEW_API_KEY*secret

Your KrystalView API key (generate in console under Settings > API Keys)

KRYSTALVIEW_BASE_URL

API base URL (default: https://krystalview.com/api)

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.

Field	Value
Endpoint	`https://krystalview.com/mcp`
Transport	`streamable-http`
Authentication	OAuth authorization code + PKCE
OAuth metadata	`https://krystalview.com/.well-known/oauth-authorization-server`
Protected resource metadata	`https://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.

View the full README on GitHub

Details

Repository: github.com/krystalview/krystalview-mcp
Website: krystalview.com
Package: krystalview-mcp
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active
Tools verified: Nov 6, 2026