io.github.KrystalView/krystalview

Official13 tools

by KrystalView · Python

KrystalView Analytics

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

Read-only access to session, funnel, campaign, error, and visitor analytics data.

Captured live from the server via tools/list.

get_sessions

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

Parameters (8)

querystring
Search entry or exit URLs, for example /pricing.
limitinteger
Maximum results to return.
offsetinteger
Pagination offset.
countrystring
Country name filter.
device_typestring
Device type filter.
min_frictioninteger
Minimum friction score.
min_durationinteger
Minimum session duration in seconds.
has_rage_clicksboolean
Only sessions with rage clicks.

get_session_detail

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

Parameters (1)

session_idstringrequired
Session primary key from get_sessions.

get_site_stats

Get aggregate site metrics including sessions, duration, friction, rage clicks, daily counts, device mix, and top pages.

Parameters (1)

daysinteger
Lookback period in days.

get_scroll_depth

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

Parameters (2)

pathstringrequired
Page path to analyze, for example /pricing.
daysinteger
Lookback period in days.

get_live_visitors

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

No parameters.

get_anomalies

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

Parameters (2)

limitinteger
Maximum results to return.
unacknowledged_onlyboolean
Only include unacknowledged anomalies.

get_funnels

List conversion funnels defined for this site.

No parameters.

get_funnel_analysis

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

Parameters (2)

funnel_idintegerrequired
Funnel ID from get_funnels.
daysinteger
Lookback period in days.

get_campaign_summary

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

Parameters (1)

daysinteger
Lookback period in days.

get_campaign_sessions

List sessions attributed to a specific marketing campaign.

Parameters (3)

campaignstringrequired
UTM campaign name.
limitinteger
Maximum results to return.
offsetinteger
Pagination offset.

get_campaign_roas

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

Parameters (1)

daysinteger
Lookback period in days.

get_errors

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

Parameters (3)

limitinteger
Maximum results to return.
error_typestring
Filter by error type.
unresolved_onlyboolean
Only include unresolved errors.

get_notifications

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

Parameters (2)

unread_onlyboolean
Only include unread notifications.
limitinteger
Maximum results to return.

Install

Configuration

Environment variables

KRYSTALVIEW_API_KEYrequiredsecret

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

KRYSTALVIEW_BASE_URL

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

claude_desktop_config.json

{
  "mcpServers": {
    "krystalview": {
      "command": "uvx",
      "args": [
        "krystalview-mcp"
      ],
      "env": {
        "KRYSTALVIEW_API_KEY": "<YOUR_KRYSTALVIEW_API_KEY>",
        "KRYSTALVIEW_BASE_URL": "<YOUR_KRYSTALVIEW_BASE_URL>"
      }
    }
  }
}