v0.33.3

This is a maintenance release focused on internal dependency updates and tooling improvements.

Improvements

• (Personal Edition) Upgraded frontend stack to latest versions: Tailwind CSS v4, DaisyUI v5, Vite 8, and TypeScript 6 for improved development experience and performance

Minor internal improvements and maintenance updates.

---

Download Installers

Platform	Download	Notes
macOS (Apple Silicon)	Download DMG	Signed & Notarized - Recommended for M1/M2/M3/M4
macOS (Intel)	Download DMG	Signed & Notarized
Windows (64-bit)	Download Setup	Setup wizard
Windows (ARM64)	Download Setup	For ARM Windows devices
Linux Debian/Ubuntu (AMD64)	Download .deb	sudo apt install ./mcpproxy_*.deb
Linux Debian/Ubuntu (ARM64)	Download .deb	For ARM64 (Raspberry Pi etc.)
Linux Fedora/RHEL (AMD64)	Download .rpm	sudo dnf install ./mcpproxy-*.rpm
Linux Fedora/RHEL (ARM64)	Download .rpm	For ARM64
Linux (AMD64) — tarball	Download tar.gz	Binary only
Linux (ARM64) — tarball	Download tar.gz	Binary only

Homebrew (macOS/Linux):

brew install smart-mcp-proxy/mcpproxy/mcpproxy

Other download options (auto-update URLs, archives)

Auto-update URLs (always points to latest):

• Linux AMD64 | Linux ARM64
• Windows AMD64 | Windows ARM64
• macOS AMD64 | macOS ARM64

Binary archives (this version):

• macOS AMD64 | macOS ARM64
• Windows AMD64 | Windows ARM64

---

Installation Instructions

Windows

1. Download the installer for your architecture
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. Launch "MCPProxy" from Start Menu

macOS

1. Download the signed DMG for your Mac
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. Launch mcpproxy.app from Applications folder

Linux / Manual Installation

1. Download the appropriate archive
2. Extract: tar -xzf mcpproxy-*.tar.gz
3. Make executable: chmod +x mcpproxy
4. Run: ./mcpproxy serve

Platform Support & Usage

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (CLI)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

mcpproxy serve                           # Start server
mcpproxy serve --listen 127.0.0.1:8081  # Custom port
export MCPPROXY_API_KEY=your-secret-key  # Set API key

v0.33.2

This release focuses on repository infrastructure improvements and bug fixes to enhance tool quarantine visibility and streamline the MCP Registry publishing process.

Bug Fixes

• Tool-level quarantine visibility (Personal & Teams): The Servers list in the web UI now properly displays tool-level quarantine status, making it easier to see which specific tools are quarantined rather than just server-level status
• MCP Registry publishing: Removed duplicate workflow configuration and streamlined the automated publishing process to the official MCP Registry
• Homebrew installation: Fixed one-line installation command in documentation and added safeguards to prevent tap job execution on pre-release tags

Improvements

• MCP Registry integration: Automated publication of server.json to the MCP Registry on each release using OIDC authentication, ensuring the registry stays up-to-date
• Installation documentation: Enhanced README with clearer Homebrew cask installation instructions and DNF5 package manager notes

---

Download Installers

Platform	Download	Notes
macOS (Apple Silicon)	Download DMG	Signed & Notarized - Recommended for M1/M2/M3/M4
macOS (Intel)	Download DMG	Signed & Notarized
Windows (64-bit)	Download Setup	Setup wizard
Windows (ARM64)	Download Setup	For ARM Windows devices
Linux Debian/Ubuntu (AMD64)	Download .deb	sudo apt install ./mcpproxy_*.deb
Linux Debian/Ubuntu (ARM64)	Download .deb	For ARM64 (Raspberry Pi etc.)
Linux Fedora/RHEL (AMD64)	Download .rpm	sudo dnf install ./mcpproxy-*.rpm
Linux Fedora/RHEL (ARM64)	Download .rpm	For ARM64
Linux (AMD64) — tarball	Download tar.gz	Binary only
Linux (ARM64) — tarball	Download tar.gz	Binary only

