Use MCP servers in Crush with Toolport
Toolport is a free, open source local MCP gateway. Add your servers to Toolport once, flip the Crush toggle, and Crush gets all of them through a single gateway entry, with lazy discovery loading a handful of meta-tools instead of every server's full tool list.
Setup
- Download Toolport for Windows, macOS or Linux, and add your MCP servers to it (or import the ones your other AI agents already have; secrets go to your OS keychain).
- Open the Clients tab and toggle Crush on. Toolport writes its gateway entry into Crush's config, next to anything already there.
- Restart or reload Crush. Your full server set is available through Toolport, and any server you add later shows up without touching Crush again.
Where Crush keeps its MCP config
- All platforms
$XDG_CONFIG_HOME/crush/crush.json (~/.config/crush/crush.json by default)
JSON with a top-level mcp object (Crush's own key, not mcpServers).
Good to know
- Set CRUSH_GLOBAL_CONFIG and Toolport writes there instead. On Windows it also picks up an older %LOCALAPPDATA%\crush\crush.json if that is the file you already have.
Why a gateway instead of Crush's own server list?
- One setup, every agent. The same servers work in Crush and every other AI agent on your machine; add a server once and they all get it.
- Up to 91% fewer tool tokens. Instead of every server dumping its tool list into context, the agent loads a handful of meta-tools and searches on demand (measured).
- Secrets in the OS keychain. API keys are injected at runtime and never sit in Crush's config file.
- Watched by default. Rug-pull and tool-poisoning detection on every tool, plus per-tool governance and a destructive-tool kill switch. How the security works.