Skip to main content
httpmon includes a built-in Model Context Protocol (MCP) server that lets LLM agents inspect captured traffic, replay requests, manage scripts, and control throttling — all programmatically.

​
Starting the MCP server

Pass --mcp to enable the server on the default address (127.0.0.1:9551):
Use --mcp-addr for a custom address:
When the MCP server is active, the status bar shows MCP :9551 (or your custom port).

​
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:
Print the token without starting the proxy:
The token is also printed to stderr on startup:

​
Available tools

The server exposes 14 tools organized into three categories:

​
Read tools

Inspect captured traffic without side effects.

​
Simulation tools

Replay requests and control proxy behavior.

​
Script tools

Manage JavaScript hooks. For full parameter and return value documentation, see the MCP tools reference.

​
Transport

The server uses HTTP Streamable transport (JSON-RPC 2.0 over HTTP POST). It listens on localhost only by default for security.

​
Integration

See MCP integration guide for configuration snippets for Claude Desktop, Cursor, and Claude Code.