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

# Windsurf

> Connect ScrapeBadger to Windsurf IDE via MCP.

# Windsurf

## Setup

Edit the MCP config file at:

* **macOS/Linux**: `~/.codeium/windsurf/mcp_config.json`
* **Windows**: `%USERPROFILE%\.codeium\windsurf\mcp_config.json`

Or open via: Windsurf Settings > Cascade > MCP Servers

```json theme={null}
{
  "mcpServers": {
    "scrapebadger": {
      "serverUrl": "https://mcp.scrapebadger.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

<Warning>
  Windsurf uses `serverUrl` — not `url`. This is different from Cursor and other tools.
</Warning>

## Verify

Go to Windsurf Settings > Cascade > MCP Servers. ScrapeBadger should appear as connected.

<Note>
  Windsurf has a maximum of 100 tools across all MCP servers. ScrapeBadger uses 92 (Twitter, Google, Vinted, Web Scraping), leaving room for 8 more from other servers.
</Note>

## Example

Ask Cascade in Agent mode:

> "Search Google Shopping for a gaming headset under \$200 and return the merchant URL of the top result"

Cascade will call `google_shopping_search` then `google_shopping_product_click`.