Homebrew (macOS/Linux):

brew install smart-mcp-proxy/mcpproxy/mcpproxy

Other download options (auto-update URLs, archives)

Auto-update URLs (always points to latest):

• Linux AMD64 | Linux ARM64
• Windows AMD64 | Windows ARM64
• macOS AMD64 | macOS ARM64

Binary archives (this version):

• macOS AMD64 | macOS ARM64
• Windows AMD64 | Windows ARM64

---

Installation Instructions

Windows

1. Download the installer for your architecture
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. Launch "MCPProxy" from Start Menu

macOS

1. Download the signed DMG for your Mac
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. Launch mcpproxy.app from Applications folder

Linux / Manual Installation

1. Download the appropriate archive
2. Extract: tar -xzf mcpproxy-*.tar.gz
3. Make executable: chmod +x mcpproxy
4. Run: ./mcpproxy serve

Platform Support & Usage

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (CLI)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

mcpproxy serve                           # Start server
mcpproxy serve --listen 127.0.0.1:8081  # Custom port
export MCPPROXY_API_KEY=your-secret-key  # Set API key

v0.33.1

This maintenance release focuses on improved stability and reliability for upstream MCP server connections.

Bug Fixes

• Upstream health monitoring: MCPProxy now requires multiple consecutive health-check timeouts before marking an upstream server as errored, reducing false positives from transient network issues
• Configuration reloading: Fixed restart functionality to properly re-read mcp_config.json before restarting upstream connections, ensuring configuration changes are applied correctly
• Error diagnostics: Improved classification of HTTP timeouts and string-wrapped 5xx errors for better error reporting and debugging
• Docker registry integration: Fixed MCP Catalog to use standard docker run installation commands instead of non-standard docker:// URLs for Docker-based MCP servers

---

All fixes apply to both Personal and Teams editions.

---

Download Installers

Platform	Download	Notes
macOS (Apple Silicon)	Download DMG	Signed & Notarized - Recommended for M1/M2/M3/M4
macOS (Intel)	Download DMG	Signed & Notarized
Windows (64-bit)	Download Setup	Setup wizard
Windows (ARM64)	Download Setup	For ARM Windows devices
Linux Debian/Ubuntu (AMD64)	Download .deb	sudo apt install ./mcpproxy_*.deb
Linux Debian/Ubuntu (ARM64)	Download .deb	For ARM64 (Raspberry Pi etc.)
Linux Fedora/RHEL (AMD64)	Download .rpm	sudo dnf install ./mcpproxy-*.rpm
Linux Fedora/RHEL (ARM64)	Download .rpm	For ARM64
Linux (AMD64) — tarball	Download tar.gz	Binary only
Linux (ARM64) — tarball	Download tar.gz	Binary only

Homebrew (macOS/Linux):

brew install smart-mcp-proxy/mcpproxy/mcpproxy

Other download options (auto-update URLs, archives)

Auto-update URLs (always points to latest):

• Linux AMD64 | Linux ARM64
• Windows AMD64 | Windows ARM64
• macOS AMD64 | macOS ARM64

Binary archives (this version):

• macOS AMD64 | macOS ARM64
• Windows AMD64 | Windows ARM64

---

Installation Instructions

Windows

1. Download the installer for your architecture
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. Launch "MCPProxy" from Start Menu

macOS

1. Download the signed DMG for your Mac
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. Launch mcpproxy.app from Applications folder

Linux / Manual Installation

1. Download the appropriate archive
2. Extract: tar -xzf mcpproxy-*.tar.gz
3. Make executable: chmod +x mcpproxy
4. Run: ./mcpproxy serve

Platform Support & Usage

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (CLI)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

