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

# Windsurf

> Connect the UseAgents MCP server to Windsurf IDE using the Marketplace or manual configuration.

Connect UseAgents to Windsurf so your AI assistant can discover verified developer tools from the registry.

<Note>
  UseAgents is **currently free** during our public beta. No API key is required. Requests are subject to [rate limits](/api-reference/rate-limit).
</Note>

## Option 1: MCP Marketplace

1. Open the **Cascade** panel in Windsurf.
2. Click the **MCPs icon** (or go to **Windsurf Settings** → **Cascade** → **MCP Servers**).
3. Search for **UseAgents** and click **Install**.

## Option 2: Manual config

If UseAgents is not listed in the Marketplace, add it manually by editing the config file.

### Locate the config file

| Platform          | Path                                              |
| ----------------- | ------------------------------------------------- |
| **macOS / Linux** | `~/.codeium/windsurf/mcp_config.json`             |
| **Windows**       | `%USERPROFILE%\.codeium\windsurf\mcp_config.json` |

You can also open it by pressing `Cmd+Shift+P` (macOS) or `Ctrl+Shift+P` (Windows/Linux) and selecting **"Windsurf: Configure MCP Servers"**.

### Add UseAgents

Add the following to the `mcpServers` object:

```json theme={null}
{
  "mcpServers": {
    "UseAgents": {
      "serverUrl": "https://mcp.useagents.site/mcp"
    }
  }
}
```

<Tip>
  Windsurf uses `"serverUrl"` (not `"url"`) for remote HTTP/SSE servers. This is different from the standard MCP config format used by Cursor and Claude.
</Tip>

If you already have other servers configured, add the `"UseAgents"` entry inside the existing `"mcpServers"` object.

## Verify the connection

1. **Quit and reopen** Windsurf completely — changes to `mcp_config.json` require a full restart.
2. Open the **Cascade** panel and check that `UseAgents` appears in the MCP Servers list.
3. Ask Cascade to search for a tool — for example: *"Use UseAgents to find a TypeScript SDK for Stripe."*
4. Confirm you receive structured tool results.

## Troubleshooting

* **Server not appearing**: Windsurf requires a full quit and reopen, not just a window close.
* **Connection failed**: Verify that the `serverUrl` value is exactly `https://mcp.useagents.site/mcp`.
* **Too many tools warning**: Windsurf has a 100-tool limit across all connected servers. UseAgents exposes only 2 tools, so this should not be an issue.

## Next steps

* [MCP Tools Reference](/mcp/tools-reference/introduction) to understand the available tools
* [Rate Limits](/api-reference/rate-limit) for request limits during the beta