Convai Analytics

NPM · @CONVAI/ANALYTICS-MCP · SCANNED AUG 3

Analyze Convai sessions, latency, reliability, usage, and provider telemetry via API key.

Available components

+25 this week 77 77 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency84

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Cryptographically verified build provenance (signed, bound to Conv-AI/convai-analytics). View diagnostics → Pass
License check failed: the license (UNLICENSED) isn't a recognized OSI-approved license. See how to fix → Fail
Actively maintained (last published 83 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability79

100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
AI-judged instruction clarity (good).Pass
Context-footprint check failed: tool/resource definitions use about 5091 tokens (~106/item across 48 items; 44 tools + 4 resources), over budget; trim descriptions and params. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage96

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
88% of tool parameters carry a description.Partial

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @convai/analytics-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add conv-ai-convai-analytics-mcp -- npx -y @convai/analytics-mcp

# add to Codex CLI

codex mcp add conv-ai-convai-analytics-mcp -- npx -y @convai/analytics-mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "conv-ai-convai-analytics-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@convai/analytics-mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add conv-ai-convai-analytics-mcp --command npx --arg -y --arg @convai/analytics-mcp

# ~/.hermes/config.yaml

mcp_servers:
  conv-ai-convai-analytics-mcp:
    command: "npx"
    args: ["-y", "@convai/analytics-mcp"]

// mcp.json

{
  "mcpServers": {
    "conv-ai-convai-analytics-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@convai/analytics-mcp"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +11
- Known CVEs: unverified → partial ▲ security
- Dependency health: unverified → partial ▲ functional
- Stability: unverified → 0.27 ▲ functional
2 Aug 26 +5
- Known CVEs: partial → unverified ▼ security
- Malware scan: unverified → pass ▲ security
- Dependency health: partial → unverified ▼ functional
1 Aug 26 +27
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
31 Jul 26 −18
- Malware scan: pass → unverified ▼ security
27 Jul 26 52

First indexed and scored.

Show 2 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/@convai/[email protected]

Provenance verified

Ecosystem: npm · Outcome: verified

Reason: verified

Source repo:: Conv-AI/convai-analytics
Certificate issuer:: https://token.actions.githubusercontent.com
Certificate SAN:: https://github.com/Conv-AI/convai-analytics/.github/workflows/publish-mcp-registry.yml@refs/heads/main
Rekor log index:: 1513289774
Predicate type:: https://slsa.dev/provenance/v1
Subject digest:: sha512:9a841fd633067fddcc97b08334bccad6bd037af9766c98103011327fdb7813fce647b445b09125fbb676904db4cd625b4dc71aa5e20e3532675dbea69
Discovery method:: attestation_endpoint

Dependencies 96 packages

96 packages in the resolved dependency tree · 95 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 44 exposed · ~5,011 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

advanced_query Advanced Query ~44

Plan-gated. Run an advanced analytics query through the public API for questions not covered by curated tools.

Input Output Examples

Name	Type	Req	Description
query	object	yes	Public analytics query body accepted by the API.

No output schema declared.

No examples provided.

compare_providers Compare Providers ~142

Compare provider or model latency for LLM, TTS, ASR, or NeuroSync components.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
component	string	—	—
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
model	string	—	Optional model filter.
percentile	string	—	—
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.

No output schema declared.

No examples provided.

detect_regressions Detect Regressions ~67

Plan-gated. Detect whether latency regressed in the current window compared with a baseline window.

Input Output Examples

Name	Type	Req	Description
baselineRange	string	—	—
currentRange	string	—	—
groupBy	string	—	—
measure	string	—	—
threshold	number	—	—

No output schema declared.

No examples provided.

estimate_active_session_concurrency Estimate Active Session Concurrency ~101

Estimate active session and LiveKit room pressure from session start/end/duration telemetry.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
bucketMinutes	integer	—	—
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
limit	integer	—	—
range	string	—	Relative time range.

No output schema declared.

No examples provided.

explain_slow_session Explain Slow Session ~125

Find a traceable slow interaction in a session or slow-session list and return the session timeline, trace, top span, and waterfall chart.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
limit	integer	—	—
range	string	—	Relative time range.
sessionId	string	—	Optional specific session id. If omitted, the tool scans slow sessions.

No output schema declared.

No examples provided.

find_component_latency_bottlenecks Find Component Latency Bottlenecks ~144

Rank the top latency offenders by component so an agent can explain likely bottlenecks.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
model	string	—	Optional model filter.
percentile	string	—	—
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.
topN	integer	—	—

No output schema declared.

No examples provided.

generate_active_session_concurrency_chart Generate Active Session Concurrency Chart ~99

Generate a Vega-Lite area chart estimating active sessions over time.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
bucketMinutes	integer	—	—
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
limit	integer	—	—
range	string	—	Relative time range.

No output schema declared.

No examples provided.

generate_character_usage_chart Generate Character Usage Chart ~88

Generate a Vega-Lite leaderboard chart of sessions by character.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
limit	integer	—	—
range	string	—	Relative time range.

No output schema declared.

No examples provided.

generate_component_latency_chart Generate Component Latency Chart ~131

Generate a Vega-Lite bar chart showing p95 latency by processor/component.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
model	string	—	Optional model filter.
percentile	string	—	—
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.

No output schema declared.

No examples provided.

generate_dropped_error_persist_chart Generate Dropped Error Persist Chart ~139

Generate a Vega-Lite trend chart for dropped error-persistence events.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
granularity	string	—	Bucket size for trend charts.
model	string	—	Optional model filter.
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.

No output schema declared.

No examples provided.

generate_error_breakdown_chart Generate Error Breakdown Chart ~138

Generate a Vega-Lite bar chart of errors by processor/component.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
groupBy	string	—	—
limit	integer	—	—
model	string	—	Optional model filter.
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.

No output schema declared.

No examples provided.

generate_error_trend_chart Generate Error Trend Chart ~135

Generate a Vega-Lite line chart showing errors over time.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
granularity	string	—	Bucket size for trend charts.
model	string	—	Optional model filter.
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.

No output schema declared.

No examples provided.

generate_interaction_waterfall Generate Interaction Waterfall ~40

Generate a Vega-Lite waterfall chart for one interaction id's per-component latency breakdown.

Input Output Examples

Name	Type	Req	Description
interactionId	string	yes	Convai interaction id.

No output schema declared.

No examples provided.

generate_llm_model_latency_chart Generate LLM Model Latency Chart ~133

Generate a Vega-Lite chart ranking LLM models by p95 latency.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
limit	integer	—	—
model	string	—	Optional model filter.
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.

No output schema declared.

No examples provided.

generate_peak_concurrency_chart Generate Peak Concurrency Chart ~101

Generate a Vega-Lite chart showing estimated active sessions with a peak concurrency annotation.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
bucketMinutes	integer	—	—
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
limit	integer	—	—
range	string	—	Relative time range.

No output schema declared.

No examples provided.

generate_reliability_summary_chart Generate Reliability Summary Chart ~79

Generate a Vega-Lite chart of interactions, sessions, errors, and error rate for a time range.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
experienceId	string	—	Optional experience filter.
range	string	—	Relative time range.

No output schema declared.

No examples provided.

generate_reliability_trends_chart Generate Reliability Trends Chart ~140

Generate a Vega-Lite trend chart that combines errors and dropped persistence events.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
granularity	string	—	Bucket size for trend charts.
model	string	—	Optional model filter.
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.

No output schema declared.

No examples provided.

generate_session_duration_scatter Generate Session Duration Scatter ~103

Generate a Vega-Lite scatter plot of session duration versus interactions, colored by p95 latency.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
limit	integer	—	—
range	string	—	Relative time range.
sort	string	—	—

No output schema declared.

No examples provided.

generate_tts_provider_chart Generate TTS Provider Chart ~129

Generate a Vega-Lite chart of TTS provider attribution.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
limit	integer	—	—
model	string	—	Optional model filter.
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.

No output schema declared.

No examples provided.

generate_usage_trends_chart Generate Usage Trends Chart ~141

Generate a Vega-Lite chart for sessions, interactions, and unique end users over time.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
granularity	string	—	Bucket size for trend charts.
model	string	—	Optional model filter.
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.

No output schema declared.

No examples provided.

get_character_usage_leaderboard Get Character Usage Leaderboard ~89

Rank characters by session volume for the selected time range.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
limit	integer	—	—
range	string	—	Relative time range.

No output schema declared.

No examples provided.

get_component_latency_breakdown Get Component Latency Breakdown ~132

Answer which processor/component is contributing most to p95 end-to-end latency.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
model	string	—	Optional model filter.
percentile	string	—	—
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.

No output schema declared.

No examples provided.

get_dropped_error_persist_trend Get Dropped Error Persist Trend ~139

Track dropped error-persistence events over time as a reliability signal.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
granularity	string	—	Bucket size for trend charts.
model	string	—	Optional model filter.
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.

No output schema declared.

No examples provided.

get_error_breakdown Get Error Breakdown ~135

Break down errors by processor/component to identify reliability hotspots.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
groupBy	string	—	—
limit	integer	—	—
model	string	—	Optional model filter.
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.

No output schema declared.

No examples provided.

get_error_trend Get Error Trend ~132

Answer whether errors are rising or falling over time.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
granularity	string	—	Bucket size for trend charts.
model	string	—	Optional model filter.
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.

No output schema declared.

No examples provided.

get_first_response_breakdown Get First Response Breakdown ~164

Group first-response SLA P50/P95/P99 for one character by mode, settings_hash, stage, provider, model, status, or turn_scope.

Input Output Examples

Name	Type	Req	Description
characterId	string	yes	Character id. Required for SLA views.
groupBy	string	—	—
latencyKind	string	—	Primary maps by observed mode: voice+animation -> all_modalities_ready, voice -> first_voice, text -> first_text.
limit	integer	—	—
mode	string	—	Optional observed mode, e.g. voice_to_voice_animation.
range	string	—	Relative time range.
turnScope	string	—	Turn scope: all includes turn 1, warm is turn_id > 1, cold is turn_id = 1.

No output schema declared.

No examples provided.

get_first_response_markers Get First Response Settings Markers ~133

Return settings-hash change markers for one character's first-response latency graph.

Input Output Examples

Name	Type	Req	Description
characterId	string	yes	Character id. Required for SLA views.
latencyKind	string	—	Primary maps by observed mode: voice+animation -> all_modalities_ready, voice -> first_voice, text -> first_text.
mode	string	—	Optional observed mode, e.g. voice_to_voice_animation.
range	string	—	Relative time range.
turnScope	string	—	Turn scope: all includes turn 1, warm is turn_id > 1, cold is turn_id = 1.

No output schema declared.

No examples provided.

get_first_response_settings Get First Response Settings Snapshot ~61

Fetch one sanitized latency-relevant settings snapshot by settings hash.

Input Output Examples

Name	Type	Req	Description
characterId	string	—	Optional character id filter.
range	string	—	Relative lookup window.
settingsHash	string	yes	Settings hash from a first-response row or marker.

No output schema declared.

No examples provided.

get_first_response_summary Get First Response Summary ~150

Character-first, mode-specific first-response SLA P50/P95/P99. Defaults include turn 1; use turnScope=warm for turn_id > 1.

Input Output Examples

Name	Type	Req	Description
characterId	string	yes	Character id. Required for SLA views.
latencyKind	string	—	Primary maps by observed mode: voice+animation -> all_modalities_ready, voice -> first_voice, text -> first_text.
mode	string	—	Optional observed mode, e.g. voice_to_voice_animation.
range	string	—	Relative time range.
turnScope	string	—	Turn scope: all includes turn 1, warm is turn_id > 1, cold is turn_id = 1.

No output schema declared.

No examples provided.

get_first_response_timeseries Get First Response Timeseries ~158

Bucketed first-response SLA P50/P95/P99 for one character and optional observed mode.

Input Output Examples

Name	Type	Req	Description
characterId	string	yes	Character id. Required for SLA views.
granularity	string	—	Bucket size for trend charts.
groupBy	string	—	—
latencyKind	string	—	Primary maps by observed mode: voice+animation -> all_modalities_ready, voice -> first_voice, text -> first_text.
mode	string	—	Optional observed mode, e.g. voice_to_voice_animation.
range	string	—	Relative time range.
turnScope	string	—	Turn scope: all includes turn 1, warm is turn_id > 1, cold is turn_id = 1.

No output schema declared.

No examples provided.

get_interaction_first_response Get Interaction First Response Waterfall ~34

Return the additive first-response waterfall for one interaction id.

Input Output Examples

Name	Type	Req	Description
interactionId	string	yes	Convai interaction id.

No output schema declared.

No examples provided.

get_interaction_trace Get Interaction Trace ~41

Show the per-request component spans for one interaction id, including processor/provider/model durations where available.

Input Output Examples

Name	Type	Req	Description
interactionId	string	yes	Convai interaction id.

No output schema declared.

No examples provided.

get_latency_heatmap_chart Generate Latency Heatmap ~145

Generate a Vega-Lite heatmap of p95 latency by day and UTC hour to spot systemic slow windows.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
granularity	string	—	Bucket size for trend charts.
model	string	—	Optional model filter.
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.

No output schema declared.

No examples provided.

get_latency_percentile_chart Generate Latency Percentile Chart ~148

Generate a Vega-Lite line chart for aggregate P50/P95/P99 latency distribution over time for production readiness sign-off.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
granularity	string	—	Bucket size for trend charts.
model	string	—	Optional model filter.
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.

No output schema declared.

No examples provided.

get_latency_percentile_series Get Latency Percentile Series ~152

Fetch one raw P50/P95/P99 end-to-end latency timeseries for custom analysis or charting.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
granularity	string	—	Bucket size for trend charts.
model	string	—	Optional model filter.
percentile	string	—	—
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.

No output schema declared.

No examples provided.

get_latency_threshold_chart Generate P95 Threshold Chart ~147

Generate a Vega-Lite chart showing p95 latency against a production-readiness threshold.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
granularity	string	—	Bucket size for trend charts.
model	string	—	Optional model filter.
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.
thresholdMs	number	—	—

No output schema declared.

No examples provided.

get_llm_model_latency Get LLM Model Latency ~132

Rank LLM models by p95 latency to spot model-driven latency issues.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
limit	integer	—	—
model	string	—	Optional model filter.
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.

No output schema declared.

No examples provided.

get_metrics_catalog Get Metrics Catalog ~36

List the public metrics this account can query so an agent can choose the right latency, reliability, usage, provider, or model metric.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_p95_latency_over_time Get P95 Latency Over Time ~141

Answer whether p95 end-to-end voice latency is getting better or worse over time.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
granularity	string	—	Bucket size for trend charts.
model	string	—	Optional model filter.
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.

No output schema declared.

No examples provided.

get_session_timeline Get Session Timeline ~43

Show the timeline of metrics and interaction ids inside one session, useful for explaining why a session felt slow.

Input Output Examples

Name	Type	Req	Description
sessionId	string	yes	Convai session id.

No output schema declared.

No examples provided.

get_summary Get Analytics Summary ~82

Answer account-level questions like how many sessions, interactions, unique end users, errors, and headline latency percentiles happened in a time range.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
experienceId	string	—	Optional experience filter.
range	string	—	Relative time range.

No output schema declared.

No examples provided.

get_tts_provider_attribution Get TTS Provider Attribution ~132

Show which TTS voice providers contributed samples in the selected time range.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
limit	integer	—	—
model	string	—	Optional model filter.
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.

No output schema declared.

No examples provided.

get_usage_trends Get Usage Trends ~145

Fetch sessions, interactions, and unique end users over time for usage trend analysis.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
granularity	string	—	Bucket size for trend charts.
metrics	array	—	—
model	string	—	Optional model filter.
processor	string	—	Optional processor filter.
provider	string	—	Optional provider filter.
range	string	—	Relative time range.
status	string	—	Optional status filter.

No output schema declared.

No examples provided.

list_sessions List Sessions ~121

Find recent, longest, or slowest sessions for the caller's account before drilling into a session timeline or interaction trace.

Input Output Examples

Name	Type	Req	Description
appKey	string	—	Optional Convai app key filter.
characterId	string	—	Optional character filter.
cursor	string	—	Opaque pagination cursor returned by the previous call.
endUserId	string	—	Optional end-user filter.
experienceId	string	—	Optional experience filter.
limit	integer	—	—
range	string	—	Relative time range.
sort	string	—	—

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug