This release enhances configuration management for upstream MCP servers and improves protocol compliance with better handling of deprecated endpoints.

New Features

• Smart Config Patching (Spec 023): Implemented intelligent configuration patching for upstream servers, allowing granular updates to server settings without replacing entire configurations. This makes it easier to modify specific parameters while preserving existing configuration values.

• RFC 7396 JSON Merge Patch: Added support for RFC 7396 null-means-remove semantics when patching environment variables and headers. Setting a value to null now properly removes that key from the configuration, providing more intuitive configuration management.

• 410 Gone Error Handling: Added proper handling for HTTP 410 Gone responses from deprecated MCP endpoints. The proxy now gracefully detects and reports when upstream servers have permanently removed endpoints, helping users identify outdated integrations.

These updates improve MCPProxy's ability to manage dynamic server configurations and handle evolving MCP server APIs more robustly.

Download Installers

Homebrew (macOS/Linux):

brew install smart-mcp-proxy/mcpproxy/mcpproxy

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

This release focuses on OAuth authentication improvements, enhanced observability, and several UI fixes to improve the user experience.

New Features

• Structured Error Feedback for OAuth: OAuth login failures now provide clear, actionable error messages to help users troubleshoot authentication issues more effectively (Spec 020)
• Persistent OAuth Callback Port: The OAuth callback port is now persisted across sessions, ensuring consistent redirect URIs and more reliable authentication flows
• Request ID Tracking: Added end-to-end request tracing with unique request IDs, making it easier to debug issues and track requests through the entire system (#21)
• Unified Server Health State: Implemented structured server state management with health status as the single source of truth, improving reliability and consistency of server monitoring

Bug Fixes

• OAuth Browser Window: Fixed issue where the 'auth login' command wasn't properly opening the browser window for OAuth authentication
• Clickable Server Names: Server names in attention banners are now properly clickable, improving navigation and usability
• Contract File Stability: Removed timestamps from generated contracts.ts to prevent unnecessary file changes and reduce repository churn

Download Installers

Homebrew (macOS/Linux):

brew install smart-mcp-proxy/mcpproxy/mcpproxy

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

This release introduces comprehensive activity logging and observability capabilities, along with a new Intent Declaration system for improved tool organization and LLM interaction.

New Features

• Activity Log System: Complete activity logging infrastructure tracking all tool calls, server operations, and user actions with real-time monitoring
• Activity CLI Commands: New commands to view, filter, and analyze activity history:
  • activity list - View all logged activities with filtering by type, server, and date
  • activity show - Display detailed information about specific activities
  • activity watch - Real-time activity monitoring
  • --no-icons flag to disable emoji icons in output
• Activity Log Web UI: Real-time activity dashboard in the web interface (temporarily disabled pending further testing)
• Intent Declaration System: Tools can now declare their intended use cases, enabling intelligent tool grouping and improved LLM context management with tool split functionality
• Server Management CLI: New commands for managing MCP servers:
  • list-servers - View all configured servers
  • search-servers - Search available tools across servers
  • Enhanced table and JSON output formatting
• Tool Annotations: Added metadata annotations to tools for better LLM understanding and discovery

Bug Fixes

• Fixed OAuth flow to properly detect empty client_id when Dynamic Client Registration fails with 403 errors
• Corrected field names in activity watch display output
• Invalid intent attempts are now properly logged to activity log
• CLI tool calls now correctly logged with source indicator
• Search-servers command now outputs table format by default instead of JSON
• Quarantined servers are now properly excluded from tool discovery and search results
• Multiple activity CLI bugs resolved based on QA testing

Documentation

• Added comprehensive documentation for Intent Declaration system (Spec 018)
• Documented Activity CLI commands with examples and filtering options (Spec 017)
• Added RFC-003 for Activity Log & Observability architecture

Download Installers

Homebrew (macOS/Linux):

brew install smart-mcp-proxy/mcpproxy/mcpproxy

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

MCPProxy v0.11.5 Release Notes

This release focuses on improving stability during server shutdowns and refining the user interface terminology.

Bug Fixes

• Improved server shutdown reliability: Increased subprocess shutdown timeout from 2 seconds to 10 seconds to prevent premature termination of MCP servers during cleanup operations

Improvements

• Clearer UI terminology: Renamed "Tool Call History" to "Activity" throughout the interface for better clarity and consistency

mcpproxy v0.11.5

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

Latest Version (auto-updates):

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

Windows Installer:

• Setup (AMD64)
• Setup (ARM64)

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

This Version (v0.11.5):

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

Installation

Windows:

1. Download the installer for your architecture (AMD64 or ARM64)
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. MCPProxy will be added to Start Menu and system PATH
5. Launch "MCPProxy" from Start Menu to start the tray app
6. The app will appear in your system tray

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

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

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

MCPProxy v0.11.4 Release Notes

This maintenance release improves the diagnostic capabilities of the doctor command with enhanced update checking functionality.

Bug Fixes

• Added refresh option to the doctor command's update check, ensuring users can verify the latest version status without relying on cached data (#213)

mcpproxy v0.11.4

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

Latest Version (auto-updates):

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

Windows Installer:

• Setup (AMD64)
• Setup (ARM64)

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

This Version (v0.11.4):

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

Installation

Windows:

1. Download the installer for your architecture (AMD64 or ARM64)
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. MCPProxy will be added to Start Menu and system PATH
5. Launch "MCPProxy" from Start Menu to start the tray app
6. The app will appear in your system tray

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

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

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

MCPProxy v0.11.3 Release Notes

This release adds automatic tool re-indexing support, allowing MCPProxy to dynamically update its tool catalog when MCP servers add or remove tools without requiring a manual refresh.

New Features

• Automatic Tool Re-indexing: MCPProxy now subscribes to the notifications/tools/list_changed notification from MCP servers. When a server adds, removes, or modifies its available tools, MCPProxy automatically re-indexes them in real-time, ensuring the tool catalog stays synchronized with connected servers without manual intervention.

mcpproxy v0.11.3

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

Latest Version (auto-updates):

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

Windows Installer:

• Setup (AMD64)
• Setup (ARM64)

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

This Version (v0.11.3):

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

Installation

Windows:

1. Download the installer for your architecture (AMD64 or ARM64)
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. MCPProxy will be added to Start Menu and system PATH
5. Launch "MCPProxy" from Start Menu to start the tray app
6. The app will appear in your system tray

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

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

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

MCPProxy v0.11.2 Release Notes

This is a maintenance release that fixes the version display issue in the application.

Bug Fixes

• Fixed incorrect version display in the application by properly setting the build version through ldflags compilation flags

For full details, see the complete changelog.

mcpproxy v0.11.2

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

Latest Version (auto-updates):

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

Windows Installer:

• Setup (AMD64)
• Setup (ARM64)

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

This Version (v0.11.2):

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

Installation

Windows:

1. Download the installer for your architecture (AMD64 or ARM64)
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. MCPProxy will be added to Start Menu and system PATH
5. Launch "MCPProxy" from Start Menu to start the tray app
6. The app will appear in your system tray

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

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

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

MCPProxy v0.11.1

This release introduces intelligent tool cache management with differential updates, improving tool discovery efficiency and giving users more control over MCP server tool synchronization.

New Features

• Tool Cache Invalidation with Differential Updates - Added smart cache invalidation system that only updates tools that have changed, reducing unnecessary overhead and improving performance when MCP servers modify their tool sets
• Manual Discovery Trigger - Users can now manually trigger tool discovery for MCP servers on-demand, providing more control over when tools are synchronized and cached

mcpproxy v0.11.1

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

Latest Version (auto-updates):

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

Windows Installer:

• Setup (AMD64)
• Setup (ARM64)

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

This Version (v0.11.1):

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

Installation

Windows:

1. Download the installer for your architecture (AMD64 or ARM64)
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. MCPProxy will be added to Start Menu and system PATH
5. Launch "MCPProxy" from Start Menu to start the tray app
6. The app will appear in your system tray

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

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

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

MCPProxy v0.11.0 Release Notes

This release introduces a unified health monitoring system and centralized version management to improve observability and user experience across the application.

New Features

• Unified Health Status System - Implemented a centralized health monitoring system that provides consistent health status reporting across CLI and REST API endpoints, making it easier to monitor the proxy and connected MCP servers
• Version Display and Update Notifications - Added centralized version information display throughout the application with automatic update notifications to keep users informed of new releases

Bug Fixes

• Fixed incorrect documentation edit URL paths in Docusaurus configuration

mcpproxy v0.11.0

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

Latest Version (auto-updates):

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

Windows Installer:

• Setup (AMD64)
• Setup (ARM64)

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

This Version (v0.11.0):

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

Installation

Windows:

1. Download the installer for your architecture (AMD64 or ARM64)
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. MCPProxy will be added to Start Menu and system PATH
5. Launch "MCPProxy" from Start Menu to start the tray app
6. The app will appear in your system tray

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

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

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)

