Capture summary
pcap_infoSummarize a capture file to get packet count, duration, timestamps, size, link type, and top protocol-hierarchy entries before choosing a protocol-specific analysis tool.
Instructions
Summarise a capture file: packet count, duration, first/last timestamp, size,
link type and the top protocol-hierarchy entries. Call this first to learn what a
capture contains before choosing a protocol tool. path must be inside an allowed
directory.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>"
},
"name": "pcap_info"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Same forms as start | |
| path | Yes | Capture file (absolute, in an allowed dir) or open_capture handle | |
| start | No | ISO 8601, epoch s, +Ns from start, -Ns from end | |
| redact | No | Replace subscriber identifiers in this result with tokens; ids+ips hides every IP too | off |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | No | ||
| error | No | ||
| ipsec | No | keys: esp_packets, spis, decoded_null, unreadable, esp_null, hint | |
| limits | No | ||
| window | No | ||
| packets | No | ||
| capinfos | No | ||
| file_type | No | ||
| link_type | No | ||
| duration_s | No | ||
| last_packet | No | ||
| window_hint | No | ||
| first_packet | No | ||
| file_size_bytes | No | ||
| interface_drops | No | ||
| frames_in_window | No | ||
| last_packet_epoch | No | ||
| first_packet_epoch | No | ||
| metadata_available | No | ||
| protocol_hierarchy | No | rows with keys: protocol, frames, bytes |