Convai Analytics
Connects to Convai's hosted analytics API and exposes session telemetry, latency percentiles, error rates, usage trends, and provider breakdowns as typed MCP tools. Use it to ask questions like "show P95 latency over the last 30 days" or "which provider is driving errors" without writing custom scripts. The server wraps the TypeScript SDK, reads your CONVAI_API_KEY from the environment, and returns agent-friendly JSON that can be charted or summarized. All queries are scoped to your account server-side. Includes prompt recipes for common workflows and chart generation helpers for Vega-Lite timelines and waterfall views. Reach for this when you need programmatic access to Convai production telemetry from Claude Desktop, Cursor, or other stdio MCP hosts.
- tools
- 38
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- May 12, 2026
Tools
38 toolsPublic tool metadata for what this MCP can expose to an agent.
get_summaryCore and account tools
Core and account tools
No parameter schema in public metadata yet.
get_metrics_catalog
No parameter schema in public metadata yet.
list_sessions
No parameter schema in public metadata yet.
get_session_timeline
No parameter schema in public metadata yet.
get_interaction_trace
No parameter schema in public metadata yet.
get_p95_latency_over_time
No parameter schema in public metadata yet.
get_latency_percentile_series
No parameter schema in public metadata yet.
get_latency_percentile_chart
No parameter schema in public metadata yet.
get_latency_threshold_chart
No parameter schema in public metadata yet.
get_latency_heatmap_chart
No parameter schema in public metadata yet.
get_component_latency_breakdown
No parameter schema in public metadata yet.
generate_component_latency_chart
No parameter schema in public metadata yet.
find_component_latency_bottlenecks
No parameter schema in public metadata yet.
generate_interaction_waterfall
No parameter schema in public metadata yet.
explain_slow_session
No parameter schema in public metadata yet.
get_error_trend
No parameter schema in public metadata yet.
generate_error_trend_chart
No parameter schema in public metadata yet.
get_error_breakdown
No parameter schema in public metadata yet.
generate_error_breakdown_chart
No parameter schema in public metadata yet.
get_dropped_error_persist_trend
No parameter schema in public metadata yet.
generate_dropped_error_persist_chart
No parameter schema in public metadata yet.
generate_reliability_summary_chart
No parameter schema in public metadata yet.
generate_reliability_trends_chart
No parameter schema in public metadata yet.
get_usage_trends
No parameter schema in public metadata yet.
generate_usage_trends_chart
No parameter schema in public metadata yet.
get_character_usage_leaderboard
No parameter schema in public metadata yet.
generate_character_usage_chart
No parameter schema in public metadata yet.
generate_session_duration_scatter
No parameter schema in public metadata yet.
estimate_active_session_concurrency
No parameter schema in public metadata yet.
generate_active_session_concurrency_chart
No parameter schema in public metadata yet.
generate_peak_concurrency_chart
No parameter schema in public metadata yet.
get_tts_provider_attribution
No parameter schema in public metadata yet.
generate_tts_provider_chart
No parameter schema in public metadata yet.
get_llm_model_latency
No parameter schema in public metadata yet.
generate_llm_model_latency_chart
No parameter schema in public metadata yet.
compare_providers
No parameter schema in public metadata yet.
detect_regressions
No parameter schema in public metadata yet.
advanced_query
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
CONVAI_API_KEY*secretConvai API key for the account to query.
CONVAI_ANALYTICS_BASE_URLdefault: https://analytics-api.convai.com/v1/analyticsOptional analytics API base URL override.
Readme
convai-analytics
Agentic analytics for Convai applications.
This repository lets MCP-capable agents, coding agents, and developers answer questions about Convai session telemetry using only a Convai API key. The recommended path is the published local MCP server, @convai/analytics-mcp, which plugs into Claude Desktop, Cursor, Codex-compatible MCP clients, and other stdio MCP hosts so agents can call typed analytics tools instead of writing custom scripts.
For developers who want direct programmatic access, the repo also includes TypeScript, Python, and CLI clients that use the same public Analytics API.
Ask questions like:
How many interactions did my characters have in the last 7 days?
How many unique end users used each character this month?
Show aggregate P50/P95/P99 latency over time for production readiness sign-off.
Explain why this interaction was slow and generate a waterfall chart.
Which processor, provider, model, or character is driving latency or errors?
Details
- Repository
- github.com/conv-ai/convai-analytics
- Website
- github.com/Conv-AI/convai-analytics/tree/main/packages/mcp
- Category
- Monitoring & Observability
- Package
@convai/analytics-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
Related Monitoring & Observability MCP servers
View all
Skill Coverage Monitordailyaiagents-cpu/dailyai-osWalks every skill directory in skills/ and ~/.openclaw/skills/, validates each has SOUL.md (voice...0stars
Shopify Catalog Monitordizzyvinci/apify-foundryTrack price drops, stock-outs, restocks, and new/removed products across Shopify stores.0stars
Brand Monitorerikirby/toolcompare-fyiMonitor domain expiry, SSL certs, and social handle availability across platforms.0stars
Agent Trace Auditorlazymac2x/agent-trace-auditor-apiCloudflare Workers MCP server: agent-trace-auditor0starsApi Diff Monitorlazymac2x/api-diff-monitor-apiCloudflare Workers MCP server: api-diff-monitor0stars