start_live_capture
Initiate a live network traffic capture session for incremental polling and debugging. Returns a capture ID required for subsequent live analysis tools. Use adopt_existing to take over ongoing Charles sessions without clearing data.
Instructions
Start or adopt a live capture session for incremental polling. Returns a capture_id required by all other live tools. Use adopt_existing=true to take over an ongoing Charles session without clearing it.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reset_session | No | ||
| include_existing | No | ||
| adopt_existing | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | ||
| managed | Yes | ||
| warnings | No | ||
| capture_id | Yes | ||
| include_existing | Yes |
Implementation Reference
- charles_mcp/tools/live.py:61-78 (handler)The handler for the start_live_capture tool, which triggers the live service start method.
async def start_live_capture( ctx: ToolContext, reset_session: bool = True, include_existing: bool = False, adopt_existing: bool = False, ) -> LiveCaptureStartResult: """Start or adopt a live capture session for incremental polling. Returns a capture_id required by all other live tools. Use adopt_existing=true to take over an ongoing Charles session without clearing it.""" deps = get_tool_dependencies(ctx) try: return await deps.live_service.start( reset_session=reset_session, include_existing=include_existing, adopt_existing=adopt_existing, ) except Exception as exc: raise ValueError(str(exc)) from exc