Windsurf connects to the Equibles MCP server from Cascade, configured in `mcp_config.json`.

## 1. Install Windsurf

Download [Windsurf](https://windsurf.com) and open the Cascade panel.

## 2. Add the Equibles server

Create an API key at [/dashboard/apikeys](/dashboard/apikeys) (it starts with `eq_` and is shown once), then add Equibles to `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "equibles": {
      "serverUrl": "https://mcp.equibles.com/mcp",
      "headers": { "Authorization": "Bearer eq_your_api_key" }
    }
  }
}
```

> Windsurf is the odd one out — remote servers use the `serverUrl` key, not `url`. Open the file via Cascade's **Plugins → View raw config** if you'd rather not edit it by hand.

## 3. Test it

In the Cascade panel, ask any of these — it should call an Equibles tool:

<div class="doc-prompts">
  <div class="doc-prompt"><span class="q">›</span> Show me Apple's last five daily closes. <span class="tag">Prices</span></div>
  <div class="doc-prompt"><span class="q">›</span> Who are NVIDIA's top institutional holders this quarter? <span class="tag">13F</span></div>
  <div class="doc-prompt"><span class="q">›</span> Summarize Microsoft's most recent earnings call. <span class="tag">Earnings</span></div>
</div>

## Troubleshooting

<details class="doc-ts"><summary>Server not appearing?</summary>
<div class="doc-ts-body">

After editing `mcp_config.json`, click **Refresh** in Cascade's MCP list (or fully restart Windsurf), and confirm Equibles is enabled.

</div>
</details>

<details class="doc-ts"><summary>Model answers without Equibles data?</summary>
<div class="doc-ts-body">

Tell it explicitly to "use the Equibles MCP server" in your prompt.

</div>
</details>

<details class="doc-ts"><summary>401 / access denied?</summary>
<div class="doc-ts-body">

Your key is missing or wrong — re-copy it from [/dashboard/apikeys](/dashboard/apikeys) into the `Authorization` header. If you're over your daily limit, see [Rate limits](/docs/rate-limits).

</div>
</details>