Windsurf

Windsurf 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.

{
  "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

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 — every tool the server publishes

• •

  Agent Skills — what each skill covers