start_capture_session
Initiate a packet capture session on SharkMCP to analyze network traffic. Configure filters, interfaces, and packet limits, or use saved configurations. Auto-stops after a set timeout to manage session duration.
Instructions
Start a background packet capture session. LLMs control all capture parameters including filters, interfaces, and packet limits. Can use saved configurations.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
captureFilter | No | Optional BPF capture filter to apply while capturing (e.g., "port 443") | |
configName | No | Name of saved configuration to use (will override other parameters) | |
interface | No | Network interface to capture from (e.g., eth0, en0, lo0) | lo0 |
maxPackets | No | Maximum number of packets to capture (safety limit, default: 100,000) | |
sessionName | No | Optional session name for easier identification | |
timeout | No | Timeout in seconds before auto-stopping capture (default: 60s to prevent orphaned sessions) |