Starting the MCP server
Pass--mcp to enable the server on the default address (127.0.0.1:9551):
--mcp-addr for a custom address:
Authentication
The MCP server uses bearer token authentication. A 32-byte random hex token is generated on first use and stored in~/.httpmon/config.json (in the mcp_token field).
Every request must include the token:
Available tools
The server exposes 14 tools organized into three categories:Read tools
Inspect captured traffic without side effects.| Tool | Description |
|---|---|
list_requests | Paginated flow listing with optional filter |
search_requests | Substring search on host and path |
get_request | Full flow details (headers, bodies) |
get_request_count | Count flows matching a filter |
export_har | Export flows to HAR 1.2 JSON |
Simulation tools
Replay requests and control proxy behavior.| Tool | Description |
|---|---|
replay_request | Resend a captured request or compose a new one |
mock_response | Intercept matching URLs and return synthetic responses |
set_throttle | Apply bandwidth throttling (preset or custom) |
get_throttle | Query current throttle state |
Script tools
Manage JavaScript hooks.| Tool | Description |
|---|---|
list_scripts | All scripts with metadata and status |
create_script | Write a new JavaScript hook |
get_script | Fetch script source and metadata |
toggle_script | Enable or disable a script |
delete_script | Remove a script |