mcpproxy serve                           # Start server
mcpproxy serve --listen 127.0.0.1:8081  # Custom port
export MCPPROXY_API_KEY=your-secret-key  # Set API key

v0.33.0

This release introduces a comprehensive Global Tools overview page and achieves feature parity between the UI and CLI.

New Features

• Global Tools Overview Page - New centralized page displaying all available tools across connected MCP servers, making it easier to discover and understand the complete toolset at your disposal
• CLI Parity - Command-line interface now supports all features available in the UI, enabling full automation and scripting capabilities for power users and CI/CD workflows

Note: These features are available in both Personal and Teams editions.

---

Download Installers

Platform	Download	Notes
macOS (Apple Silicon)	Download DMG	Signed & Notarized - Recommended for M1/M2/M3/M4
macOS (Intel)	Download DMG	Signed & Notarized
Windows (64-bit)	Download Setup	Setup wizard
Windows (ARM64)	Download Setup	For ARM Windows devices
Linux Debian/Ubuntu (AMD64)	Download .deb	sudo apt install ./mcpproxy_*.deb
Linux Debian/Ubuntu (ARM64)	Download .deb	For ARM64 (Raspberry Pi etc.)
Linux Fedora/RHEL (AMD64)	Download .rpm	sudo dnf install ./mcpproxy-*.rpm
Linux Fedora/RHEL (ARM64)	Download .rpm	For ARM64
Linux (AMD64) — tarball	Download tar.gz	Binary only
Linux (ARM64) — tarball	Download tar.gz	Binary only

Homebrew (macOS/Linux):

brew install smart-mcp-proxy/mcpproxy/mcpproxy

Other download options (auto-update URLs, archives)

Auto-update URLs (always points to latest):

• Linux AMD64 | Linux ARM64
• Windows AMD64 | Windows ARM64
• macOS AMD64 | macOS ARM64

Binary archives (this version):

• macOS AMD64 | macOS ARM64
• Windows AMD64 | Windows ARM64

---

Installation Instructions

Windows

1. Download the installer for your architecture
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. Launch "MCPProxy" from Start Menu

macOS

1. Download the signed DMG for your Mac
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. Launch mcpproxy.app from Applications folder

Linux / Manual Installation

1. Download the appropriate archive
2. Extract: tar -xzf mcpproxy-*.tar.gz
3. Make executable: chmod +x mcpproxy
4. Run: ./mcpproxy serve

Platform Support & Usage

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (CLI)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

mcpproxy serve                           # Start server
mcpproxy serve --listen 127.0.0.1:8081  # Custom port
export MCPPROXY_API_KEY=your-secret-key  # Set API key

v0.32.1

This patch release fixes critical issues with payload truncation and caching to ensure proper pagination support in read_cache operations.

Bug Fixes

• Fixed cache key collisions in truncated payloads - Resolved an issue where truncated payloads could share cache keys, causing data corruption. Each truncated payload now generates a unique cache key based on its specific content and truncation parameters.

• Fixed read_cache pagination for truncated content - Truncated payloads are now persisted and recursively cached, enabling proper pagination through large truncated responses. This ensures that clients can reliably retrieve all pages of truncated data using read_cache.

• Improved truncation observability - Added enhanced logging and monitoring for read_cache truncation operations, making it easier to diagnose issues with cached truncated payloads.

These fixes apply to both Personal and Teams editions.

---

Download Installers

Platform	Download	Notes
macOS (Apple Silicon)	Download DMG	Signed & Notarized - Recommended for M1/M2/M3/M4
macOS (Intel)	Download DMG	Signed & Notarized
Windows (64-bit)	Download Setup	Setup wizard
Windows (ARM64)	Download Setup	For ARM Windows devices
Linux Debian/Ubuntu (AMD64)	Download .deb	sudo apt install ./mcpproxy_*.deb
Linux Debian/Ubuntu (ARM64)	Download .deb	For ARM64 (Raspberry Pi etc.)
Linux Fedora/RHEL (AMD64)	Download .rpm	sudo dnf install ./mcpproxy-*.rpm
Linux Fedora/RHEL (ARM64)	Download .rpm	For ARM64
Linux (AMD64) — tarball	Download tar.gz	Binary only
Linux (ARM64) — tarball	Download tar.gz	Binary only

