KrystalView Analytics
Read-only MCP access to sessions, funnels, campaigns, errors, live visitors, and anomalies.
我该使用它吗
质量与安全性
A
基于对工具定义和协议合规性的自动分析。
上下文开销
~4,129token 数（工具定义）
~3.5 KB典型响应大小
对注意力有显著影响（占 128k 上下文窗口的 3.23%）
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"krystalview": {
"command": "uvx",
"args": [
"krystalview-mcp"
]
}
}
}可运行的软件包
pypikrystalview-mcp
0.1.6stdio远程端点
https://krystalview.com/mcpstreamable-http它能做什么
工具清单
工具（13）
🟢 只读🟡 写入🔴 删除⚪ 未知
🟢get_sessions(query, limit, offset, country, device_type, ...)
List recent visitor sessions with filters for URL, country, device, duration, friction, and rage clicks.
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search entry or exit URLs, for example /pricing."
},
"limit": {
"type": "integer",
"description": "Maximum results to return.",
"default": 20,
"minimum": 1,
"maximum": 100
},
"offset": {
"type": "integer",
"description": "Pagination offset.",
"default": 0,
"minimum": 0
},
"country": {
"type": "string",
"description": "Country name filter."
},
"device_type": {
"type": "string",
"description": "Device type filter.",
"enum": [
"desktop",
"mobile"
]
},
"min_friction": {
"type": "integer",
"description": "Minimum friction score.",
"minimum": 0,
"maximum": 10
},
"min_duration": {
"type": "integer",
"description": "Minimum session duration in seconds.",
"minimum": 0
},
"has_rage_clicks": {
"type": "boolean",
"description": "Only sessions with rage clicks."
}
}
}输出模式
{
"type": "object",
"properties": {
"data": {
"description": "Paginated recent visitor session records and related summary fields.",
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "array",
"items": true
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "integer"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"meta": {
"type": "object",
"description": "Site and rate-limit metadata for the current MCP call.",
"properties": {
"site_id": {
"type": "string",
"description": "KrystalView site ID used for this read-only query."
},
"rate_limit": {
"type": "integer",
"description": "Configured per-window MCP read limit."
},
"remaining": {
"type": "integer",
"description": "Approximate remaining calls in the current limit window."
}
},
"required": [
"site_id",
"rate_limit",
"remaining"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"description": "KrystalView MCP structured result envelope.",
"additionalProperties": false
}🟢get_session_detail(session_id)
Get full details for a specific visitor session, including pages, events, device context, errors, and friction signals.
输入模式
{
"type": "object",
"properties": {
"session_id": {
"type": "string",
"description": "Session primary key from get_sessions."
}
},
"required": [
"session_id"
]
}输出模式
{
"type": "object",
"properties": {
"data": {
"description": "Detailed visitor session evidence including pages, events, context, errors, and friction signals.",
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "array",
"items": true
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "integer"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"meta": {
"type": "object",
"description": "Site and rate-limit metadata for the current MCP call.",
"properties": {
"site_id": {
"type": "string",
"description": "KrystalView site ID used for this read-only query."
},
"rate_limit": {
"type": "integer",
"description": "Configured per-window MCP read limit."
},
"remaining": {
"type": "integer",
"description": "Approximate remaining calls in the current limit window."
}
},
"required": [
"site_id",
"rate_limit",
"remaining"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"description": "KrystalView MCP structured result envelope.",
"additionalProperties": false
}🟢get_site_stats(days)
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.
输入模式
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"description": "Lookback period in days.",
"default": 7,
"minimum": 1,
"maximum": 90
}
}
}输出模式
{
"type": "object",
"properties": {
"data": {
"description": "Aggregate site analytics metrics with traffic_quality fields for all, likely human, and likely bot/crawler sessions, plus trend series, device mix, top pages, and friction distribution.",
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "array",
"items": true
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "integer"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"meta": {
"type": "object",
"description": "Site and rate-limit metadata for the current MCP call.",
"properties": {
"site_id": {
"type": "string",
"description": "KrystalView site ID used for this read-only query."
},
"rate_limit": {
"type": "integer",
"description": "Configured per-window MCP read limit."
},
"remaining": {
"type": "integer",
"description": "Approximate remaining calls in the current limit window."
}
},
"required": [
"site_id",
"rate_limit",
"remaining"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"description": "KrystalView MCP structured result envelope.",
"additionalProperties": false
}🟢get_scroll_depth(path, days)
Get cumulative scroll-depth reach buckets for a specific page path.
输入模式
{
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Page path to analyze, for example /pricing."
},
"days": {
"type": "integer",
"description": "Lookback period in days.",
"default": 30,
"minimum": 1,
"maximum": 90
}
},
"required": [
"path"
]
}输出模式
{
"type": "object",
"properties": {
"data": {
"description": "Scroll-depth reach buckets and page-level scroll engagement evidence.",
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "array",
"items": true
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "integer"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"meta": {
"type": "object",
"description": "Site and rate-limit metadata for the current MCP call.",
"properties": {
"site_id": {
"type": "string",
"description": "KrystalView site ID used for this read-only query."
},
"rate_limit": {
"type": "integer",
"description": "Configured per-window MCP read limit."
},
"remaining": {
"type": "integer",
"description": "Approximate remaining calls in the current limit window."
}
},
"required": [
"site_id",
"rate_limit",
"remaining"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"description": "KrystalView MCP structured result envelope.",
"additionalProperties": false
}🟢get_live_visitors
Get currently active visitors and sessions seen in the live activity window.
输入模式
{
"type": "object",
"properties": {}
}输出模式
{
"type": "object",
"properties": {
"data": {
"description": "Currently active visitor/session records in the live activity window.",
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "array",
"items": true
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "integer"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"meta": {
"type": "object",
"description": "Site and rate-limit metadata for the current MCP call.",
"properties": {
"site_id": {
"type": "string",
"description": "KrystalView site ID used for this read-only query."
},
"rate_limit": {
"type": "integer",
"description": "Configured per-window MCP read limit."
},
"remaining": {
"type": "integer",
"description": "Approximate remaining calls in the current limit window."
}
},
"required": [
"site_id",
"rate_limit",
"remaining"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"description": "KrystalView MCP structured result envelope.",
"additionalProperties": false
}🟢get_anomalies(limit, unacknowledged_only)
List detected traffic, friction, bounce, and conversion anomalies for the site.
输入模式
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Maximum results to return.",
"default": 20,
"minimum": 1,
"maximum": 200
},
"unacknowledged_only": {
"type": "boolean",
"description": "Only include unacknowledged anomalies.",
"default": false
}
}
}输出模式
{
"type": "object",
"properties": {
"data": {
"description": "Detected traffic, bounce, friction, and conversion anomalies for the site.",
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "array",
"items": true
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "integer"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"meta": {
"type": "object",
"description": "Site and rate-limit metadata for the current MCP call.",
"properties": {
"site_id": {
"type": "string",
"description": "KrystalView site ID used for this read-only query."
},
"rate_limit": {
"type": "integer",
"description": "Configured per-window MCP read limit."
},
"remaining": {
"type": "integer",
"description": "Approximate remaining calls in the current limit window."
}
},
"required": [
"site_id",
"rate_limit",
"remaining"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"description": "KrystalView MCP structured result envelope.",
"additionalProperties": false
}🟢get_funnels
List conversion funnels defined for this site.
输入模式
{
"type": "object",
"properties": {}
}输出模式
{
"type": "object",
"properties": {
"data": {
"description": "Configured conversion funnels for the current site.",
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "array",
"items": true
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "integer"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"meta": {
"type": "object",
"description": "Site and rate-limit metadata for the current MCP call.",
"properties": {
"site_id": {
"type": "string",
"description": "KrystalView site ID used for this read-only query."
},
"rate_limit": {
"type": "integer",
"description": "Configured per-window MCP read limit."
},
"remaining": {
"type": "integer",
"description": "Approximate remaining calls in the current limit window."
}
},
"required": [
"site_id",
"rate_limit",
"remaining"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"description": "KrystalView MCP structured result envelope.",
"additionalProperties": false
}🟢get_funnel_analysis(funnel_id, days)
Analyze a conversion funnel and show step reach, drop-off, and completion evidence.
输入模式
{
"type": "object",
"properties": {
"funnel_id": {
"type": "integer",
"description": "Funnel ID from get_funnels."
},
"days": {
"type": "integer",
"description": "Lookback period in days.",
"default": 30,
"minimum": 1,
"maximum": 90
}
},
"required": [
"funnel_id"
]
}输出模式
{
"type": "object",
"properties": {
"data": {
"description": "Funnel reach, conversion, drop-off, and step-level evidence for the selected lookback period.",
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "array",
"items": true
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "integer"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"meta": {
"type": "object",
"description": "Site and rate-limit metadata for the current MCP call.",
"properties": {
"site_id": {
"type": "string",
"description": "KrystalView site ID used for this read-only query."
},
"rate_limit": {
"type": "integer",
"description": "Configured per-window MCP read limit."
},
"remaining": {
"type": "integer",
"description": "Approximate remaining calls in the current limit window."
}
},
"required": [
"site_id",
"rate_limit",
"remaining"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"description": "KrystalView MCP structured result envelope.",
"additionalProperties": false
}🟢get_campaign_summary(days)
Get campaign attribution breakdown by UTM campaign, source, medium, sessions, duration, and bounce rate.
输入模式
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"description": "Lookback period in days.",
"default": 30,
"minimum": 7,
"maximum": 90
}
}
}输出模式
{
"type": "object",
"properties": {
"data": {
"description": "UTM campaign attribution summaries including sessions, source, medium, duration, and bounce evidence.",
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "array",
"items": true
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "integer"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"meta": {
"type": "object",
"description": "Site and rate-limit metadata for the current MCP call.",
"properties": {
"site_id": {
"type": "string",
"description": "KrystalView site ID used for this read-only query."
},
"rate_limit": {
"type": "integer",
"description": "Configured per-window MCP read limit."
},
"remaining": {
"type": "integer",
"description": "Approximate remaining calls in the current limit window."
}
},
"required": [
"site_id",
"rate_limit",
"remaining"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"description": "KrystalView MCP structured result envelope.",
"additionalProperties": false
}🟢get_campaign_sessions(campaign, limit, offset)
List sessions attributed to a specific marketing campaign.
输入模式
{
"type": "object",
"properties": {
"campaign": {
"type": "string",
"description": "UTM campaign name."
},
"limit": {
"type": "integer",
"description": "Maximum results to return.",
"default": 20,
"minimum": 1,
"maximum": 100
},
"offset": {
"type": "integer",
"description": "Pagination offset.",
"default": 0,
"minimum": 0
}
},
"required": [
"campaign"
]
}输出模式
{
"type": "object",
"properties": {
"data": {
"description": "Visitor sessions attributed to the requested UTM campaign.",
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "array",
"items": true
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "integer"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"meta": {
"type": "object",
"description": "Site and rate-limit metadata for the current MCP call.",
"properties": {
"site_id": {
"type": "string",
"description": "KrystalView site ID used for this read-only query."
},
"rate_limit": {
"type": "integer",
"description": "Configured per-window MCP read limit."
},
"remaining": {
"type": "integer",
"description": "Approximate remaining calls in the current limit window."
}
},
"required": [
"site_id",
"rate_limit",
"remaining"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"description": "KrystalView MCP structured result envelope.",
"additionalProperties": false
}🟢get_campaign_roas(days)
Get paid campaign spend, clicks, sessions, attributed conversions, and ROAS where ad data is connected.
输入模式
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"description": "Lookback period in days.",
"default": 30,
"minimum": 1,
"maximum": 90
}
}
}输出模式
{
"type": "object",
"properties": {
"data": {
"description": "Paid campaign spend, clicks, sessions, conversions, revenue, and ROAS evidence where connected.",
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "array",
"items": true
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "integer"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"meta": {
"type": "object",
"description": "Site and rate-limit metadata for the current MCP call.",
"properties": {
"site_id": {
"type": "string",
"description": "KrystalView site ID used for this read-only query."
},
"rate_limit": {
"type": "integer",
"description": "Configured per-window MCP read limit."
},
"remaining": {
"type": "integer",
"description": "Approximate remaining calls in the current limit window."
}
},
"required": [
"site_id",
"rate_limit",
"remaining"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"description": "KrystalView MCP structured result envelope.",
"additionalProperties": false
}🟢get_errors(limit, error_type, unresolved_only)
Get aggregated browser errors grouped by type and message, with affected paths and sample sessions.
输入模式
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Maximum results to return.",
"default": 20,
"minimum": 1,
"maximum": 200
},
"error_type": {
"type": "string",
"description": "Filter by error type."
},
"unresolved_only": {
"type": "boolean",
"description": "Only include unresolved errors.",
"default": true
}
}
}输出模式
{
"type": "object",
"properties": {
"data": {
"description": "Aggregated browser error groups with affected paths, counts, and sample sessions.",
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "array",
"items": true
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "integer"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"meta": {
"type": "object",
"description": "Site and rate-limit metadata for the current MCP call.",
"properties": {
"site_id": {
"type": "string",
"description": "KrystalView site ID used for this read-only query."
},
"rate_limit": {
"type": "integer",
"description": "Configured per-window MCP read limit."
},
"remaining": {
"type": "integer",
"description": "Approximate remaining calls in the current limit window."
}
},
"required": [
"site_id",
"rate_limit",
"remaining"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"description": "KrystalView MCP structured result envelope.",
"additionalProperties": false
}🟢get_notifications(unread_only, limit)
Get recent KrystalView notifications such as insights, setup notices, errors, and anomalies.
输入模式
{
"type": "object",
"properties": {
"unread_only": {
"type": "boolean",
"description": "Only include unread notifications.",
"default": false
},
"limit": {
"type": "integer",
"description": "Maximum results to return.",
"default": 10,
"minimum": 1,
"maximum": 50
}
}
}输出模式
{
"type": "object",
"properties": {
"data": {
"description": "Recent KrystalView notifications, insights, setup notices, and anomaly messages.",
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "array",
"items": true
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "integer"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"meta": {
"type": "object",
"description": "Site and rate-limit metadata for the current MCP call.",
"properties": {
"site_id": {
"type": "string",
"description": "KrystalView site ID used for this read-only query."
},
"rate_limit": {
"type": "integer",
"description": "Configured per-window MCP read limit."
},
"remaining": {
"type": "integer",
"description": "Approximate remaining calls in the current limit window."
}
},
"required": [
"site_id",
"rate_limit",
"remaining"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"description": "KrystalView MCP structured result envelope.",
"additionalProperties": false
}社区
证据
最近观测
已验证未记录版本13 个工具
已验证未记录版本13 个工具
已验证未记录版本13 个工具