Windsurf

Give Windsurf's Cascade the Hanzo toolset and the hosted Hanzo MCP endpoint.

Hanzo MCP

Two ways to give Windsurf Hanzo's tools. API key is the hosted endpoint, https://api.hanzo.ai/v1/mcp, with a key from hanzo.app sent as Authorization: Bearer sk-.... Local is hanzo-mcp on your machine, started with npx -y hanzo mcp (needs Node.js). With no key set it uses the sign-in hanzo login stored, so there is no key to paste (MCP). Replace sk-... with your key.

In Cascade, open the MCP menu and choose Open MCP config file (~/.config/devin/mcp_config.json), then add this.

{
  "mcpServers": {
    "hanzo-cloud": {
      "serverUrl": "https://api.hanzo.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer sk-..."
      }
    }
  }
}

In Cascade, open the MCP menu and choose Open MCP config file, then add this.

{
  "mcpServers": {
    "hanzo": {
      "command": "npx",
      "args": ["-y", "hanzo", "mcp"]
    }
  }
}

Cascade's Open MCP config file action opens ~/.config/devin/mcp_config.json on macOS and Linux and %AppData%\devin\mcp_config.json on Windows. A mcp_config.json can also sit in a project at .devin/mcp_config.json.

Was this page useful?
Broken link or missing step? Drop it in #docs on Discord or open a PR.
Last updated Nov 9, 2026