start_capture_session
Initiate a packet capture session with customizable parameters like filters, interfaces, and packet limits on SharkMCP. Use saved configurations to streamline network analysis.
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) |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"captureFilter": {
"description": "Optional BPF capture filter to apply while capturing (e.g., \"port 443\")",
"type": "string"
},
"configName": {
"description": "Name of saved configuration to use (will override other parameters)",
"type": "string"
},
"interface": {
"default": "lo0",
"description": "Network interface to capture from (e.g., eth0, en0, lo0)",
"type": "string"
},
"maxPackets": {
"default": 100000,
"description": "Maximum number of packets to capture (safety limit, default: 100,000)",
"type": "number"
},
"sessionName": {
"description": "Optional session name for easier identification",
"type": "string"
},
"timeout": {
"default": 60,
"description": "Timeout in seconds before auto-stopping capture (default: 60s to prevent orphaned sessions)",
"type": "number"
}
},
"type": "object"
}