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

# Use with Windsurf

> Add UniversalBench to Windsurf (Codeium's AI editor).

Windsurf's Cascade agent supports MCP. UniversalBench plugs in like any other server, but with one less thing to configure since there are no headers.

## Setup

<Steps>
  <Step title="Get your personal MCP URL">
    Sign up at [universalbench.dev](https://universalbench.dev) and copy your URL.
  </Step>

  <Step title="Open Windsurf MCP settings">
    Click the hammer icon in Cascade, then "Configure", then "Open mcp\_config.json".
  </Step>

  <Step title="Add UniversalBench">
    ```json theme={null}
    {
      "mcpServers": {
        "universalbench": {
          "serverUrl": "https://universalbench-mcp.penantiaglobal.workers.dev/u/ubk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
        }
      }
    }
    ```

    No `headers` block. Less surface area for misconfigs.
  </Step>

  <Step title="Refresh Cascade">
    Click "Refresh" in the MCP panel. UniversalBench tools appear.
  </Step>
</Steps>

## What you can do now

Cascade can now reach beyond your local machine:

> Search the web for current best practices on Postgres connection pooling, then write a short brief I can paste into our team wiki.

Cascade uses `web_search` for live sources and `code` to format the output as Markdown.

Or for ad hoc analysis:

> Run a Python script in UniversalBench that simulates 10,000 dice rolls and gives me the distribution.

Cascade calls `code` once and returns a clean histogram in the response.

## Tips

<Tip>
  Windsurf supports parallel tool calls. UniversalBench is stateless across requests (unless you opt in with `session_id`), so Cascade can fire multiple calls concurrently when the workflow allows.
</Tip>

## Troubleshooting

| Problem                  | Fix                                                              |
| :----------------------- | :--------------------------------------------------------------- |
| Tools missing in Cascade | Hit refresh in the MCP panel. If still missing, restart Windsurf |
| 401 errors               | URL token typo, paste the URL from your dashboard exactly        |
| Cold starts feel slow    | Use `session_id` to keep state warm across calls                 |