Skip to main content
Windsurf Cascade MCP docs You can find your API key at ref.tools/keys

​
Install Steps

  1. Open the mcp_config.json file. This can be found at a path like ~/.codium/windsurf/mcp_config.json or by opening Cascade Chat and clicking the Customizations icon (looks like a packing box) in the top right then clicking the settings button.
  2. Update mcp_config.json as follows: 
{
  "mcpServers": {
    "RefPlan": {
      "command": "npx",
      "args": ["ref-tools-mcp@latest", "--plan-server"],
      "env": {
        "REF_API_KEY": "<YOUR_API_KEY>",
        "REF_PLAN_SERVER": "https://api.plan.ref.tools/mcp"
      }
    }
  }
}
Alternatively, if Windsurf supports HTTP MCP servers, use: 
{
  "mcpServers": {
    "RefPlan": {
      "type": "http",
      "url": "https://api.plan.ref.tools/mcp",
      "headers": {
        "x-ref-api-key": "<YOUR_API_KEY>"
      }
    }
  }
}
For plan-specific mode, append ?plan=<PLAN_ID> to the URL.

​
Verify

Click the Cascade Chat Customizations button and see that RefPlan is active.

​
Get help

If you have any issues, please reach out to help@ref.tools. We’re happy to help you get started!