v0.19.1

This patch release fixes OAuth token handling to ensure compatibility with Supabase and other authentication providers that return HTTP 201 status codes.

Bug Fixes

• OAuth token responses: Fixed normalization of HTTP 201 responses during OAuth token exchange to properly handle Supabase authentication flows. Previously, only HTTP 200 responses were correctly processed, which could cause authentication failures with certain OAuth providers.

---

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 (AMD64)	Download tar.gz	Binary package
Linux (ARM64)	Download tar.gz	For ARM Linux

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.19.0

Release notes could not be generated automatically. See commit history for changes.

---

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 (AMD64)	Download tar.gz	Binary package
Linux (ARM64)	Download tar.gz	For ARM Linux

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.18.1

Release notes could not be generated automatically. See commit history for changes.

---

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 (AMD64)	Download tar.gz	Binary package
Linux (ARM64)	Download tar.gz	For ARM Linux

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.17.8

This release enhances security controls, improves OAuth capabilities, and refines configuration management for MCP server interactions.

New Features

• No-Quarantine Import Flag: Added --no-quarantine flag to upstream import command, allowing users to bypass security quarantine when importing trusted MCP servers
• OAuth Runlayer Mode: Introduced Runlayer mode to the Go OAuth test server for enhanced testing capabilities
• Tray Menu Unquarantine: Added unquarantine action to system tray menu for quick security status management

Bug Fixes

• Quarantine API Documentation: Corrected quarantine API documentation to accurately reflect the security features
• Tray Menu Wiring: Fixed system tray unquarantine menu integration to properly handle security operations

Improvements

• Configuration Cleanup: Deprecated unused configuration parameters and implemented activity retention settings for better system maintenance
• Release Pipeline Reliability: Increased SignPath timeout to 1 hour and added automatic retry workflow for failed release builds

---

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 (AMD64)	Download tar.gz	Binary package
Linux (ARM64)	Download tar.gz	For ARM Linux

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.17.7

This release fixes an OAuth authentication issue that could cause connection problems with MCP servers.

Bug Fixes

• Fixed OAuth reconnection loop that occurred when using DCR-only placeholder tokens, preventing infinite retry attempts and improving connection stability (#305)

---

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 (AMD64)	Download tar.gz	Binary package
Linux (ARM64)	Download tar.gz	For ARM Linux

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.17.6

This release fixes a critical bug in the tool retrieval system that affected how MCP servers communicate their capabilities.

Bug Fixes

• Fixed retrieve_tools incorrectly defaulting annotations/call_with to call_tool_read instead of respecting the actual tool configuration. This ensures MCP servers can properly declare whether their tools should use read-only or read-write permissions (#306)

---

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 (AMD64)	Download tar.gz	Binary package
Linux (ARM64)	Download tar.gz	For ARM Linux

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.17.5

This release focuses on fixing critical Windows PATH handling issues and adds documentation for Google Antigravity client setup.

Bug Fixes

• Fixed Windows registry PATH reading and variable expansion - Resolved Issue #302 where MCPProxy incorrectly handled Windows environment variables and registry PATH entries. The proxy now properly uses registry.ExpandString instead of os.ExpandEnv to correctly expand Windows-style %VAR% variables, and correctly handles spaces in PATH entries
• Improved Windows PATH enhancement - MCPProxy now always enhances minimal PATH environments on Windows by discovering and merging paths from the Windows registry, ensuring MCP servers can locate required executables even when launched with a restricted PATH

Documentation

• Added setup guide for configuring Google Antigravity as an MCP client

---

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 (AMD64)	Download tar.gz	Binary package
Linux (ARM64)	Download tar.gz	For ARM Linux

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.17.4

This release resolves critical OAuth authentication issues that could cause connection failures, UI freezes, and stale status displays.

Bug Fixes

• Fixed deadlock during OAuth credential persistence - Resolved a deadlock in persistDCRCredentials that could hang the Connect operation
• Prevented Connect() from blocking critical operations - Connect no longer blocks Disconnect or HTTP server startup, improving application responsiveness
• Fixed stale "Connecting..." status - Corrected lock ordering in the reconcile process to ensure status updates properly reflect connection state
• Resolved stale state view and improved error handling - Fixed OAuth state view inconsistencies and now properly handle server 5xx responses as token errors
• Preserved DCR credentials during token saves - OAuth DCR credentials are now maintained when mcp-go saves access tokens, preventing authentication failures
• Protected valid legacy tokens from cleanup - Orphan cleanup process no longer incorrectly deletes legitimate legacy tokens

---

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 (AMD64)	Download tar.gz	Binary package
Linux (ARM64)	Download tar.gz	For ARM Linux

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.17.3

This release focuses on hardening OAuth authentication reliability and improving Windows installer security.

Bug Fixes

• OAuth Token Refresh: Implemented direct token refresh mechanism that bypasses early returns in ForceReconnect, ensuring more reliable token renewal
• OAuth Security: Added timeout protection and endpoint validation to token refresh operations to prevent hanging requests and validate server responses
• OAuth Stability: Added safeguards against nil storage access and gracefully handle missing expires_in fields in token responses
• OAuth Persistence: Fixed DCR (Dynamic Client Registration) credential persistence to enable proactive token refresh before expiration
• OAuth Authentication: Improved standalone authentication login by forcing appropriate mode and expanding error detection for better failure handling

Improvements

• Windows Installer: Upgraded to production SignPath certificate for enhanced trust and security when installing on Windows systems

---

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 (AMD64)	Download tar.gz	Binary package
Linux (ARM64)	Download tar.gz	For ARM Linux

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.17.2

This release focuses on bug fixes and internal code improvements to enhance maintainability and reliability.

Bug Fixes

• Server Discovery Events: Fixed timing issue where servers.changed events were emitted before tool discovery completed, ensuring clients receive accurate server state with all discovered tools (#292)

Improvements

• Code Organization: Refactored connection handling code into smaller, focused files for improved maintainability and easier navigation (#291)

---

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 (AMD64)	Download tar.gz	Binary package
Linux (ARM64)	Download tar.gz	For ARM Linux

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