Read tools
list_requests
Paginated listing of captured flows. Parameters:
Returns:
{ items: FlowSummary[], total: int }
search_requests
Substring search on host and path. Parameters:
Returns:
{ items: FlowSummary[], total: int }
get_request
Full details for a single flow including headers and bodies. Parameters:
Returns:
{ meta: FlowMeta, request: { headers, body }, response: { headers, body } }
When dump is true, body fields contain file paths instead of content.
get_request_count
Count flows matching a filter. Parameters:
Returns:
{ total: int }
export_har
Export flows to HAR 1.2 format. Parameters:
Returns: HAR document as JSON string.
Simulation tools
replay_request
Resend a captured request or compose a new one. The request routes through the proxy and appears in the flow list. Parameters (replay existing):
Parameters (compose new):
Returns:
{ status_code: int }
mock_response
Intercept matching URLs and return a synthetic response. Creates an internal script that callsctx.respondWith().
Parameters:
Returns:
{ script_id: string }
set_throttle
Apply bandwidth throttling. Parameters:
Use
preset for standard profiles or bps + latency_ms for custom values.
Returns: { bps: int, latency_ms: int, active: bool }
get_throttle
Query current throttle state. Parameters: none Returns:{ bps: int, latency_ms: int, active: bool }
Script tools
Scripts are identified by opaque IDs (16-character hex strings), not file paths.list_scripts
List all scripts with metadata. Parameters: none Returns:{ scripts: [{ name, script_id, match_patterns, enabled, category }] }
create_script
Write a new JavaScript hook. Parameters:
Returns:
{ script_id: string }
get_script
Fetch a script’s source and metadata. Parameters:
Returns:
{ name, match_patterns, enabled, categories, source }
toggle_script
Enable or disable a script without deleting it. Parameters:
Returns:
{ enabled: bool }
delete_script
Remove a script file. Parameters:
Returns:
{ deleted: bool }
Data types
FlowSummary
Returned bylist_requests and search_requests.