# Windsurf

Set up Windsurf for SurrealDB with the hosted MCP server and the official Agent Skills.

[Windsurf](https://windsurf.com) supports MCP servers natively through its Cascade agent. Connecting SurrealDB gives Cascade your Cloud instances and the data inside them while it works.

## Add the MCP server

Windsurf uses `serverUrl` rather than `url`. The file is `~/.codeium/windsurf/mcp_config.json` on macOS and Linux, and `%USERPROFILE%\.codeium\windsurf\mcp_config.json` on Windows.

```json
{
  "mcpServers": {
    "surrealdb": {
      "serverUrl": "https://mcp.surrealdb.com"
    }
  }
}
```

## Sign in

Restart Windsurf, then open **Settings → MCP** and connect. The panel reports each server's status.

## Install the Agent Skills

```bash
npx skills add surrealdb/agent-skills
```

## Check it worked

Open the Cascade panel and ask which SurrealDB tools it has access to.

## Try it

> Deploy nothing yet — just tell me what a small instance in eu-west-1 would cost per month.

Cascade prices the configuration and waits for your go-ahead. Creating an instance costs money, so the server never does it without one.

## Next steps

- [SurrealDB MCP Server](/docs/build/ai-agents/mcp.md) — every tool the server publishes
- [Agent Skills](/docs/build/ai-agents/agent-skills.md) — what each skill covers