Homebrew (macOS/Linux):

brew install smart-mcp-proxy/mcpproxy/mcpproxy

Other download options (auto-update URLs, archives)

Auto-update URLs (always points to latest):

• Linux AMD64 | Linux ARM64
• Windows AMD64 | Windows ARM64
• macOS AMD64 | macOS ARM64

Binary archives (this version):

• macOS AMD64 | macOS ARM64
• Windows AMD64 | Windows ARM64

---

Installation Instructions

Windows

1. Download the installer for your architecture
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. Launch "MCPProxy" from Start Menu

macOS

1. Download the signed DMG for your Mac
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. Launch mcpproxy.app from Applications folder

Linux / Manual Installation

1. Download the appropriate archive
2. Extract: tar -xzf mcpproxy-*.tar.gz
3. Make executable: chmod +x mcpproxy
4. Run: ./mcpproxy serve

Platform Support & Usage

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (CLI)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

mcpproxy serve                           # Start server
mcpproxy serve --listen 127.0.0.1:8081  # Custom port
export MCPPROXY_API_KEY=your-secret-key  # Set API key

v0.32.0

This release adds support for MCP specification 0.4.9 with agent-discoverable disabled tools and introduces layered configuration for tool filtering, plus critical bug fixes for configuration and CI reliability.

New Features

• Agent-discoverable disabled tools (MCP spec 0.4.9): Tools can now be marked as disabled while remaining discoverable by AI agents. This allows agents to see all available capabilities even when specific tools are administratively restricted, improving context awareness and error handling.

• Layered tool filter configuration: Introduces a hierarchical configuration system where config_denied settings (administrator-defined restrictions) take precedence over user toggle preferences. This ensures security policies cannot be bypassed by user-level settings. (Teams edition primarily affected)

Bug Fixes

• Fixed tool status classification: Corrected an issue where server tool status determination was not properly using runtime configuration authority, which could lead to incorrect tool availability states.

• Fixed configuration snapshot cloning: Deep-copying of tool-filter slices now works correctly in Snapshot.Clone, preventing potential configuration corruption. Added regression tests to prevent recurrence.

• Eliminated chronic E2E test timeouts: Resolved Docker verification waste in Runtime.Close that was causing persistent end-to-end test timeouts in CI pipelines.

---

Download Installers

Platform	Download	Notes
macOS (Apple Silicon)	Download DMG	Signed & Notarized - Recommended for M1/M2/M3/M4
macOS (Intel)	Download DMG	Signed & Notarized
Windows (64-bit)	Download Setup	Setup wizard
Windows (ARM64)	Download Setup	For ARM Windows devices
Linux Debian/Ubuntu (AMD64)	Download .deb	sudo apt install ./mcpproxy_*.deb
Linux Debian/Ubuntu (ARM64)	Download .deb	For ARM64 (Raspberry Pi etc.)
Linux Fedora/RHEL (AMD64)	Download .rpm	sudo dnf install ./mcpproxy-*.rpm
Linux Fedora/RHEL (ARM64)	Download .rpm	For ARM64
Linux (AMD64) — tarball	Download tar.gz	Binary only
Linux (ARM64) — tarball	Download tar.gz	Binary only

Homebrew (macOS/Linux):

brew install smart-mcp-proxy/mcpproxy/mcpproxy

Other download options (auto-update URLs, archives)

Auto-update URLs (always points to latest):

• Linux AMD64 | Linux ARM64
• Windows AMD64 | Windows ARM64
• macOS AMD64 | macOS ARM64

Binary archives (this version):

• macOS AMD64 | macOS ARM64
• Windows AMD64 | Windows ARM64

