httptoolkit-mcp

A Model Context Protocol (MCP) server that provides AI assistants with full control over HTTP Toolkit — the powerful, open-source HTTP(S) debugging proxy.

Intercept, inspect, and debug HTTP traffic from browsers, Android/iOS devices, Docker containers, JVM processes, and more — all through natural language via your AI assistant.

Features

• Live Traffic Capture — Capture intercepted HTTP traffic in real-time with full request/response headers and bodies

• Browser Interception — Launch Chrome or Firefox with traffic automatically routed through the proxy

• Android Interception — Intercept device traffic via ADB or target specific apps with Frida (bypasses certificate pinning)

• iOS Interception — Intercept specific iOS apps via Frida on jailbroken devices

• Docker Interception — Attach to running Docker containers and capture all outgoing HTTP traffic

• Terminal Interception — Open intercepted terminal sessions or configure existing ones

• JVM Attach — Attach to running Java/Kotlin/Clojure processes

• Electron Apps — Launch Electron applications with interception enabled

• HTTP Client — Send HTTP requests through the proxy with full control over method, headers, and body

• Server Management — Query configuration, manage interceptors, and control the server lifecycle

• Zero-Config with Desktop App — Automatically detects auth token from the running HTTP Toolkit desktop app

Related MCP server: mcp-browser-kit

Prerequisites

• HTTP Toolkit installed and running (desktop app or server)

• Node.js >= 18

Installation

Using npx (recommended)

No installation required — just configure your MCP client:

{
  "mcpServers": {
    "httptoolkit": {
      "command": "npx",
      "args": ["-y", "httptoolkit-mcp"]
    }
  }
}

Global install

npm install -g httptoolkit-mcp

From source

git clone https://github.com/fdciabdul/httptoolkit-mcp.git
cd httptoolkit-mcp
npm install
npm run build

Configuration

Claude Code

Add to ~/.claude/settings.json or ~/.claude.json:

{
  "mcpServers": {
    "httptoolkit": {
      "command": "npx",
      "args": ["-y", "httptoolkit-mcp"]
    }
  }
}

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "httptoolkit": {
      "command": "npx",
      "args": ["-y", "httptoolkit-mcp"]
    }
  }
}

Environment Variables

Note: When using the HTTP Toolkit desktop app, the auth token is automatically detected from the running process — no manual configuration needed.

Example with manual environment variables:

{
  "mcpServers": {
    "httptoolkit": {
      "command": "npx",
      "args": ["-y", "httptoolkit-mcp"],
      "env": {
        "HTK_SERVER_URL": "http://127.0.0.1:45457",
        "HTK_SERVER_TOKEN": "your-token-here"
      }
    }
  }
}

Available Tools

Traffic Capture

Server Management

Interceptor Management

Browser Interception

Terminal Interception

Docker Interception

Android Interception

iOS Interception

Application Interception

HTTP Client

Usage Examples

Once configured, you can ask your AI assistant things like:

• "Capture the HTTP traffic from my intercepted Chrome for 10 seconds"

• "List all available interceptors"

• "Intercept Chrome on port 8000"

• "Show me the connected Android devices"

• "Attach to the Docker container running my API"

• "Send a GET request to https://api.example.com/users"

• "Set up Frida on my Android device and intercept the target app"

• "Open an intercepted terminal session"

Capture Traffic Example

User: "Capture traffic from my browser for 5 seconds"

capture_traffic({ duration: 5, sessionId: "2474b580-482e-4a79-8488-121583d466e1" })

Result:
{
  "capturedExchanges": 2,
  "exchanges": [
    {
      "request": {
        "method": "GET",
        "url": "https://api.example.com/users",
        "headers": { "host": "api.example.com", ... },
      },
      "response": {
        "statusCode": 200,
        "headers": { "content-type": "application/json", ... },
        "body": "[{\"id\": 1, \"name\": \"John\"}]"
      }
    }
  ]
}

Architecture

┌─────────────────┐     stdio      ┌──────────────────┐    REST API    ┌─────────────────────┐
│   AI Assistant   │◄─────────────►│  httptoolkit-mcp  │◄────────────►│  httptoolkit-server  │
│ (Claude, etc.)   │     MCP       │   (this project)  │   :45457     │     (HTTP Toolkit)   │
└─────────────────┘               └──────────────────┘               └─────────────────────┘
                                          │                                    │
                                          │ WebSocket                 ┌────────┴────────┐
                                          │ (traffic capture)         │  Mockttp Proxy   │
                                          └──────────────────────────►│  :45456 (admin)  │
                                                                      │  :8000  (proxy)  │
                                                                      └────────┬────────┘
                                                                               │
                                                               ┌───────────────┼───────────────┐
                                                               │               │               │
                                                          Browsers       Android/iOS      Docker
                                                                         Devices        Containers

Credits

This project is an MCP interface for HTTP Toolkit, created by Tim Perry (@pimterry).

• HTTP Toolkit — github.com/httptoolkit

• HTTP Toolkit Server — github.com/httptoolkit/httptoolkit-server

• Tim Perry — github.com/pimterry — Creator & maintainer of HTTP Toolkit

HTTP Toolkit is a beautiful, open-source tool for debugging, testing, and building with HTTP(S). If you find it useful, consider supporting the project.

License

MIT