Use MCP servers in Codewhale with Toolport
Toolport is a free, open source local MCP gateway. Add your servers to Toolport once, flip the Codewhale toggle, and Codewhale gets all of them through a single gateway entry. Toolport picks a full tool list or search for each client, and you can change it in Clients.
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 Codewhale on. Toolport writes its gateway entry into Codewhale's config, next to anything already there.
- Restart or reload Codewhale. Your full server set is available through Toolport, and any server you add later shows up without touching Codewhale again.
Where Codewhale keeps its MCP config
Codewhale MCP config
All platforms ~/.codewhale/mcp.json (or CODEWHALE_MCP_CONFIG, mcp_config_path)
JSON, under whichever of servers or mcpServers the file already uses.
Good to know
- Codewhale defers MCP tools behind its own tool_search, so Toolport gives it the full tool list.
- Run /mcp reload in a running session, or start a new one, to pick up changes.
Why a gateway instead of Codewhale's own server list?
- One setup, every agent. The same servers work in Codewhale and every other AI agent on your machine; add a server once and they all get it.
- Secrets in the OS keychain. API keys are injected at runtime and never sit in Codewhale'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.
Free on this machine. Pro puts it on every machine. Team gives it to everyone.