This release introduces Skills management for MCP servers and enhances work session tracking with failure timelines.
New Features
-
Skills Management (Spec 125): Complete implementation of Skills over MCP, allowing administrators to discover, catalog, approve, and block skills from upstream servers. Approved skills are offered to agents through three built-in tools, providing fine-grained control over agent capabilities.
-
Work Sessions & Failure Timeline (Spec 124): Enhanced activity tracking now includes work session monitoring and a detailed failure timeline, helping teams understand agent behavior and troubleshoot issues more effectively.
-
Single-Server Endpoints: New
/mcp/s/<server>endpoints enable direct access to individual MCP servers for simplified integrations and debugging. -
Non-Expiring Agent Tokens: Support for agent tokens that never expire, useful for long-running automated workflows.
-
OAuth Token Encryption (Spec 123): Opt-in encryption of upstream OAuth tokens at rest, with new
auth tokenscommands and doctor section for token management. -
GitHub Copilot Integration: Added support for GitHub Copilot user configuration as a client, following
COPILOT_HOMEenvironment variable.
Bug Fixes
-
Security Fixes: Resolved agent-token replay bypass, code execution stack overflow, and three low-severity security gaps. Additional fixes prevent false positives in third-party authorization descriptions.
-
Upstream Reconnection: Remote MCP servers now reconnect immediately when network connectivity returns, reducing downtime.
-
Secret Handling: Unresolved secret references are no longer sent to HTTP upstreams. macOS Keychain write operations now properly explain opt-in requirements before requesting values.
-
OAuth Improvements: Static-header OAuth servers can now properly initiate sign-in flows when offered. Token response parsing now tolerates non-standard
expires_atformats. -
Code Execution: Bounded regex CPU and heap growth to prevent resource exhaustion attacks.
-
Token Savings: Performance optimization now reads StateView instead of polling live tools/list.
-
Health Checks: Upstream health checks now tolerate loaded hosts more gracefully.
-
Windows Installer: Fixed Inno Setup version to prevent RedirectionGuard leaking into system tray. (Personal Edition)
-
HTTP Streaming: GET streams properly maintained for streamable-HTTP upstreams advertising
tools.listChanged.
Known limitations
- After logout, the health view can briefly suggest restarting the server. Agents can also see the same “not connected” message for several different causes.
- When an upstream server is offline, a client using a read-only token can receive a permission error that describes the operation as destructive.
- The session timeline groups repeated upstream events within a minute under the first occurrence. A session that starts between the first and last occurrence can omit that event.
- After logout, a connection attempt can reopen the interactive OAuth sign-in page. Completing sign-in is required before tools can be used again.
Contributors
Thank you to our external contributors for this release: @dajiaohuang, @paoValle
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/mcpproxyOther download options (auto-update URLs, archives)
Auto-update URLs (always points to latest):
Binary archives (this version):
Installation Instructions
Windows
- Download the installer for your architecture
- Run
mcpproxy-setup-*.exe - Follow the installation wizard (requires Administrator privileges)
- Launch "MCPProxy" from Start Menu
macOS
- Download the signed DMG for your Mac
- Double-click the DMG to mount it
- Double-click the PKG installer inside
- Follow the installation wizard
- Launch mcpproxy.app from Applications folder
Linux / Manual Installation
- Download the appropriate archive
- Extract:
tar -xzf mcpproxy-*.tar.gz - Make executable:
chmod +x mcpproxy - 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