> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ref.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# Windsurf

> Connect Windsurf to up-to-date and token-efficient documentation.

[Windsurf Cascade MCP docs](https://docs.windsurf.com/windsurf/cascade/mcp)

You can find your API key at [ref.tools/keys](https://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": {
    "Ref": {
      "command": "npx",
      "args": ["ref-tools-mcp@latest"],
      "env": {
        "REF_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}
```

## Verify

Click the Cascade Chat Customizations button and see that Ref is active with 2 tools.

<img src="https://mintcdn.com/ref/JCiPXQpBBR5CnJ1u/context/install/images/windsurf-success.png?fit=max&auto=format&n=JCiPXQpBBR5CnJ1u&q=85&s=5abdc951fc9aff09ac2dfc6cf9ded253" width="566" height="400" data-path="context/install/images/windsurf-success.png" />

If it is not, you can click on `Ref` and click the `Refresh` button on the Manage MCPs page to refresh MCPs.

## Get help

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