Server definition
- Hash
- sha256:022d19e76d3bb95bf115c100d2bcc522d156b40e9718f3ce19b2f2415d1797d8
- What it is
- What a remote MCP server returned when asked what it offers: 19 tools
The blob, as servednamed by its sha256
{
"instructions": "Sevana voice quality analysis.\n\n1. Get a file onto the server: create_upload (returns a one-time URL; PUT the file there, e.g. with curl -T) or upload_inline (base64, small files). Use kind \"wav\" for recordings and \"pcap\" for packet captures.\n2. Analyze it with its upload_id:\n - pvqa_analyze: MOS and impairments of one WAV recording, no reference needed.\n - aqua_compare: compare a degraded WAV with its reference WAV (MOS, percent, fault analysis).\n - pcap_analyze: VoIP calls in a .pcap/.pcapng: SIP calls, RTP streams, MOS per stream, loss, jitter, call health. Runs as a job; read the result with pcap_summary, pcap_get_call, pcap_get_stream, pcap_sip_messages, pcap_dtmf, pcap_network_stats. Reports never contain decoded audio.\n3. Read sevana://docs/* for what the report fields mean.\n\nWithout an API key the free tier allows 10 analyses per hour. Uploads and results are deleted after an hour.",
"tools": [
{
"description": "Intrusive voice quality analysis (Sevana AQuA, wideband): compares a degraded/test WAV with its reference WAV and returns MOS, percent similarity and a fault analysis explaining the loss of quality. Upload both files first.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"channel_reference": {
"description": "reference channel, from 0 (default: AQuA's choice)",
"type": [
"null",
"integer"
]
},
"channel_test": {
"description": "test channel, from 0 (default: AQuA's choice)",
"type": [
"null",
"integer"
]
},
"reference_upload_id": {
"description": "upload_id of the original/reference WAV",
"type": "string"
},
"test_upload_id": {
"description": "upload_id of the degraded/test WAV",
"type": "string"
}
},
"required": [
"reference_upload_id",
"test_upload_id"
],
"type": "object"
},
"name": "aqua_compare",
"outputSchema": {
"additionalProperties": false,
"properties": {
"faults": {
"description": "AQuA's fault analysis: why quality is lost (delay, spectrum, level, noise), with per-file values",
"type": "string"
},
"mos": {
"description": "AQuA MOS (1-5)",
"type": [
"null",
"number"
]
},
"percent": {
"description": "similarity of the test file to the reference, 0-100",
"type": [
"null",
"number"
]
},
"reference_upload_id": {
"type": "string"
},
"test_upload_id": {
"type": "string"
}
},
"required": [
"reference_upload_id",
"test_upload_id",
"percent",
"mos",
"faults"
],
"type": "object"
}
},
{
"description": "Start uploading a WAV recording (kind \"wav\") or a packet capture (kind \"pcap\"). Returns an upload_id and a one-time upload_url; send the file as the body of an HTTP PUT to that URL (for example: curl -T recording.wav '<upload_url>'), then pass the upload_id to an analysis tool. The URL works once and expires after 15 minutes; the file is deleted after an hour. Use upload_inline instead if you can only pass tool arguments.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"filename": {
"description": "original file name, for display only",
"type": "string"
},
"kind": {
"description": "file kind: \"wav\" (default) or \"pcap\" (.pcap/.pcapng)",
"type": "string"
},
"size_bytes": {
"description": "file size, if known; larger than the limit is refused at once",
"type": "integer"
}
},
"type": "object"
},
"name": "create_upload",
"outputSchema": {
"additionalProperties": false,
"properties": {
"curl_example": {
"type": "string"
},
"expires_at": {
"description": "the URL must be used before this time",
"type": "string"
},
"max_bytes": {
"description": "largest file accepted (0 = no limit)",
"type": "integer"
},
"max_seconds": {
"description": "longest WAV accepted (0 = no limit)",
"type": "number"
},
"method": {
"type": "string"
},
"upload_id": {
"type": "string"
},
"upload_url": {
"description": "one-time URL: HTTP PUT the file as the request body",
"type": "string"
}
},
"required": [
"upload_id",
"upload_url",
"method",
"expires_at",
"curl_example"
],
"type": "object"
}
},
{
"description": "Delete an uploaded file now instead of waiting for it to expire.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"upload_id": {
"description": "upload_id returned by create_upload or upload_inline",
"type": "string"
}
},
"required": [
"upload_id"
],
"type": "object"
},
"name": "delete_upload",
"outputSchema": {
"additionalProperties": false,
"properties": {
"deleted": {
"type": "boolean"
}
},
"required": [
"deleted"
],
"type": "object"
}
},
{
"description": "Cancel a queued or running analysis job.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"job_id": {
"description": "job_id returned by pcap_analyze",
"type": "string"
}
},
"required": [
"job_id"
],
"type": "object"
},
"name": "job_cancel",
"outputSchema": {
"additionalProperties": false,
"properties": {
"created_at": {
"type": "string"
},
"error": {
"type": "string"
},
"expires_at": {
"description": "the result is deleted at this time",
"type": [
"null",
"string"
]
},
"finished_at": {
"type": [
"null",
"string"
]
},
"job_id": {
"type": "string"
},
"next": {
"type": "string"
},
"percent": {
"type": "number"
},
"queue_position": {
"description": "approximate place in the queue while queued",
"type": "integer"
},
"stage": {
"description": "current stage while running: parsing, audio, sip, ...",
"type": "string"
},
"status": {
"type": "string"
},
"summary": {
"additionalProperties": false,
"description": "set when a PCAP job is done",
"properties": {
"average_mos": {
"type": [
"null",
"number"
]
},
"call_list": {
"items": {
"additionalProperties": false,
"properties": {
"call_id": {
"type": "string"
},
"diagnostics": {
"type": "string"
},
"health": {
"description": "analyzer warnings: one-way audio, codec/ptime asymmetry, late media, ...; empty = healthy",
"items": {
"additionalProperties": false,
"properties": {
"explanation": {
"type": "string"
},
"stream_ids": {
"items": {
"type": "integer"
},
"type": [
"null",
"array"
]
},
"tag": {
"type": "string"
}
},
"required": [
"tag",
"explanation"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"media_duration_s": {
"type": "number"
},
"media_start": {
"type": "string"
},
"peer_a": {
"type": "string"
},
"peer_b": {
"type": "string"
},
"response_codes": {
"type": "string"
},
"sip_messages": {
"type": "integer"
},
"stream_ids": {
"items": {
"type": "integer"
},
"type": [
"null",
"array"
]
},
"worst_mos": {
"description": "lowest Sevana MOS of the call's streams",
"type": [
"null",
"number"
]
}
},
"required": [
"call_id",
"peer_a",
"peer_b",
"response_codes",
"media_duration_s",
"sip_messages",
"stream_ids",
"health"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"calls": {
"type": "integer"
},
"job_id": {
"type": "string"
},
"omitted": {
"additionalProperties": {
"type": "integer"
},
"description": "calls/streams left out of the lists; see pcap_full_report",
"type": "object"
},
"packets": {
"additionalProperties": {
"type": "string"
},
"description": "main packet counters",
"type": "object"
},
"software": {
"type": "string"
},
"stream_list": {
"description": "worst Sevana MOS first",
"items": {
"additionalProperties": false,
"properties": {
"call_id": {
"type": "string"
},
"codec": {
"type": "string"
},
"delay_ms": {
"type": [
"null",
"number"
]
},
"dest": {
"type": "string"
},
"dtmf_events": {
"type": "integer"
},
"duration_s": {
"type": "number"
},
"impairments": {
"additionalProperties": {
"type": "integer"
},
"description": "PVQA detector -> number of 0.68 s intervals where it fired",
"type": "object"
},
"is_silent": {
"type": [
"null",
"boolean"
]
},
"jitter_ms": {
"type": [
"null",
"number"
]
},
"loss_percent": {
"type": "number"
},
"lost": {
"type": "integer"
},
"mos_network": {
"description": "MOS estimated from loss and jitter only",
"type": [
"null",
"number"
]
},
"mos_sevana": {
"description": "listening-quality MOS from the decoded speech (1-5); 0 or null = not scored (e.g. SRTP without key)",
"type": [
"null",
"number"
]
},
"packets": {
"type": "integer"
},
"src": {
"type": "string"
},
"stream_id": {
"type": "integer"
}
},
"required": [
"stream_id",
"src",
"dest",
"codec",
"mos_sevana",
"mos_network",
"packets",
"lost",
"loss_percent",
"duration_s",
"impairments",
"dtmf_events"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"streams": {
"type": "integer"
},
"streams_scored": {
"description": "streams with a Sevana MOS",
"type": "integer"
},
"worst_mos": {
"type": [
"null",
"number"
]
}
},
"required": [
"job_id",
"packets",
"calls",
"streams",
"streams_scored",
"call_list",
"stream_list"
],
"type": [
"null",
"object"
]
}
},
"required": [
"job_id",
"status",
"percent",
"created_at"
],
"type": "object"
}
},
{
"description": "State of an analysis job (queued, running with stage and percent, done, failed, cancelled). Waits up to wait_seconds for it to finish; a finished PCAP job includes its summary.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"job_id": {
"description": "job_id returned by pcap_analyze",
"type": "string"
},
"wait_seconds": {
"description": "wait up to this many seconds for the job to finish (0-55, default 0)",
"type": [
"null",
"integer"
]
}
},
"required": [
"job_id"
],
"type": "object"
},
"name": "job_status",
"outputSchema": {
"additionalProperties": false,
"properties": {
"created_at": {
"type": "string"
},
"error": {
"type": "string"
},
"expires_at": {
"description": "the result is deleted at this time",
"type": [
"null",
"string"
]
},
"finished_at": {
"type": [
"null",
"string"
]
},
"job_id": {
"type": "string"
},
"next": {
"type": "string"
},
"percent": {
"type": "number"
},
"queue_position": {
"description": "approximate place in the queue while queued",
"type": "integer"
},
"stage": {
"description": "current stage while running: parsing, audio, sip, ...",
"type": "string"
},
"status": {
"type": "string"
},
"summary": {
"additionalProperties": false,
"description": "set when a PCAP job is done",
"properties": {
"average_mos": {
"type": [
"null",
"number"
]
},
"call_list": {
"items": {
"additionalProperties": false,
"properties": {
"call_id": {
"type": "string"
},
"diagnostics": {
"type": "string"
},
"health": {
"description": "analyzer warnings: one-way audio, codec/ptime asymmetry, late media, ...; empty = healthy",
"items": {
"additionalProperties": false,
"properties": {
"explanation": {
"type": "string"
},
"stream_ids": {
"items": {
"type": "integer"
},
"type": [
"null",
"array"
]
},
"tag": {
"type": "string"
}
},
"required": [
"tag",
"explanation"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"media_duration_s": {
"type": "number"
},
"media_start": {
"type": "string"
},
"peer_a": {
"type": "string"
},
"peer_b": {
"type": "string"
},
"response_codes": {
"type": "string"
},
"sip_messages": {
"type": "integer"
},
"stream_ids": {
"items": {
"type": "integer"
},
"type": [
"null",
"array"
]
},
"worst_mos": {
"description": "lowest Sevana MOS of the call's streams",
"type": [
"null",
"number"
]
}
},
"required": [
"call_id",
"peer_a",
"peer_b",
"response_codes",
"media_duration_s",
"sip_messages",
"stream_ids",
"health"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"calls": {
"type": "integer"
},
"job_id": {
"type": "string"
},
"omitted": {
"additionalProperties": {
"type": "integer"
},
"description": "calls/streams left out of the lists; see pcap_full_report",
"type": "object"
},
"packets": {
"additionalProperties": {
"type": "string"
},
"description": "main packet counters",
"type": "object"
},
"software": {
"type": "string"
},
"stream_list": {
"description": "worst Sevana MOS first",
"items": {
"additionalProperties": false,
"properties": {
"call_id": {
"type": "string"
},
"codec": {
"type": "string"
},
"delay_ms": {
"type": [
"null",
"number"
]
},
"dest": {
"type": "string"
},
"dtmf_events": {
"type": "integer"
},
"duration_s": {
"type": "number"
},
"impairments": {
"additionalProperties": {
"type": "integer"
},
"description": "PVQA detector -> number of 0.68 s intervals where it fired",
"type": "object"
},
"is_silent": {
"type": [
"null",
"boolean"
]
},
"jitter_ms": {
"type": [
"null",
"number"
]
},
"loss_percent": {
"type": "number"
},
"lost": {
"type": "integer"
},
"mos_network": {
"description": "MOS estimated from loss and jitter only",
"type": [
"null",
"number"
]
},
"mos_sevana": {
"description": "listening-quality MOS from the decoded speech (1-5); 0 or null = not scored (e.g. SRTP without key)",
"type": [
"null",
"number"
]
},
"packets": {
"type": "integer"
},
"src": {
"type": "string"
},
"stream_id": {
"type": "integer"
}
},
"required": [
"stream_id",
"src",
"dest",
"codec",
"mos_sevana",
"mos_network",
"packets",
"lost",
"loss_percent",
"duration_s",
"impairments",
"dtmf_events"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"streams": {
"type": "integer"
},
"streams_scored": {
"description": "streams with a Sevana MOS",
"type": "integer"
},
"worst_mos": {
"type": [
"null",
"number"
]
}
},
"required": [
"job_id",
"packets",
"calls",
"streams",
"streams_scored",
"call_list",
"stream_list"
],
"type": [
"null",
"object"
]
}
},
"required": [
"job_id",
"status",
"percent",
"created_at"
],
"type": "object"
}
},
{
"description": "Your analysis jobs from the last hour, newest first.",
"inputSchema": {
"additionalProperties": false,
"type": "object"
},
"name": "list_jobs",
"outputSchema": {
"additionalProperties": false,
"properties": {
"jobs": {
"items": {
"additionalProperties": false,
"properties": {
"created_at": {
"type": "string"
},
"error": {
"type": "string"
},
"expires_at": {
"description": "the result is deleted at this time",
"type": [
"null",
"string"
]
},
"finished_at": {
"type": [
"null",
"string"
]
},
"job_id": {
"type": "string"
},
"next": {
"type": "string"
},
"percent": {
"type": "number"
},
"queue_position": {
"description": "approximate place in the queue while queued",
"type": "integer"
},
"stage": {
"description": "current stage while running: parsing, audio, sip, ...",
"type": "string"
},
"status": {
"type": "string"
},
"summary": {
"additionalProperties": false,
"description": "set when a PCAP job is done",
"properties": {
"average_mos": {
"type": [
"null",
"number"
]
},
"call_list": {
"items": {
"additionalProperties": false,
"properties": {
"call_id": {
"type": "string"
},
"diagnostics": {
"type": "string"
},
"health": {
"description": "analyzer warnings: one-way audio, codec/ptime asymmetry, late media, ...; empty = healthy",
"items": {
"additionalProperties": false,
"properties": {
"explanation": {
"type": "string"
},
"stream_ids": {
"items": {
"type": "integer"
},
"type": [
"null",
"array"
]
},
"tag": {
"type": "string"
}
},
"required": [
"tag",
"explanation"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"media_duration_s": {
"type": "number"
},
"media_start": {
"type": "string"
},
"peer_a": {
"type": "string"
},
"peer_b": {
"type": "string"
},
"response_codes": {
"type": "string"
},
"sip_messages": {
"type": "integer"
},
"stream_ids": {
"items": {
"type": "integer"
},
"type": [
"null",
"array"
]
},
"worst_mos": {
"description": "lowest Sevana MOS of the call's streams",
"type": [
"null",
"number"
]
}
},
"required": [
"call_id",
"peer_a",
"peer_b",
"response_codes",
"media_duration_s",
"sip_messages",
"stream_ids",
"health"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"calls": {
"type": "integer"
},
"job_id": {
"type": "string"
},
"omitted": {
"additionalProperties": {
"type": "integer"
},
"description": "calls/streams left out of the lists; see pcap_full_report",
"type": "object"
},
"packets": {
"additionalProperties": {
"type": "string"
},
"description": "main packet counters",
"type": "object"
},
"software": {
"type": "string"
},
"stream_list": {
"description": "worst Sevana MOS first",
"items": {
"additionalProperties": false,
"properties": {
"call_id": {
"type": "string"
},
"codec": {
"type": "string"
},
"delay_ms": {
"type": [
"null",
"number"
]
},
"dest": {
"type": "string"
},
"dtmf_events": {
"type": "integer"
},
"duration_s": {
"type": "number"
},
"impairments": {
"additionalProperties": {
"type": "integer"
},
"description": "PVQA detector -> number of 0.68 s intervals where it fired",
"type": "object"
},
"is_silent": {
"type": [
"null",
"boolean"
]
},
"jitter_ms": {
"type": [
"null",
"number"
]
},
"loss_percent": {
"type": "number"
},
"lost": {
"type": "integer"
},
"mos_network": {
"description": "MOS estimated from loss and jitter only",
"type": [
"null",
"number"
]
},
"mos_sevana": {
"description": "listening-quality MOS from the decoded speech (1-5); 0 or null = not scored (e.g. SRTP without key)",
"type": [
"null",
"number"
]
},
"packets": {
"type": "integer"
},
"src": {
"type": "string"
},
"stream_id": {
"type": "integer"
}
},
"required": [
"stream_id",
"src",
"dest",
"codec",
"mos_sevana",
"mos_network",
"packets",
"lost",
"loss_percent",
"duration_s",
"impairments",
"dtmf_events"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"streams": {
"type": "integer"
},
"streams_scored": {
"description": "streams with a Sevana MOS",
"type": "integer"
},
"worst_mos": {
"type": [
"null",
"number"
]
}
},
"required": [
"job_id",
"packets",
"calls",
"streams",
"streams_scored",
"call_list",
"stream_list"
],
"type": [
"null",
"object"
]
}
},
"required": [
"job_id",
"status",
"percent",
"created_at"
],
"type": "object"
},
"type": [
"null",
"array"
]
}
},
"required": [
"jobs"
],
"type": "object"
}
},
{
"description": "Start a VoIP quality analysis of an uploaded .pcap/.pcapng capture (upload it with kind \"pcap\"). Reconstructs SIP calls and RTP streams and scores every stream (Sevana MOS from the decoded speech, network MOS, loss, jitter). Returns a job_id; the call waits up to wait_seconds and, if the analysis finished by then, includes the summary. Otherwise poll job_status. Only analysis reports are returned, never decoded audio. Reports include SIP messages and DTMF digits as captured; they are kept for one hour.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"statistics": {
"description": "compute aggregate statistics across streams (default true)",
"type": [
"null",
"boolean"
]
},
"upload_id": {
"description": "upload_id of a pcap upload",
"type": "string"
},
"wait_seconds": {
"description": "wait up to this many seconds for the result (0-55, default 25)",
"type": [
"null",
"integer"
]
}
},
"required": [
"upload_id"
],
"type": "object"
},
"name": "pcap_analyze",
"outputSchema": {
"additionalProperties": false,
"properties": {
"created_at": {
"type": "string"
},
"error": {
"type": "string"
},
"expires_at": {
"description": "the result is deleted at this time",
"type": [
"null",
"string"
]
},
"finished_at": {
"type": [
"null",
"string"
]
},
"job_id": {
"type": "string"
},
"next": {
"type": "string"
},
"percent": {
"type": "number"
},
"queue_position": {
"description": "approximate place in the queue while queued",
"type": "integer"
},
"stage": {
"description": "current stage while running: parsing, audio, sip, ...",
"type": "string"
},
"status": {
"type": "string"
},
"summary": {
"additionalProperties": false,
"description": "set when a PCAP job is done",
"properties": {
"average_mos": {
"type": [
"null",
"number"
]
},
"call_list": {
"items": {
"additionalProperties": false,
"properties": {
"call_id": {
"type": "string"
},
"diagnostics": {
"type": "string"
},
"health": {
"description": "analyzer warnings: one-way audio, codec/ptime asymmetry, late media, ...; empty = healthy",
"items": {
"additionalProperties": false,
"properties": {
"explanation": {
"type": "string"
},
"stream_ids": {
"items": {
"type": "integer"
},
"type": [
"null",
"array"
]
},
"tag": {
"type": "string"
}
},
"required": [
"tag",
"explanation"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"media_duration_s": {
"type": "number"
},
"media_start": {
"type": "string"
},
"peer_a": {
"type": "string"
},
"peer_b": {
"type": "string"
},
"response_codes": {
"type": "string"
},
"sip_messages": {
"type": "integer"
},
"stream_ids": {
"items": {
"type": "integer"
},
"type": [
"null",
"array"
]
},
"worst_mos": {
"description": "lowest Sevana MOS of the call's streams",
"type": [
"null",
"number"
]
}
},
"required": [
"call_id",
"peer_a",
"peer_b",
"response_codes",
"media_duration_s",
"sip_messages",
"stream_ids",
"health"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"calls": {
"type": "integer"
},
"job_id": {
"type": "string"
},
"omitted": {
"additionalProperties": {
"type": "integer"
},
"description": "calls/streams left out of the lists; see pcap_full_report",
"type": "object"
},
"packets": {
"additionalProperties": {
"type": "string"
},
"description": "main packet counters",
"type": "object"
},
"software": {
"type": "string"
},
"stream_list": {
"description": "worst Sevana MOS first",
"items": {
"additionalProperties": false,
"properties": {
"call_id": {
"type": "string"
},
"codec": {
"type": "string"
},
"delay_ms": {
"type": [
"null",
"number"
]
},
"dest": {
"type": "string"
},
"dtmf_events": {
"type": "integer"
},
"duration_s": {
"type": "number"
},
"impairments": {
"additionalProperties": {
"type": "integer"
},
"description": "PVQA detector -> number of 0.68 s intervals where it fired",
"type": "object"
},
"is_silent": {
"type": [
"null",
"boolean"
]
},
"jitter_ms": {
"type": [
"null",
"number"
]
},
"loss_percent": {
"type": "number"
},
"lost": {
"type": "integer"
},
"mos_network": {
"description": "MOS estimated from loss and jitter only",
"type": [
"null",
"number"
]
},
"mos_sevana": {
"description": "listening-quality MOS from the decoded speech (1-5); 0 or null = not scored (e.g. SRTP without key)",
"type": [
"null",
"number"
]
},
"packets": {
"type": "integer"
},
"src": {
"type": "string"
},
"stream_id": {
"type": "integer"
}
},
"required": [
"stream_id",
"src",
"dest",
"codec",
"mos_sevana",
"mos_network",
"packets",
"lost",
"loss_percent",
"duration_s",
"impairments",
"dtmf_events"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"streams": {
"type": "integer"
},
"streams_scored": {
"description": "streams with a Sevana MOS",
"type": "integer"
},
"worst_mos": {
"type": [
"null",
"number"
]
}
},
"required": [
"job_id",
"packets",
"calls",
"streams",
"streams_scored",
"call_list",
"stream_list"
],
"type": [
"null",
"object"
]
}
},
"required": [
"job_id",
"status",
"percent",
"created_at"
],
"type": "object"
}
},
{
"description": "DTMF key presses found in a finished PCAP analysis, with digits and timing: RTP telephone-events (RFC 2833/4733) per stream and SIP INFO (application/dtmf-relay, application/dtmf).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"call_id": {
"description": "only this call",
"type": "string"
},
"job_id": {
"description": "job_id returned by pcap_analyze",
"type": "string"
},
"stream_id": {
"description": "only this RTP stream (RFC 2833 events)",
"type": "integer"
}
},
"required": [
"job_id"
],
"type": "object"
},
"name": "pcap_dtmf",
"outputSchema": {
"additionalProperties": false,
"properties": {
"count": {
"type": "integer"
},
"digits": {
"description": "all keys in time order",
"type": "string"
},
"events": {
"items": {
"additionalProperties": false,
"properties": {
"call_id": {
"type": "string"
},
"duration_ms": {
"description": "SIP INFO only, when the message carries it",
"type": [
"null",
"integer"
]
},
"source": {
"description": "rfc2833 (RTP telephone-event) or sip_info",
"type": "string"
},
"stream_id": {
"description": "RTP stream carrying the event (rfc2833)",
"type": [
"null",
"integer"
]
},
"time": {
"type": "string"
},
"time_us": {
"type": "integer"
},
"tone": {
"description": "the key: 0-9, *, #, A-D",
"type": "string"
}
},
"required": [
"source",
"tone",
"time",
"time_us"
],
"type": "object"
},
"type": [
"null",
"array"
]
}
},
"required": [
"count",
"digits",
"events"
],
"type": "object"
}
},
{
"description": "The complete analysis report, one section at a time: \"streams\" or \"sip_calls\" (full objects, paged with cursor/limit) or \"counters\" (packet counters, SIP statistics, aggregate statistics). Contains no audio.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"cursor": {
"description": "index of the first item (from next_cursor)",
"type": "integer"
},
"job_id": {
"description": "job_id returned by pcap_analyze",
"type": "string"
},
"limit": {
"description": "items per page: streams default 5 (max 20), sip_calls default 3 (max 10); calls carry all their SIP messages",
"type": "integer"
},
"section": {
"description": "streams, sip_calls or counters",
"type": "string"
}
},
"required": [
"job_id",
"section"
],
"type": "object"
},
"name": "pcap_full_report",
"outputSchema": {
"additionalProperties": false,
"properties": {
"next_cursor": {
"type": [
"null",
"integer"
]
},
"packet_counters": {
"items": {
"additionalProperties": false,
"properties": {
"info": {
"type": "string"
},
"name": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"name",
"value"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"section": {
"type": "string"
},
"sip_calls": {
"items": {
"additionalProperties": false,
"properties": {
"callid": {
"type": "string"
},
"diagnostics": {
"type": "string"
},
"health": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"explanation": {
"type": "string"
},
"stream_ids": {
"items": {
"type": "integer"
},
"type": [
"null",
"array"
]
},
"tag": {
"type": "string"
}
},
"required": [
"code",
"tag",
"explanation",
"stream_ids"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"messages": {
"items": {
"additionalProperties": false,
"properties": {
"msg": {
"type": "string"
},
"time": {
"type": "string"
},
"transport": {
"type": "string"
},
"us": {
"type": "integer"
}
},
"required": [
"time",
"us",
"msg"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"peer_a": {
"type": "string"
},
"peer_b": {
"type": "string"
},
"reinvite": {
"items": {
"additionalProperties": false,
"properties": {
"is_request": {
"type": "boolean"
},
"msg": {
"type": "string"
},
"time": {
"type": "string"
},
"us": {
"type": "integer"
}
},
"required": [
"time",
"us",
"is_request",
"msg"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"response_codes": {
"type": "string"
},
"time_activity_end": {
"type": "string"
},
"time_activity_end_us": {
"type": "integer"
},
"time_activity_start": {
"type": "string"
},
"time_activity_start_us": {
"type": "integer"
},
"time_media_end": {
"type": "string"
},
"time_media_end_us": {
"type": "integer"
},
"time_media_start": {
"type": "string"
},
"time_media_start_us": {
"type": "integer"
},
"useragent_a": {
"type": "string"
},
"useragent_b": {
"type": "string"
}
},
"required": [
"callid",
"peer_a",
"peer_b",
"response_codes",
"messages",
"reinvite",
"time_media_start_us",
"time_media_end_us",
"time_media_start",
"time_media_end",
"time_activity_start_us",
"time_activity_end_us",
"time_activity_start",
"time_activity_end",
"diagnostics"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"sip_statistics": {
"items": {
"additionalProperties": false,
"properties": {
"info": {
"type": "string"
},
"name": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"name",
"value"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"software": {
"type": "string"
},
"statistics": {
"additionalProperties": false,
"properties": {
"network_mos": {
"additionalProperties": false,
"properties": {
"algorithms": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"analysis_tier": {
"type": "string"
},
"correlations": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": [
"null",
"array"
]
},
"descriptive": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": [
"null",
"array"
]
},
"excluded_features": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"lasso": true,
"regression": true,
"sample_count": {
"type": "integer"
},
"target": {
"type": "string"
}
},
"required": [
"target",
"sample_count",
"analysis_tier",
"algorithms",
"descriptive",
"correlations"
],
"type": [
"null",
"object"
]
},
"sevana_mos": {
"additionalProperties": false,
"properties": {
"algorithms": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"analysis_tier": {
"type": "string"
},
"correlations": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": [
"null",
"array"
]
},
"descriptive": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": [
"null",
"array"
]
},
"excluded_features": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"lasso": true,
"regression": true,
"sample_count": {
"type": "integer"
},
"target": {
"type": "string"
}
},
"required": [
"target",
"sample_count",
"analysis_tier",
"algorithms",
"descriptive",
"correlations"
],
"type": [
"null",
"object"
]
}
},
"type": [
"null",
"object"
]
},
"streams": {
"items": {
"additionalProperties": false,
"properties": {
"codec": {
"type": "string"
},
"delay": {
"type": [
"null",
"number"
]
},
"detector_report": {
"additionalProperties": false,
"properties": {
"echo": {
"items": {
"additionalProperties": false,
"properties": {
"length": {
"type": [
"null",
"number"
]
},
"level": {
"type": [
"null",
"number"
]
},
"time_ms": {
"type": "integer"
}
},
"required": [
"time_ms",
"level",
"length"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"headers": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"imps": {
"items": {
"additionalProperties": {
"type": "integer"
},
"type": "object"
},
"type": [
"null",
"array"
]
},
"mos": {
"type": [
"null",
"number"
]
},
"mos_model": {
"type": "string"
},
"rfactor": {
"type": [
"null",
"number"
]
},
"rows": {
"items": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"type": [
"null",
"array"
]
},
"vote_mos": {
"type": [
"null",
"number"
]
}
},
"required": [
"mos",
"rfactor",
"imps",
"echo",
"headers",
"rows"
],
"type": [
"null",
"object"
]
},
"endtime": {
"type": "integer"
},
"endtime_str": {
"type": "string"
},
"features": {
"additionalProperties": true,
"type": "object"
},
"is_silent": {
"type": [
"null",
"boolean"
]
},
"jitter": {
"type": [
"null",
"number"
]
},
"mos_model": {
"type": "string"
},
"mos_network": {
"type": [
"null",
"number"
]
},
"mos_sevana": {
"type": [
"null",
"number"
]
},
"mos_vote": {
"type": [
"null",
"number"
]
},
"packet_loss": {
"items": {
"additionalProperties": false,
"properties": {
"gap": {
"type": "integer"
},
"offset_end": {
"type": [
"null",
"number"
]
},
"offset_start": {
"type": [
"null",
"number"
]
},
"time_end": {
"type": "string"
},
"time_end_us": {
"type": "integer"
},
"time_start": {
"type": "string"
},
"time_start_us": {
"type": "integer"
}
},
"required": [
"time_start_us",
"time_end_us",
"time_start",
"time_end",
"offset_start",
"offset_end",
"gap"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"ptypes": {
"items": {
"additionalProperties": false,
"properties": {
"avg_ptime_ms": {
"type": [
"null",
"number"
]
},
"avg_size_bytes": {
"type": [
"null",
"number"
]
},
"count": {
"type": "integer"
},
"max_ptime_ms": {
"type": [
"null",
"number"
]
},
"min_ptime_ms": {
"type": [
"null",
"number"
]
},
"ptype": {
"type": "integer"
}
},
"required": [
"ptype",
"count"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"rfc2833": {
"items": {
"additionalProperties": false,
"properties": {
"time": {
"type": "string"
},
"time_us": {
"type": "integer"
},
"tone": {
"type": "string"
}
},
"required": [
"time_us",
"time",
"tone"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"rtcp_counter": {
"type": "integer"
},
"rtp_counter": {
"type": "integer"
},
"rtp_dest": {
"type": "string"
},
"rtp_illegal": {
"type": "integer"
},
"rtp_lost": {
"type": "integer"
},
"rtp_src": {
"type": "string"
},
"rtp_ssrc": {
"type": "integer"
},
"sip": {
"additionalProperties": false,
"properties": {
"bye": {
"type": "boolean"
},
"call_id": {
"type": "string"
},
"codec": {
"type": "string"
},
"peer1": {
"type": "string"
},
"peer2": {
"type": "string"
}
},
"required": [
"call_id",
"peer1",
"peer2",
"codec",
"bye"
],
"type": [
"null",
"object"
]
},
"starttime": {
"type": "integer"
},
"starttime_str": {
"type": "string"
},
"stream_id": {
"type": "integer"
}
},
"required": [
"stream_id",
"rtp_ssrc",
"rtp_src",
"rtp_dest",
"mos_sevana",
"mos_network",
"rtp_counter",
"rtp_lost",
"rtp_illegal",
"rtcp_counter",
"jitter",
"delay",
"codec",
"starttime",
"endtime",
"ptypes",
"packet_loss",
"rfc2833"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"subnet_statistics": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": [
"null",
"array"
]
},
"total": {
"type": "integer"
}
},
"required": [
"section"
],
"type": "object"
}
},
{
"description": "One SIP call of a finished PCAP analysis: peers, user agents, response codes, timing, the SIP message ladder (method or status line per message), health warnings and the call's streams.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"call_id": {
"description": "SIP Call-ID, as listed by pcap_summary",
"type": "string"
},
"job_id": {
"description": "job_id returned by pcap_analyze",
"type": "string"
}
},
"required": [
"job_id",
"call_id"
],
"type": "object"
},
"name": "pcap_get_call",
"outputSchema": {
"additionalProperties": false,
"properties": {
"activity_end": {
"type": "string"
},
"activity_start": {
"type": "string"
},
"call_id": {
"type": "string"
},
"diagnostics": {
"type": "string"
},
"health": {
"description": "analyzer warnings: one-way audio, codec/ptime asymmetry, late media, ...; empty = healthy",
"items": {
"additionalProperties": false,
"properties": {
"explanation": {
"type": "string"
},
"stream_ids": {
"items": {
"type": "integer"
},
"type": [
"null",
"array"
]
},
"tag": {
"type": "string"
}
},
"required": [
"tag",
"explanation"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"ladder": {
"description": "SIP flow; full messages via pcap_sip_messages",
"items": {
"additionalProperties": false,
"properties": {
"line": {
"description": "request or status line of the message",
"type": "string"
},
"time": {
"type": "string"
},
"transport": {
"type": "string"
},
"us": {
"type": "integer"
}
},
"required": [
"time",
"us",
"line"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"media_duration_s": {
"type": "number"
},
"media_end": {
"type": "string"
},
"media_start": {
"type": "string"
},
"peer_a": {
"type": "string"
},
"peer_b": {
"type": "string"
},
"reinvites": {
"type": "integer"
},
"response_codes": {
"type": "string"
},
"sip_messages": {
"type": "integer"
},
"stream_ids": {
"items": {
"type": "integer"
},
"type": [
"null",
"array"
]
},
"streams": {
"items": {
"additionalProperties": false,
"properties": {
"call_id": {
"type": "string"
},
"codec": {
"type": "string"
},
"delay_ms": {
"type": [
"null",
"number"
]
},
"dest": {
"type": "string"
},
"dtmf_events": {
"type": "integer"
},
"duration_s": {
"type": "number"
},
"impairments": {
"additionalProperties": {
"type": "integer"
},
"description": "PVQA detector -> number of 0.68 s intervals where it fired",
"type": "object"
},
"is_silent": {
"type": [
"null",
"boolean"
]
},
"jitter_ms": {
"type": [
"null",
"number"
]
},
"loss_percent": {
"type": "number"
},
"lost": {
"type": "integer"
},
"mos_network": {
"description": "MOS estimated from loss and jitter only",
"type": [
"null",
"number"
]
},
"mos_sevana": {
"description": "listening-quality MOS from the decoded speech (1-5); 0 or null = not scored (e.g. SRTP without key)",
"type": [
"null",
"number"
]
},
"packets": {
"type": "integer"
},
"src": {
"type": "string"
},
"stream_id": {
"type": "integer"
}
},
"required": [
"stream_id",
"src",
"dest",
"codec",
"mos_sevana",
"mos_network",
"packets",
"lost",
"loss_percent",
"duration_s",
"impairments",
"dtmf_events"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"useragent_a": {
"type": "string"
},
"useragent_b": {
"type": "string"
},
"worst_mos": {
"description": "lowest Sevana MOS of the call's streams",
"type": [
"null",
"number"
]
}
},
"required": [
"call_id",
"peer_a",
"peer_b",
"response_codes",
"media_duration_s",
"sip_messages",
"stream_ids",
"health",
"reinvites",
"ladder",
"streams"
],
"type": "object"
}
},
{
"description": "Full detail of one RTP stream: quality (Sevana and network MOS, R-factor, impairments, echo), loss gaps, payload types, DTMF events. include_timeline adds PVQA's per-interval (0.68 s) detector table.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"include_timeline": {
"description": "add the per-interval PVQA detector table (large)",
"type": "boolean"
},
"job_id": {
"description": "job_id returned by pcap_analyze",
"type": "string"
},
"stream_id": {
"description": "stream_id as listed by pcap_summary or pcap_get_call (valid only for this job)",
"type": "integer"
}
},
"required": [
"job_id",
"stream_id"
],
"type": "object"
},
"name": "pcap_get_stream",
"outputSchema": {
"additionalProperties": false,
"properties": {
"stream": {
"additionalProperties": false,
"description": "all fields of the stream as reported by the analyzer (no audio)",
"properties": {
"codec": {
"type": "string"
},
"delay": {
"type": [
"null",
"number"
]
},
"detector_report": {
"additionalProperties": false,
"properties": {
"echo": {
"items": {
"additionalProperties": false,
"properties": {
"length": {
"type": [
"null",
"number"
]
},
"level": {
"type": [
"null",
"number"
]
},
"time_ms": {
"type": "integer"
}
},
"required": [
"time_ms",
"level",
"length"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"headers": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"imps": {
"items": {
"additionalProperties": {
"type": "integer"
},
"type": "object"
},
"type": [
"null",
"array"
]
},
"mos": {
"type": [
"null",
"number"
]
},
"mos_model": {
"type": "string"
},
"rfactor": {
"type": [
"null",
"number"
]
},
"rows": {
"items": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"type": [
"null",
"array"
]
},
"vote_mos": {
"type": [
"null",
"number"
]
}
},
"required": [
"mos",
"rfactor",
"imps",
"echo",
"headers",
"rows"
],
"type": [
"null",
"object"
]
},
"endtime": {
"type": "integer"
},
"endtime_str": {
"type": "string"
},
"features": {
"additionalProperties": true,
"type": "object"
},
"is_silent": {
"type": [
"null",
"boolean"
]
},
"jitter": {
"type": [
"null",
"number"
]
},
"mos_model": {
"type": "string"
},
"mos_network": {
"type": [
"null",
"number"
]
},
"mos_sevana": {
"type": [
"null",
"number"
]
},
"mos_vote": {
"type": [
"null",
"number"
]
},
"packet_loss": {
"items": {
"additionalProperties": false,
"properties": {
"gap": {
"type": "integer"
},
"offset_end": {
"type": [
"null",
"number"
]
},
"offset_start": {
"type": [
"null",
"number"
]
},
"time_end": {
"type": "string"
},
"time_end_us": {
"type": "integer"
},
"time_start": {
"type": "string"
},
"time_start_us": {
"type": "integer"
}
},
"required": [
"time_start_us",
"time_end_us",
"time_start",
"time_end",
"offset_start",
"offset_end",
"gap"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"ptypes": {
"items": {
"additionalProperties": false,
"properties": {
"avg_ptime_ms": {
"type": [
"null",
"number"
]
},
"avg_size_bytes": {
"type": [
"null",
"number"
]
},
"count": {
"type": "integer"
},
"max_ptime_ms": {
"type": [
"null",
"number"
]
},
"min_ptime_ms": {
"type": [
"null",
"number"
]
},
"ptype": {
"type": "integer"
}
},
"required": [
"ptype",
"count"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"rfc2833": {
"items": {
"additionalProperties": false,
"properties": {
"time": {
"type": "string"
},
"time_us": {
"type": "integer"
},
"tone": {
"type": "string"
}
},
"required": [
"time_us",
"time",
"tone"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"rtcp_counter": {
"type": "integer"
},
"rtp_counter": {
"type": "integer"
},
"rtp_dest": {
"type": "string"
},
"rtp_illegal": {
"type": "integer"
},
"rtp_lost": {
"type": "integer"
},
"rtp_src": {
"type": "string"
},
"rtp_ssrc": {
"type": "integer"
},
"sip": {
"additionalProperties": false,
"properties": {
"bye": {
"type": "boolean"
},
"call_id": {
"type": "string"
},
"codec": {
"type": "string"
},
"peer1": {
"type": "string"
},
"peer2": {
"type": "string"
}
},
"required": [
"call_id",
"peer1",
"peer2",
"codec",
"bye"
],
"type": [
"null",
"object"
]
},
"starttime": {
"type": "integer"
},
"starttime_str": {
"type": "string"
},
"stream_id": {
"type": "integer"
}
},
"required": [
"stream_id",
"rtp_ssrc",
"rtp_src",
"rtp_dest",
"mos_sevana",
"mos_network",
"rtp_counter",
"rtp_lost",
"rtp_illegal",
"rtcp_counter",
"jitter",
"delay",
"codec",
"starttime",
"endtime",
"ptypes",
"packet_loss",
"rfc2833"
],
"type": [
"null",
"object"
]
},
"summary": {
"additionalProperties": false,
"properties": {
"call_id": {
"type": "string"
},
"codec": {
"type": "string"
},
"delay_ms": {
"type": [
"null",
"number"
]
},
"dest": {
"type": "string"
},
"dtmf_events": {
"type": "integer"
},
"duration_s": {
"type": "number"
},
"impairments": {
"additionalProperties": {
"type": "integer"
},
"description": "PVQA detector -> number of 0.68 s intervals where it fired",
"type": "object"
},
"is_silent": {
"type": [
"null",
"boolean"
]
},
"jitter_ms": {
"type": [
"null",
"number"
]
},
"loss_percent": {
"type": "number"
},
"lost": {
"type": "integer"
},
"mos_network": {
"description": "MOS estimated from loss and jitter only",
"type": [
"null",
"number"
]
},
"mos_sevana": {
"description": "listening-quality MOS from the decoded speech (1-5); 0 or null = not scored (e.g. SRTP without key)",
"type": [
"null",
"number"
]
},
"packets": {
"type": "integer"
},
"src": {
"type": "string"
},
"stream_id": {
"type": "integer"
}
},
"required": [
"stream_id",
"src",
"dest",
"codec",
"mos_sevana",
"mos_network",
"packets",
"lost",
"loss_percent",
"duration_s",
"impairments",
"dtmf_events"
],
"type": "object"
}
},
"required": [
"summary",
"stream"
],
"type": "object"
}
},
{
"description": "Network view of a finished PCAP analysis: packet and SIP counters, per-stream loss, jitter, delay and network MOS, and the aggregate statistics (correlations of MOS with network features) when computed.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"job_id": {
"description": "job_id returned by pcap_analyze",
"type": "string"
}
},
"required": [
"job_id"
],
"type": "object"
},
"name": "pcap_network_stats",
"outputSchema": {
"additionalProperties": false,
"properties": {
"packet_counters": {
"items": {
"additionalProperties": false,
"properties": {
"info": {
"type": "string"
},
"name": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"name",
"value"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"sip_statistics": {
"items": {
"additionalProperties": false,
"properties": {
"info": {
"type": "string"
},
"name": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"name",
"value"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"statistics": {
"additionalProperties": false,
"properties": {
"network_mos": {
"additionalProperties": false,
"properties": {
"algorithms": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"analysis_tier": {
"type": "string"
},
"correlations": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": [
"null",
"array"
]
},
"descriptive": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": [
"null",
"array"
]
},
"excluded_features": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"lasso": true,
"regression": true,
"sample_count": {
"type": "integer"
},
"target": {
"type": "string"
}
},
"required": [
"target",
"sample_count",
"analysis_tier",
"algorithms",
"descriptive",
"correlations"
],
"type": [
"null",
"object"
]
},
"sevana_mos": {
"additionalProperties": false,
"properties": {
"algorithms": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"analysis_tier": {
"type": "string"
},
"correlations": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": [
"null",
"array"
]
},
"descriptive": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": [
"null",
"array"
]
},
"excluded_features": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"lasso": true,
"regression": true,
"sample_count": {
"type": "integer"
},
"target": {
"type": "string"
}
},
"required": [
"target",
"sample_count",
"analysis_tier",
"algorithms",
"descriptive",
"correlations"
],
"type": [
"null",
"object"
]
}
},
"type": [
"null",
"object"
]
},
"streams": {
"items": {
"additionalProperties": false,
"properties": {
"call_id": {
"type": "string"
},
"codec": {
"type": "string"
},
"delay_ms": {
"type": [
"null",
"number"
]
},
"dest": {
"type": "string"
},
"illegal": {
"type": "integer"
},
"jitter_ms": {
"type": [
"null",
"number"
]
},
"loss_gaps": {
"type": "integer"
},
"lost": {
"type": "integer"
},
"mos_network": {
"type": [
"null",
"number"
]
},
"packets": {
"type": "integer"
},
"payload_types": {
"items": {
"additionalProperties": false,
"properties": {
"avg_ptime_ms": {
"type": [
"null",
"number"
]
},
"avg_size_bytes": {
"type": [
"null",
"number"
]
},
"count": {
"type": "integer"
},
"max_ptime_ms": {
"type": [
"null",
"number"
]
},
"min_ptime_ms": {
"type": [
"null",
"number"
]
},
"ptype": {
"type": "integer"
}
},
"required": [
"ptype",
"count"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"rtcp": {
"type": "integer"
},
"src": {
"type": "string"
},
"stream_id": {
"type": "integer"
}
},
"required": [
"stream_id",
"src",
"dest",
"codec",
"mos_network",
"packets",
"lost",
"illegal",
"rtcp",
"loss_gaps",
"payload_types"
],
"type": "object"
},
"type": [
"null",
"array"
]
}
},
"required": [
"packet_counters",
"sip_statistics",
"streams"
],
"type": "object"
}
},
{
"description": "SIP messages of a finished PCAP analysis, exactly as captured (headers and SDP bodies), in time order. Filter by call_id; paged with cursor/limit.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"call_id": {
"description": "only this call (default: all calls)",
"type": "string"
},
"cursor": {
"description": "index of the first message (from next_cursor)",
"type": "integer"
},
"job_id": {
"description": "job_id returned by pcap_analyze",
"type": "string"
},
"limit": {
"description": "messages per page (default 50, max 200)",
"type": "integer"
}
},
"required": [
"job_id"
],
"type": "object"
},
"name": "pcap_sip_messages",
"outputSchema": {
"additionalProperties": false,
"properties": {
"messages": {
"items": {
"additionalProperties": false,
"properties": {
"call_id": {
"type": "string"
},
"message": {
"description": "the SIP message as captured, headers and body",
"type": "string"
},
"time": {
"type": "string"
},
"transport": {
"type": "string"
},
"us": {
"type": "integer"
}
},
"required": [
"call_id",
"time",
"us",
"message"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"next_cursor": {
"type": [
"null",
"integer"
]
},
"total": {
"type": "integer"
}
},
"required": [
"total",
"messages"
],
"type": "object"
}
},
{
"description": "Overview of a finished PCAP analysis: packet totals, SIP calls with their health warnings, and streams ordered worst Sevana MOS first, each with codec, MOS, loss, jitter and impairments.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"job_id": {
"description": "job_id returned by pcap_analyze",
"type": "string"
},
"max_calls": {
"description": "calls to list (default 50, max 200)",
"type": "integer"
},
"max_streams": {
"description": "streams to list (default 50, max 200)",
"type": "integer"
}
},
"required": [
"job_id"
],
"type": "object"
},
"name": "pcap_summary",
"outputSchema": {
"additionalProperties": false,
"properties": {
"average_mos": {
"type": [
"null",
"number"
]
},
"call_list": {
"items": {
"additionalProperties": false,
"properties": {
"call_id": {
"type": "string"
},
"diagnostics": {
"type": "string"
},
"health": {
"description": "analyzer warnings: one-way audio, codec/ptime asymmetry, late media, ...; empty = healthy",
"items": {
"additionalProperties": false,
"properties": {
"explanation": {
"type": "string"
},
"stream_ids": {
"items": {
"type": "integer"
},
"type": [
"null",
"array"
]
},
"tag": {
"type": "string"
}
},
"required": [
"tag",
"explanation"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"media_duration_s": {
"type": "number"
},
"media_start": {
"type": "string"
},
"peer_a": {
"type": "string"
},
"peer_b": {
"type": "string"
},
"response_codes": {
"type": "string"
},
"sip_messages": {
"type": "integer"
},
"stream_ids": {
"items": {
"type": "integer"
},
"type": [
"null",
"array"
]
},
"worst_mos": {
"description": "lowest Sevana MOS of the call's streams",
"type": [
"null",
"number"
]
}
},
"required": [
"call_id",
"peer_a",
"peer_b",
"response_codes",
"media_duration_s",
"sip_messages",
"stream_ids",
"health"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"calls": {
"type": "integer"
},
"job_id": {
"type": "string"
},
"omitted": {
"additionalProperties": {
"type": "integer"
},
"description": "calls/streams left out of the lists; see pcap_full_report",
"type": "object"
},
"packets": {
"additionalProperties": {
"type": "string"
},
"description": "main packet counters",
"type": "object"
},
"software": {
"type": "string"
},
"stream_list": {
"description": "worst Sevana MOS first",
"items": {
"additionalProperties": false,
"properties": {
"call_id": {
"type": "string"
},
"codec": {
"type": "string"
},
"delay_ms": {
"type": [
"null",
"number"
]
},
"dest": {
"type": "string"
},
"dtmf_events": {
"type": "integer"
},
"duration_s": {
"type": "number"
},
"impairments": {
"additionalProperties": {
"type": "integer"
},
"description": "PVQA detector -> number of 0.68 s intervals where it fired",
"type": "object"
},
"is_silent": {
"type": [
"null",
"boolean"
]
},
"jitter_ms": {
"type": [
"null",
"number"
]
},
"loss_percent": {
"type": "number"
},
"lost": {
"type": "integer"
},
"mos_network": {
"description": "MOS estimated from loss and jitter only",
"type": [
"null",
"number"
]
},
"mos_sevana": {
"description": "listening-quality MOS from the decoded speech (1-5); 0 or null = not scored (e.g. SRTP without key)",
"type": [
"null",
"number"
]
},
"packets": {
"type": "integer"
},
"src": {
"type": "string"
},
"stream_id": {
"type": "integer"
}
},
"required": [
"stream_id",
"src",
"dest",
"codec",
"mos_sevana",
"mos_network",
"packets",
"lost",
"loss_percent",
"duration_s",
"impairments",
"dtmf_events"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"streams": {
"type": "integer"
},
"streams_scored": {
"description": "streams with a Sevana MOS",
"type": "integer"
},
"worst_mos": {
"type": [
"null",
"number"
]
}
},
"required": [
"job_id",
"packets",
"calls",
"streams",
"streams_scored",
"call_list",
"stream_list"
],
"type": "object"
}
},
{
"description": "Non-intrusive voice quality analysis (Sevana PVQA) of an uploaded WAV file: predicted MOS (1-5) and the impairments found (low SNR, noise, dead air, clipping, clicks, echo, packet-loss artifacts, ...). No reference recording is needed. report_type \"extended\" adds the per-interval detector table.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"channel": {
"description": "channel to analyze, from 0 (default 0); -1 mixes all channels",
"type": "integer"
},
"report_type": {
"description": "\"basic\" (default) or \"extended\" (adds the per-interval table)",
"type": "string"
},
"upload_id": {
"description": "upload_id of a WAV file",
"type": "string"
}
},
"required": [
"upload_id"
],
"type": "object"
},
"name": "pvqa_analyze",
"outputSchema": {
"additionalProperties": false,
"properties": {
"channel": {
"type": "integer"
},
"impairments": {
"description": "detectors that fired, with their interval counts",
"items": {
"additionalProperties": false,
"properties": {
"detector": {
"description": "detector name, e.g. SNR, Echo, Click, DeadAir-00",
"type": "string"
},
"intervals": {
"description": "number of intervals where this detector fired",
"type": "integer"
}
},
"required": [
"detector",
"intervals"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"intervals": {
"additionalProperties": false,
"properties": {
"excluded": {
"description": "intervals excluded from the score (silence, DTMF)",
"type": "integer"
},
"poor": {
"description": "intervals with an impairment",
"type": "integer"
},
"total": {
"description": "number of 0.68 s analysis intervals",
"type": "integer"
},
"uncertain": {
"description": "intervals the detectors could not classify",
"type": "integer"
}
},
"required": [
"total",
"poor",
"uncertain",
"excluded"
],
"type": "object"
},
"is_silent": {
"description": "true when the file contains no signal",
"type": "boolean"
},
"mos": {
"description": "predicted MOS (1-5); null when the file has no speech to score",
"type": [
"null",
"number"
]
},
"mos_model": {
"description": "name of the learned MOS model that produced the score",
"type": "string"
},
"rfactor": {
"description": "share of good intervals (0-1)",
"type": [
"null",
"number"
]
},
"timeline": {
"additionalProperties": false,
"description": "per-interval detector values (report_type=extended only)",
"properties": {
"columns": {
"description": "column names: Time, then one per detector, then Status",
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"rows": {
"description": "one row per 0.68 s interval, values as printed by the analyzer",
"items": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"type": [
"null",
"array"
]
}
},
"required": [
"columns",
"rows"
],
"type": [
"null",
"object"
]
},
"upload_id": {
"type": "string"
}
},
"required": [
"upload_id",
"channel",
"mos",
"is_silent",
"intervals",
"impairments"
],
"type": "object"
}
},
{
"description": "Raw values of one PVQA detector over time for an uploaded WAV file. Detectors: SNR, DeadAir-00, DeadAir-01, Click, VADClip, AmpClip, DynClip, Echo, Noise, Crushed, DTMF.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"channel": {
"description": "channel to analyze, from 0 (default 0)",
"type": "integer"
},
"detector": {
"description": "detector name: SNR, DeadAir-00, DeadAir-01, Click, VADClip, AmpClip, DynClip, Echo, Noise, Crushed or DTMF",
"type": "string"
},
"upload_id": {
"description": "upload_id of a WAV file",
"type": "string"
}
},
"required": [
"upload_id",
"detector"
],
"type": "object"
},
"name": "pvqa_detector",
"outputSchema": {
"additionalProperties": false,
"properties": {
"detector": {
"type": "string"
},
"names": {
"description": "value names; the first is the detector's main value",
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"rows": {
"items": {
"additionalProperties": false,
"properties": {
"offset_ms": {
"type": "number"
},
"values": {
"items": {
"type": "number"
},
"type": [
"null",
"array"
]
}
},
"required": [
"offset_ms",
"values"
],
"type": "object"
},
"type": [
"null",
"array"
]
},
"upload_id": {
"type": "string"
}
},
"required": [
"upload_id",
"detector",
"names",
"rows"
],
"type": "object"
}
},
{
"description": "Impairment timeline of an uploaded WAV file: which impairments PVQA detects at which time.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"channel": {
"description": "channel to analyze, from 0 (default 0)",
"type": "integer"
},
"resolution_ms": {
"description": "time step of the returned rows in ms (default 250, min 10); each row holds the maximum of every numeric column in its window. Coarsened automatically to stay within 1000 rows",
"type": "integer"
},
"upload_id": {
"description": "upload_id of a WAV file",
"type": "string"
}
},
"required": [
"upload_id"
],
"type": "object"
},
"name": "pvqa_timeline",
"outputSchema": {
"additionalProperties": false,
"properties": {
"channel": {
"type": "integer"
},
"columns": {
"description": "Time (seconds, window start), then detector values",
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"resolution_ms": {
"type": "integer"
},
"rows": {
"items": {
"items": true,
"type": [
"null",
"array"
]
},
"type": [
"null",
"array"
]
},
"upload_id": {
"type": "string"
}
},
"required": [
"upload_id",
"channel",
"resolution_ms",
"columns",
"rows"
],
"type": "object"
}
},
{
"description": "Analyzer versions, your tier (free or API key), your limits and how many analyses you have left.",
"inputSchema": {
"additionalProperties": false,
"type": "object"
},
"name": "server_info",
"outputSchema": {
"additionalProperties": false,
"properties": {
"analyzers": {
"additionalProperties": {
"type": "string"
},
"description": "analyzer name -> version",
"type": "object"
},
"key_name": {
"type": "string"
},
"limits": {
"additionalProperties": false,
"properties": {
"analyses": {
"description": "analyses allowed per window (0 = unlimited)",
"type": "integer"
},
"concurrent": {
"type": "integer"
},
"max_inline_bytes": {
"type": "integer"
},
"max_pcap_bytes": {
"type": "integer"
},
"max_wav_bytes": {
"type": "integer"
},
"max_wav_seconds": {
"type": "number"
},
"remaining": {
"description": "analyses left in the current window",
"type": [
"null",
"integer"
]
},
"window_seconds": {
"type": "integer"
}
},
"required": [
"analyses",
"window_seconds",
"max_wav_bytes",
"max_wav_seconds",
"max_pcap_bytes",
"max_inline_bytes",
"concurrent"
],
"type": "object"
},
"role": {
"type": "string"
},
"server": {
"type": "string"
},
"tier": {
"description": "\"free\" (no API key) or \"api_key\"",
"type": "string"
},
"upload_ttl_seconds": {
"type": "integer"
}
},
"required": [
"server",
"analyzers",
"tier",
"role",
"limits",
"upload_ttl_seconds"
],
"type": "object"
}
},
{
"description": "Upload a WAV or pcap file as base64 in the tool arguments (2 MB at most after decoding). Returns an upload_id for the analysis tools. Larger files: use create_upload.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"content_base64": {
"description": "the whole file, base64 encoded",
"type": "string"
},
"filename": {
"description": "original file name, for display only",
"type": "string"
},
"kind": {
"description": "file kind: \"wav\" (default) or \"pcap\"",
"type": "string"
}
},
"required": [
"content_base64"
],
"type": "object"
},
"name": "upload_inline",
"outputSchema": {
"additionalProperties": false,
"properties": {
"expires_at": {
"description": "the file is deleted at this time",
"type": "string"
},
"filename": {
"type": "string"
},
"size_bytes": {
"type": "integer"
},
"upload_id": {
"type": "string"
},
"wav": {
"additionalProperties": false,
"properties": {
"bits_per_sample": {
"type": "integer"
},
"channels": {
"type": "integer"
},
"duration_seconds": {
"type": "number"
},
"format": {
"type": "integer"
},
"sample_rate": {
"type": "integer"
}
},
"required": [
"format",
"channels",
"sample_rate",
"bits_per_sample",
"duration_seconds"
],
"type": [
"null",
"object"
]
}
},
"required": [
"upload_id",
"size_bytes",
"expires_at"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:022d19e76d3bb95bf115c100d2bcc522d156b40e9718f3ce19b2f2415d1797d8 | sha256sum