The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Install
go install github.com/smart-mcp-proxy/mcpproxy-go/cmd/mcpproxy@latestInstall command taken from the project's README or registry entry. Always review code before running it.
README excerpt
Read full README on GitHub →📺 Watch the full walkthrough · 📚 Read the docs · 🌐 mcpproxy.app
The demo above shows the embedded web UI. The MCPProxy core is a single binary for macOS, Linux, and Windows — the web UI ships inside it, with no extra service to run. On macOS, an optional menu‑bar app adds one‑click convenience (start/stop, server health, quarantine, logs).
macOS menu‑bar app · Activity log & audit in the macOS app
Why MCPProxy?
- Scale beyond API limits – Federate hundreds of MCP servers while bypassing Cursor's 40-tool limit and OpenAI's 128-function cap.
- Spend less context on tool definitions – Agents see a small set of MCPProxy discovery and execution tools (
retrieve_tools,describe_tool, thecall_tool_*variants and a few management tools) instead of the full upstream tool catalog, and fetch schemas on demand (inretrieve_toolsandcode_executionrouting;directrouting exposes upstream tools individually, see Routing modes). How much context this saves depends on the number of tools, the routing mode, the client and the task; see Token savings: what is and is not measured. - Review before use – New servers are quarantined and their tools are withheld from agents until you review and approve them, and, under the default
manualtrust mode, most later changes to an approved tool's definition are held for review again. Known exceptions: input-schema-only edits outsidescanmode, a newly added output schema, and a description added to a tool that was approved with an empty description are admitted without a hold;scanmode admits clean changes and misses what its detectors miss;automode does not hold changes. This reduces exposure to malicious tool definitions (Tool Poisoning Attacks); it is not a guarantee of safety. See What quarantine does and does not cover. - Pluggable security scanners – Run Snyk, Semgrep, Trivy, Cisco, and other Docker-based scanners against quarantined servers before you approve them; findings are normalized to SARIF with a composite risk score. See Security scanner plugins.
- Works offline & cross-platform – A single core binary for macOS (Intel & Apple Silicon), Windows (x64 & ARM64), and Linux (x64 & ARM64), with the web UI embedded. macOS additionally ships an optional menu-bar app.
Token savings: what is and is not measured
On-demand discovery reduces how many upstream tool definitions an agent loads into context up front. The saving is not a fixed percentage: it grows with the number of connected tools and depends on the routing mode, the client and the task. MCPProxy does not publish a headline token-reduction or accuracy-improvement figure, and it makes no latency claim.
What the repository does measure, as a first-party, deterministic estimate (see bench/README.md for the method and to reproduce it with go run ./bench/cmd/bench):
Similar plugs
Reverse engineer anything with agents, from app behavior down to native binaries.
Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…
User-friendly AI Interface (Supports Ollama, OpenAI API, ...)
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io
Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.