Windsurf

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

Install Steps

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.
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!

Antigravity Kiro

Getting Started

Workflows

Plans for Your Role

Integrations

Collaboration

Install MCP Server

Comparison

Usage

Support

Changelog

Install Steps

Verify

Get help

​Install Steps

​Verify

​Get help

Install Steps

Verify

Get help