HTTP/HTTPS Interception
Capture and inspect all HTTP/HTTPS traffic in real time with automatic on-the-fly TLS certificate generation.
Open Source · Rust-powered · MIT / Apache-2.0 See every byte.
See every byte.
Debug any HTTP traffic.
Madhyamas is a high-performance, cross-platform HTTP/HTTPS debugging proxy with a modern web UI. The free, open-source alternative to Charles Proxy and Fiddler.
- 159CLI subcommands
- 184REST API endpoints
- 146MCP tools for AI agents
- 8Platforms · Linux · macOS · Windows · ARM
Built with
RustaxumhypertokiorustlsReactTypeScriptVite
Everything you need to inspect traffic
A complete debugging toolkit that captures, inspects, and manipulates HTTP, HTTPS, WebSocket, and gRPC traffic in real time.
Modern Web UI
A React-based interface with real-time WebSocket streaming — no polling, no refresh, just live traffic.
Smart Filtering
Filter by URL, method, status, host, content type, duration, headers, and cookies to find anything fast.
HTTP/2 Upstream
Full HTTP/2 support for upstream connections with ALPN negotiation out of the box.
Request Replay
Re-execute captured requests with modifications. Save and replay without retyping a thing.
Session Management
Save, load, and share debugging sessions. Export to HAR, import previous captures, switch contexts instantly.
Inspect every response in detail
Syntax-highlighted JSON, image previews, decompression, and powerful query languages built in.
Syntax-highlighted JSON viewer
Prism.js-powered highlighting with collapsible Tree and Code views, plus prettify / minify toggle.
JSONPath & JMESPath queries
Filter and extract JSON data with expressions like
$.store.book[*].title.Image preview
Automatic rendering for PNG, JPEG, GIF, WebP, SVG, ICO, BMP, AVIF, and TIFF responses with download.
Decompression & decoding
Toggle gzip / deflate / brotli decompression on demand. Automatic base64 decoding of binary bodies.
Copy as cURL / HTTPie / fetch / wget
Export any request as a ready-to-paste command-line command in your favorite tool.
Don't just watch — take control
Pause, mock, rewrite, throttle, and replay traffic to reproduce any scenario.
Breakpoints
Pause requests or responses for inspection and modification before forwarding.
Response Mocking
Serve custom responses instead of hitting real servers. Collections, recording, import & export.
URL / Header Rewriting
Automatically modify traffic based on rules — redirect, replace, inject headers.
Bandwidth Throttling
Simulate slow networks with 3G, 4G, and DSL presets to test under real conditions.
SSL/TLS error visibility
Failed TLS handshakes (e.g. apps with certificate pinning) are recorded as 502 entries with a clear explanation of the cause — so nothing disappears silently.
Beyond plain HTTP
WebSocket capture, gRPC debugging, scripting, a plugin system to extend Madhyamas your way — plus enterprise-grade features for teams.
WebSocket Capture
Inspect WebSocket messages in real time alongside your HTTP traffic.
gRPC Support Experimental
Debug gRPC / Protocol Buffer traffic with frame parsing and stream inspection.
JS/TS Scripting Experimental
Automate traffic manipulation with JavaScript and TypeScript scripts.
Plugin System Experimental
Extend functionality with custom Rust plugins. Enable, disable, and reload at runtime.
Enterprise For teams
Authentication, RBAC, audit logging, SSO, and multi-instance deployment for team and production environments.
Android VPN Companion
A no-root Android app uses VpnService to transparently route device traffic to the proxy.
AI agent integration
Debug with your AI assistant
Madhyamas ships with a built-in MCP (Model Context Protocol) server. Let AI agents like Claude inspect traffic, create mocks, replay requests, and export sessions — directly from your conversation.
- List, search, and inspect captured traffic
- Create and toggle mock responses
- Replay requests with modifications
- Export sessions as HAR or cURL
- Full CLI with
--jsonfor machine-readable output
Why Madhyamas?
Open source, free, cross-platform, Rust-powered, and built for the modern web.
| Feature | Madhyamas | Charles | mitmproxy | Fiddler | Proxyman |
|---|---|---|---|---|---|
| Open Source | Yes | No | Yes | No | No |
| Free | Yes | $50 | Yes | Yes | Freemium |
| Cross-platform | Yes | Yes | Yes | Windows | macOS |
| Web UI | Yes | No | Limited | No | No |
| Native, memory-safe core | Yes (Rust) | No (Java) | No (Python) | No (.NET) | No (Swift) |
| gRPC | Exp. | No | Yes | No | No |
| WebSocket | Yes | Limited | Yes | Yes | Yes |
| Scripting | JS/TS | No | Python | No | No |
| JSON Query | JSONPath + JMESPath | No | No | No | No |
| MCP / AI Agent | Yes | No | No | No | No |
| Auth & RBAC | Enterprise | No | No | No | No |
| Audit Logging | Enterprise | No | No | No | No |
| Multi-Instance | Enterprise | No | No | No | No |
| PostgreSQL Storage | Enterprise | No | No | No | No |
Comparison based on publicly documented capabilities as of August 2026. “Fiddler” refers to the classic Windows release; Fiddler Everywhere is a separate cross-platform product. “Enterprise” features require the enterprise tier; experimental (“Exp.”) features may have limitations.
Install in minutes
A single unified binary includes the proxy, web UI, MCP server, and CLI. No runtime dependencies.
From source
# Clone & build git clone https://github.com/ShristiLabs/madhyamas.git cd madhyamas cargo build --release # Run the proxy + web UI ./target/release/madhyamas
Pre-built binaries
Download the latest release for your platform from the Releases page. Available for:
Linux x86_64Linux ARM64Linux ARMv7Linux ARMv6Linux RISC-VmacOS IntelmacOS Apple SiliconWindows x64
Download releasesSubcommands
madhyamas # proxy + web UI madhyamas serve # same as above madhyamas mcp # MCP server (stdio) madhyamas traffic list # CLI command madhyamas --help # all commands
Quick start
- Run
madhyamas— proxy on:8888, web UI on:3001 - Point your browser or app proxy to
localhost:8888 - Install the CA cert from
~/.madhyamas/certs/madhyamas-ca.pemfor HTTPS - Open
http://localhost:3001and start debugging
Read the docs
Step-by-step guides for every feature, from basic setup to advanced traffic manipulation.
Getting Started
Installation, first launch, connecting your first client, and basic configuration.
Traffic Inspection
Viewing, filtering, searching, and exporting captured HTTP/HTTPS traffic.
HTTPS & Certificates
Installing the Madhyamas CA certificate on macOS, Windows, Linux, iOS, and Android.
Breakpoints
Pause requests or responses, inspect them, and modify before forwarding.
Mocks
Create fake API responses, record from real traffic, and organize into collections.
Mobile Setup
Connect iPhones, iPads, and Android devices over Wi-Fi to debug mobile app traffic.
MCP & AI Agents
Connect Claude, Cursor, Windsurf, and Devin to inspect traffic and drive the proxy via MCP.
CLI Reference
159 subcommands for traffic, mocks, replay, sessions, scripts, plugins, and more — with JSON output.
Troubleshooting
Fixes for certificate errors, port conflicts, database locks, mobile connections, and MCP issues.
Start debugging smarter today
Free, open source, and built to last. Star the repo and join the community.