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

# Windsurf

> Add the Arcus MCP server to Windsurf

Connect [Windsurf](https://windsurf.com) and its Cascade agent to the Arcus docs MCP server.

## Prerequisites

* Windsurf with MCP support (recent versions)

## Setup

<Steps>
  <Step title="Open Cascade's MCP panel">
    In Windsurf, open **Cascade → Plugins / MCP servers** (the entry point is in the Cascade sidebar).
  </Step>

  <Step title="Add the Arcus server">
    Add a new server with the following configuration:

    ```json theme={null}
    {
      "mcpServers": {
        "arcus-docs": {
          "serverUrl": "https://docs.arcus.xyz/mcp"
        }
      }
    }
    ```

    Windsurf reads MCP servers from `~/.codeium/windsurf/mcp_config.json`. Save and reload Cascade.
  </Step>

  <Step title="Authenticate">
    On the first request to the server, Windsurf opens a browser tab for OAuth sign-in. Complete the flow and return to Cascade — the connection becomes active.
  </Step>

  <Step title="Try it">
    Ask Cascade:

    > *What does the response to `GET /v1/positions?address={address}` look like? Include the field types.*

    Cascade will call the MCP server, fetch the relevant page, and ground its answer in the live spec.
  </Step>
</Steps>

## Notes

* If you don't see an authentication prompt, your Windsurf build may predate remote-MCP OAuth support — update and try again.
* For the underlying server details, see the [MCP server overview](/ai-tools/mcp).