The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Forgemax
Code Mode inspired local sandboxed MCP Gateway - collapses N servers x M tools into 2 tools (~1,000 tokens)
Install
npm install -g forgemaxInstall command taken from the project's README or registry entry. Always review code before running it.
README excerpt
Read full README on GitHub →Forgemax
Code Mode MCP Gateway — collapses N servers x M tools into 2 tools (~1,000 tokens).
Instead of dumping every tool schema into the LLM's context window, Forgemax exposes exactly two MCP tools:
search— query a capability manifest to discover tools (read-only, sandboxed)execute— run JavaScript against the tool API in a sandboxed V8 isolate
Additional sandbox APIs (the MCP surface stays at exactly 2 tools):
forge.readResource(server, uri)— read MCP resources from downstream serversforge.stash— session-scoped key-value store for sharing data across executionsforge.parallel(calls, opts)— bounded concurrent execution of tool/resource calls
The LLM writes JavaScript that calls through typed proxy objects. Credentials, file paths, and internal state never leave the host — the sandbox only sees opaque bindings. TypeScript definitions (forge.d.ts) are compiled into the binary and served in MCP server instructions, giving LLMs full type awareness.
Forgemax's Code Mode approach draws inspiration from Cloudflare's sandbox tool-calling pattern — their implementation of sandboxed code execution for MCP tool orchestration is excellent and well worth studying. We encourage supporting their work.
Why
| Traditional MCP | Forgemax Code Mode |
|---|---|
| 76 tools = ~15,000 tokens of schema | 2 tools = ~1,000 tokens |
| 5-10 sequential round-trips | 1 execute() call with chaining |
| Every new tool widens the context | Tool count is invisible to the LLM |
LLMs are trained on billions of lines of code. They're better at writing narsil.symbols.find({pattern: "handle_*"}) than picking the right tool from a 76-item JSON schema list.
Performance
| Scenario | Raw MCP (tokens) | Forgemax (tokens) | Savings |
|---|---|---|---|
| 10 tools | ~4,200 | ~1,100 | 73% |
| 50 tools | ~20,700 | ~1,100 | 94% |
| 76 tools | ~33,100 | ~1,100 | 96% |
| 150 tools | ~61,800 | ~1,100 | 98% |
Forgemax schema size is constant (~1,100 tokens) regardless of how many tools are connected.
Run the benchmark yourself: cargo run -p forge-manifest --example token_savings
Architecture
forgemax Binary entry point (stdio MCP transport)
forge-config TOML config loading, env var expansion, file watching
forge-client MCP client connections (stdio + HTTP/SSE), routing
forge-server MCP server handler (search + execute via rmcp)
forge-sandbox V8 sandbox (deno_core, AST validator, worker pool)
forgemax-worker Isolated child process for V8 execution
forge-manifest Capability manifest, LiveManifest, TypeScript defs
forge-error Typed DispatchError enum, structured errors, fuzzy matching
forge-audit Audit event types and structured logging
forge-test-server Mock MCP server for integration tests
forge-sandbox
The core innovation. Uses deno_core to run LLM-generated JavaScript in a locked-down V8 isolate:
Similar plugs
Reverse engineer anything with agents, from app behavior down to native binaries.
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
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, ...)