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

• 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

Prerequisites

• HTTP Toolkit server running locally (default: http://127.0.0.1:45457)
• 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

Example with 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

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:

• "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"

Architecture

┌─────────────────┐     stdio      ┌──────────────────┐    REST API    ┌─────────────────────┐
│   AI Assistant   │◄─────────────►│  httptoolkit-mcp  │◄────────────►│  httptoolkit-server  │
│ (Claude, etc.)   │     MCP       │   (this project)  │   :45457     │     (HTTP Toolkit)   │
└─────────────────┘               └──────────────────┘               └─────────────────────┘
                                                                              │
                                                                     ┌────────┴────────┐
                                                                     │  Mockttp Proxy   │
                                                                     │   :8000/45456    │
                                                                     └────────┬────────┘
                                                                              │
                                                              ┌───────────────┼───────────────┐
                                                              │               │               │
                                                         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