MCP tools reference

Full parameter and return value documentation for each MCP tool. See MCP server for setup instructions.

​

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 calls ctx.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 by list_requests and search_requests.