MCPProxy v0.10.13

This release adds MCP prompts support for workflow automation and fixes compatibility issues with Git Bash on Windows.

New Features

• MCP Prompts Support: MCPProxy now enables the MCP prompts capability, allowing you to use workflow prompts for enhanced automation and task orchestration

Bug Fixes

• Git Bash Compatibility: Fixed path separator issues that prevented MCPProxy from working correctly in Git Bash environments on Windows
• Documentation Site Assets: Added missing favicon and apple-touch-icon for the new documentation site at docs.mcpproxy.app

Improvements

• New Documentation Site: Launched a comprehensive Docusaurus-based documentation site at docs.mcpproxy.app for easier navigation and better user experience
• Documentation Cleanup: Streamlined CLAUDE.md by moving detailed sections to dedicated documentation pages, making the main README more accessible

mcpproxy v0.10.13

Smart MCP Proxy - Intelligent tool discovery and proxying for Model Context Protocol servers.

Download Links

Latest Version (auto-updates):

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

Windows Installer:

• Setup (AMD64)
• Setup (ARM64)

macOS Installer:

• Signed DMG (Apple Silicon)
• Signed DMG (Intel)

This Version (v0.10.13):

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

Installation

Windows:

1. Download the installer for your architecture (AMD64 or ARM64)
2. Run mcpproxy-setup-*.exe
3. Follow the installation wizard (requires Administrator privileges)
4. MCPProxy will be added to Start Menu and system PATH
5. Launch "MCPProxy" from Start Menu to start the tray app
6. The app will appear in your system tray

macOS:

1. Download the signed installer DMG for your Mac (Apple Silicon or Intel)
2. Double-click the DMG to mount it
3. Double-click the PKG installer inside
4. Follow the installation wizard
5. CLI tool mcpproxy will be available in Terminal
6. Launch mcpproxy.app from Applications folder
7. The app will appear in your system tray

Manual Installation (All Platforms):

1. Download the appropriate archive for your platform using the links above
2. Extract the archive: tar -xzf mcpproxy-*.tar.gz (Linux/macOS) or unzip (Windows)
3. Make it executable: chmod +x mcpproxy (Linux/macOS)
4. Run ./mcpproxy to start

Platform Support

• macOS: Full system tray support with menu and icons
• Windows: Full system tray support with menu and icons
• Linux: Headless mode only (no system tray due to compatibility)

Usage

GUI (Recommended):

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

CLI:

• Start core server: mcpproxy serve
• Custom port: mcpproxy serve --listen 127.0.0.1:8081
• Set API key: export MCPPROXY_API_KEY=your-secret-key
• Start tray separately: mcpproxy-tray (if core already running)