mcpx

Collapse multiple MCP servers into 2 tools: search and execute.

Without mcpx:  agent ← 120 tool schemas (~84,000 tokens)
With mcpx:     agent ← 2 tools (~1,000 tokens)

Quick start

bunx mcpx-tools init                                        # create mcpx.json
claude mcp add mcpx -- bunx mcpx-tools stdio mcpx.json      # connect agent

Docs

• Configuration — mcpx.json format, env vars, backends
• Agent setup — Claude Code, Cursor, Codex, Amp, OpenCode
• Team deployment — Docker, Helm, standalone HTTP
• Security — V8 sandbox, permissions, credential isolation
• Examples — Grafana, GitHub, multi-backend configs

How it works

Your agent calls search to find tools, then execute to run JavaScript that calls them. Code runs in a sandboxed V8 isolate — no filesystem, no network, no env access. Tool calls are the only way out.

License

Apache-2.0