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

# Windsurf setup

> Configure Windsurf to use Synthbrew through the MCP server.

Use the Synthbrew MCP server in Windsurf Cascade to create and inspect Synthbrew resources from your coding workflow.

## Prerequisites

* Windsurf installed
* A Synthbrew public API key

## Configure Windsurf

Create or update `~/.codeium/windsurf/mcp_config.json`:

```json theme={null}
{
  "mcpServers": {
    "synthbrew": {
      "command": "npx",
      "args": ["-y", "@synthbrew/agent"],
      "env": {
        "SYNTHBREW_API_KEY": "sb_api_...",
        "SYNTHBREW_API_URL": "https://api.synthbrew.com/api"
      }
    }
  }
}
```

Reload Windsurf after changing the configuration.

## Try a product prompt

Ask Cascade:

```text theme={null}
Use Synthbrew to create a schema for an ecommerce admin dashboard with customers, products, orders, order_items, payments, and refunds. Generate a populated source and return the connection details.
```

Cascade should validate the schema before creating resources.