Charles MCP Server

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.

Read incremental traffic and advance the cursor. Returns compact entry summaries (host/method/path/status only). Use query_live_capture_entries for structured filtering instead of this tool. This tool advances the internal cursor — repeated calls only return new items.

Preview incremental traffic without advancing the cursor. Returns compact entry summaries (host/method/path/status only). Safe to call repeatedly — does not consume items. Use query_live_capture_entries for structured filtering and analysis.

Stop an active live capture and optionally persist the filtered snapshot. Only status='stopped' means the capture is fully closed.

Analyze the active live capture with structured summary-first filtering. This is the RECOMMENDED tool for inspecting live traffic. Does NOT advance the cursor — safe to call repeatedly with different filters. Default cursor=0 scans all captured data from the beginning. Use get_traffic_entry_detail to drill down into a specific entry_id.

Analyze a saved recording snapshot with compact summaries. Returns structured TrafficSummary items with matched_fields and match_reasons. Use get_traffic_entry_detail to drill down into a specific entry_id afterwards.

Load one traffic entry detail view for drill-down inspection. Requires entry_id from a prior summary/query call. For history entries, pass recording_path from the summary. For live entries, pass capture_id from the summary. Keep include_full_body=false unless you specifically need the raw body text.

Return coarse traffic class counts for a live capture or saved recording.

Group analyzed traffic so the agent can inspect hot spots with lower token cost.

Query the latest saved recording. This tool never reads the live Charles session.

List saved recording files using an explicit history-oriented tool name.

Load a saved recording snapshot. This tool never reads the live Charles session.

Capture traffic for a fixed duration or read the latest saved history package.

Filter traffic from a fixed capture window or the latest saved history package.

Set a network throttling preset in Charles.

Reset the Charles environment and restore the saved configuration.

List historical session files via the legacy tool name.

Check Charles connectivity and active live-capture state.