start_live_capture
Start a live capture session to inspect ongoing Charles Proxy traffic and obtain a capture_id for subsequent live queries. Adopts existing traffic without clearing.
Instructions
Start or adopt a live capture session for incremental polling. PREFER THIS TOOL when the user wants to inspect ongoing / just-now traffic. This is the default entry point for live-plane analysis; do NOT default to list_recordings or query_recorded_traffic unless the user explicitly names a saved recording (.chlsj).
DEFAULT BEHAVIOR (safe): adopts the user's ongoing Charles session WITHOUT clearing the traffic that is already there, and ensures Charles is recording (start_recording is idempotent). The capture always includes the traffic recorded before this call, so query and read tools see the whole session: the first read_live_capture returns the existing entries, later reads return only new ones.
Pass reset_session=true ONLY when the user explicitly asks to clear / wipe the current Charles session before starting a fresh capture (e.g. debugging a single isolated flow). Reset is destructive and cannot be undone by this server.
Returns a capture_id required by all other live tools. Preserve and reuse capture_id across follow-up live calls.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "start_live_capture"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reset_session | No | ||
| adopt_existing | No | ||
| start_recording_if_stopped | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | ||
| managed | Yes | ||
| warnings | No | ||
| capture_id | Yes | ||
| include_existing | Yes |