setup guide 60 seconds

Connect Loop to Windsurf

Add Loop’s MCP server to Windsurf Cascade. Your agent gets four tools — search, get_details, verify, report — against real, freshness-stamped restaurant data in Kreuzberg Berlin.

Option 1 — Windsurf Settings UI

Open Windsurf Settings → Cascade → MCP Servers
Alternatively, click the MCP icon in the top-right corner of the Cascade panel.
Click Add Server and paste:
MCP server URL
```
https://stayinloop.dev/mcp
```
Leave the server name as loop (or any label you prefer) and save.
Open a new Cascade conversation — Windsurf picks up the server automatically. Try: “search for a vegan restaurant in Kreuzberg”

Option 2 — `~/.codeium/windsurf/mcp_config.json`

Edit (or create) the Windsurf MCP config file directly. Remote HTTP servers use serverUrl (url is also accepted; avoid command, which is for local processes).

mcp_config.json

{
  "mcpServers": {
    "loop": {
      "serverUrl": "https://stayinloop.dev/mcp"
    }
  }
}

Windsurf watches this file and reloads without an editor restart.

With an API key (higher rate limits)

Anonymous access: 30 reads/min + 10 reports/min. A free key doubles those limits. Get a free key →

mcp_config.json

{
  "mcpServers": {
    "loop": {
      "serverUrl": "https://stayinloop.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with the key from your dashboard. Windsurf supports ${env:LOOP_API_KEY} syntax to avoid hardcoding it — set the environment variable and use that instead.

What you get

Tool	What it does
`search`	Natural-language search across 400+ Kreuzberg restaurants
`get_details`	Full record — hours, phone, address, cuisine — plus a result_token for reporting
`verify`	Re-checks a specific claim live (open tonight? outdoor seating?) before acting
`report`	Feeds outcome back — improves confidence scores for everyone who queries later

Frequently asked

What config file does Windsurf use for MCP?

Windsurf stores MCP configuration in ~/.codeium/windsurf/mcp_config.json on macOS and Linux (and %USERPROFILE%\.codeium\windsurf\mcp_config.json on Windows). For remote HTTP servers like Loop, use the serverUrl field (url is also accepted; avoid command, which is for local processes).

Does Loop work with Windsurf Cascade?

Yes. Loop exposes a remote MCP server at https://stayinloop.dev/mcp. Windsurf's Cascade agent supports remote HTTP MCP servers natively — paste the URL and all four Loop tools (search, get_details, verify, report) become available in Cascade immediately.

Do I need an API key to use Loop in Windsurf?

No API key is required during Loop's open wave. Anonymous access gives 30 read calls/min and 10 report calls/min. For higher limits, get a free key at stayinloop.dev and add it as an Authorization header in mcp_config.json.