Analyze Convai sessions, latency, reliability, usage, and provider telemetry via API key.
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"convai-analytics": {
"env": {
"CONVAI_API_KEY": "ck_live_your_key_here"
},
"args": [
"-y",
"@convai/analytics-mcp@latest"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
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.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y '@convai/analytics-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked @convai/analytics-mcp against OSV.dev.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in analytics
MCP Server for GCP environment for interacting with various Observability APIs.
MCP server for InsightSentry financial data API - market data, options, screeners, and more
Last9 MCP Server
Access Dynatrace observability data: logs, metrics, problems, vulnerabilities via DQL and Davis AI
MCP Security Weekly
Get CVE alerts and security updates for io.github.Conv-AI/convai-analytics-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
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?
The SDK calls Convai's hosted analytics API at https://analytics-api.convai.com/v1/analytics. The API resolves your API key server-side, scopes every query to your account, enforces plan and quota limits, and returns agent-friendly JSON that can be summarized, charted, or used in scripts.
Status: v0.2. The full v1 endpoint surface is wired:
summary,timeseries,breakdown,sessions.list,sessions.get,interactions.get,metrics/catalog,regression-detection, andquery. Convenience facades (latency,providers,errors,usage) work end to end on top of those primitives.
packages/mcp that exposes the main analytics questions as typed agent tools.packages/typescript.packages/python.cli.recipes/prompts that tell an AI agent exactly which calls to make for common analytics questions.recipes/charts that generate Vega-Lite specs or Plotly timelines for latency, usage, reliability, and concurrency analysis.convai-analytics/
├── docs/ Concepts, auth, metrics reference, prompt/chart indexes
├── openapi/ Snapshot of the analytics API contract
├── packages/
│ ├── typescript/ @convai/analytics SDK
│ ├── mcp/ @convai/analytics-mcp local stdio server
│ └── python/ convai-analytics SDK
├── cli/ convai-analytics command line interface
├── recipes/
│ ├── prompts/ Natural-language prompt templates for AI agents
│ └── charts/ Runnable chart-generation scripts
└── examples/ Runnable end-to-end examples
uv for the Python SDK examples.Get your key from the same Convai account you use for the rest of the Convai API, then export it in your shell:
export CONVAI_API_KEY="ck_live_your_key_here"
The SDK reads CONVAI_API_KEY automatically. You normally do not need to set a base U