---

Installation Instructions

Windows

1. Download the installer for your architecture
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. Launch "MCPProxy" from Start Menu

macOS

1. Download the signed DMG for your Mac
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. Launch mcpproxy.app from Applications folder

Linux / Manual Installation

1. Download the appropriate archive
2. Extract: tar -xzf mcpproxy-*.tar.gz
3. Make executable: chmod +x mcpproxy
4. Run: ./mcpproxy serve

Platform Support & Usage

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (CLI)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

mcpproxy serve                           # Start server
mcpproxy serve --listen 127.0.0.1:8081  # Custom port
export MCPPROXY_API_KEY=your-secret-key  # Set API key

v0.31.1

This maintenance release focuses on build system improvements and frontend asset handling.

Bug Fixes

• Type generation: Re-synchronized TypeScript type output and implemented CRLF-safe drift detection to ensure consistent type definitions across different operating systems and development environments
• Frontend embedding: Removed tracked build artifacts from version control (web/frontend/dist/*) and added a fallback stub for serving the frontend, preventing repository bloat and build conflicts

Note: These fixes primarily affect development workflows and both Personal and Teams editions benefit from improved build reliability.

---

Download Installers

Platform	Download	Notes
macOS (Apple Silicon)	Download DMG	Signed & Notarized - Recommended for M1/M2/M3/M4
macOS (Intel)	Download DMG	Signed & Notarized
Windows (64-bit)	Download Setup	Setup wizard
Windows (ARM64)	Download Setup	For ARM Windows devices
Linux Debian/Ubuntu (AMD64)	Download .deb	sudo apt install ./mcpproxy_*.deb
Linux Debian/Ubuntu (ARM64)	Download .deb	For ARM64 (Raspberry Pi etc.)
Linux Fedora/RHEL (AMD64)	Download .rpm	sudo dnf install ./mcpproxy-*.rpm
Linux Fedora/RHEL (ARM64)	Download .rpm	For ARM64
Linux (AMD64) — tarball	Download tar.gz	Binary only
Linux (ARM64) — tarball	Download tar.gz	Binary only

Homebrew (macOS/Linux):

brew install smart-mcp-proxy/mcpproxy/mcpproxy

Other download options (auto-update URLs, archives)

Auto-update URLs (always points to latest):

• Linux AMD64 | Linux ARM64
• Windows AMD64 | Windows ARM64
• macOS AMD64 | macOS ARM64

Binary archives (this version):

• macOS AMD64 | macOS ARM64
• Windows AMD64 | Windows ARM64

---

Installation Instructions

Windows

1. Download the installer for your architecture
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. Launch "MCPProxy" from Start Menu

macOS

1. Download the signed DMG for your Mac
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. Launch mcpproxy.app from Applications folder

Linux / Manual Installation

1. Download the appropriate archive
2. Extract: tar -xzf mcpproxy-*.tar.gz
3. Make executable: chmod +x mcpproxy
4. Run: ./mcpproxy serve

Platform Support & Usage

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (CLI)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

mcpproxy serve                           # Start server
mcpproxy serve --listen 127.0.0.1:8081  # Custom port
export MCPPROXY_API_KEY=your-secret-key  # Set API key

v0.31.0

This release improves MCP server configuration management and fixes critical transport error handling issues.

New Features

• Per-tool control (Teams edition): Enable or disable individual tools from any MCP server through the web UI, with bulk "Enable All" and "Disable All" actions for easier management of large tool sets (#463)
• Enhanced server configuration (Both editions): View and edit HTTP headers and environment variables directly in the server detail view, with options to reveal sensitive values and convert plain text to secrets (#466)

Bug Fixes

• Transport error classification: Fixed issue where network transport errors were incorrectly identified as authentication failures, improving error diagnosis and reducing confusion (#464)
• Diagnostics reporting: Corrected the bug-report URL displayed in Unknown failure catalog entries to ensure users can properly report issues (#465)

---

Download Installers

Platform	Download	Notes
macOS (Apple Silicon)	Download DMG	Signed & Notarized - Recommended for M1/M2/M3/M4
macOS (Intel)	Download DMG	Signed & Notarized
Windows (64-bit)	Download Setup	Setup wizard
Windows (ARM64)	Download Setup	For ARM Windows devices
Linux Debian/Ubuntu (AMD64)	Download .deb	sudo apt install ./mcpproxy_*.deb
Linux Debian/Ubuntu (ARM64)	Download .deb	For ARM64 (Raspberry Pi etc.)
Linux Fedora/RHEL (AMD64)	Download .rpm	sudo dnf install ./mcpproxy-*.rpm
Linux Fedora/RHEL (ARM64)	Download .rpm	For ARM64
Linux (AMD64) — tarball	Download tar.gz	Binary only
Linux (ARM64) — tarball	Download tar.gz	Binary only

Homebrew (macOS/Linux):

brew install smart-mcp-proxy/mcpproxy/mcpproxy

Other download options (auto-update URLs, archives)

Auto-update URLs (always points to latest):

• Linux AMD64 | Linux ARM64
• Windows AMD64 | Windows ARM64
• macOS AMD64 | macOS ARM64

Binary archives (this version):

• macOS AMD64 | macOS ARM64
• Windows AMD64 | Windows ARM64

---

Installation Instructions

Windows

1. Download the installer for your architecture
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. Launch "MCPProxy" from Start Menu

macOS

1. Download the signed DMG for your Mac
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. Launch mcpproxy.app from Applications folder

Linux / Manual Installation

1. Download the appropriate archive
2. Extract: tar -xzf mcpproxy-*.tar.gz
3. Make executable: chmod +x mcpproxy
4. Run: ./mcpproxy serve

Platform Support & Usage

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (CLI)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

mcpproxy serve                           # Start server
mcpproxy serve --listen 127.0.0.1:8081  # Custom port
export MCPPROXY_API_KEY=your-secret-key  # Set API key

v0.30.1

This maintenance release improves the setup experience and adds automatic update capabilities for Debian-based installations.

New Features

• Automatic Updates (Teams - Debian/Ubuntu): Debian package installations now ship with an unattended-upgrades whitelist configuration, enabling automatic security and patch updates without manual intervention.

• Docker Diagnostic Enhancement (Teams): The doctor command now detects when the host system needs the snap-docker override and surfaces a helpful hint to guide users through the configuration.

Bug Fixes

• Setup UI Indicator: Fixed the pulsing animation in the sidebar Setup section to properly respect the engaged flag, ensuring the visual indicator only appears when appropriate.

Improvements

• Installation Documentation: Added a new "Migrating from Manual Install" section to help users transition from manual installation methods to package-managed deployments.

---

Download Installers

Platform	Download	Notes
macOS (Apple Silicon)	Download DMG	Signed & Notarized - Recommended for M1/M2/M3/M4
macOS (Intel)	Download DMG	Signed & Notarized
Windows (64-bit)	Download Setup	Setup wizard
Windows (ARM64)	Download Setup	For ARM Windows devices
Linux Debian/Ubuntu (AMD64)	Download .deb	sudo apt install ./mcpproxy_*.deb
Linux Debian/Ubuntu (ARM64)	Download .deb	For ARM64 (Raspberry Pi etc.)
Linux Fedora/RHEL (AMD64)	Download .rpm	sudo dnf install ./mcpproxy-*.rpm
Linux Fedora/RHEL (ARM64)	Download .rpm	For ARM64
Linux (AMD64) — tarball	Download tar.gz	Binary only
Linux (ARM64) — tarball	Download tar.gz	Binary only

Homebrew (macOS/Linux):

brew install smart-mcp-proxy/mcpproxy/mcpproxy

Other download options (auto-update URLs, archives)

Auto-update URLs (always points to latest):

• Linux AMD64 | Linux ARM64
• Windows AMD64 | Windows ARM64
• macOS AMD64 | macOS ARM64

Binary archives (this version):

• macOS AMD64 | macOS ARM64
• Windows AMD64 | Windows ARM64

---

Installation Instructions

Windows

1. Download the installer for your architecture
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. Launch "MCPProxy" from Start Menu

macOS

1. Download the signed DMG for your Mac
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. Launch mcpproxy.app from Applications folder

Linux / Manual Installation

1. Download the appropriate archive
2. Extract: tar -xzf mcpproxy-*.tar.gz
3. Make executable: chmod +x mcpproxy
4. Run: ./mcpproxy serve

Platform Support & Usage

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (CLI)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

mcpproxy serve                           # Start server
mcpproxy serve --listen 127.0.0.1:8081  # Custom port
export MCPPROXY_API_KEY=your-secret-key  # Set API key

v0.30.0

This release adds support for HTTP/SSE MCP servers and includes telemetry improvements and configuration fixes.

New Features

• HTTP/SSE Server Support: MCPProxy can now connect to MCP servers that use HTTP with Server-Sent Events (SSE) transport, in addition to the existing stdio-based servers. Configure these upstreams using the local launcher (spec 046).

• Enhanced Diagnostics: Added v3 diagnostics counters for improved telemetry tracking and monitoring capabilities (spec 044).

Bug Fixes

• Launcher Timeout Persistence: The LauncherWaitTimeout configuration setting now correctly persists to the BBolt database. Previously, this setting may not have been saved properly across restarts.

• OAuth Token Expiration: Fixed handling of OAuth tokens where ExpiresAt is set to zero. These tokens are now correctly treated as never-expiring tokens instead of being considered expired.

---

Download Installers

Platform	Download	Notes
macOS (Apple Silicon)	Download DMG	Signed & Notarized - Recommended for M1/M2/M3/M4
macOS (Intel)	Download DMG	Signed & Notarized
Windows (64-bit)	Download Setup	Setup wizard
Windows (ARM64)	Download Setup	For ARM Windows devices
Linux Debian/Ubuntu (AMD64)	Download .deb	sudo apt install ./mcpproxy_*.deb
Linux Debian/Ubuntu (ARM64)	Download .deb	For ARM64 (Raspberry Pi etc.)
Linux Fedora/RHEL (AMD64)	Download .rpm	sudo dnf install ./mcpproxy-*.rpm
Linux Fedora/RHEL (ARM64)	Download .rpm	For ARM64
Linux (AMD64) — tarball	Download tar.gz	Binary only
Linux (ARM64) — tarball	Download tar.gz	Binary only

Homebrew (macOS/Linux):

brew install smart-mcp-proxy/mcpproxy/mcpproxy

Other download options (auto-update URLs, archives)

Auto-update URLs (always points to latest):

• Linux AMD64 | Linux ARM64
• Windows AMD64 | Windows ARM64
• macOS AMD64 | macOS ARM64

Binary archives (this version):

• macOS AMD64 | macOS ARM64
• Windows AMD64 | Windows ARM64

---

Installation Instructions

Windows

1. Download the installer for your architecture
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. Launch "MCPProxy" from Start Menu

macOS

1. Download the signed DMG for your Mac
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. Launch mcpproxy.app from Applications folder

Linux / Manual Installation

1. Download the appropriate archive
2. Extract: tar -xzf mcpproxy-*.tar.gz
3. Make executable: chmod +x mcpproxy
4. Run: ./mcpproxy serve

Platform Support & Usage

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (CLI)

Usage

GUI (Recommended):

• Launch mcpproxy.app from Applications (auto-starts core server)
• Manages server via system tray menu

CLI:

mcpproxy serve                           # Start server
mcpproxy serve --listen 127.0.0.1:8081  # Custom port
export MCPPROXY_API_KEY=your-secret-key  # Set API key