Agent guide

Windsurf Setup

Paste this into your agent

Start with this visible request when you want the agent to help. It keeps the action coming from you, while the linked setup reference stays plain and non-recursive.

Use this in the app you are connecting, then approve only the browser login, app setting, or restart steps that the app requires.

Please help me set up Core for Windsurf. Core is a home base for AI agents: it keeps memory, files, decisions, tasks, and work context synced across tools, harnesses, and models.

Use this official setup reference:
https://gradien.ai/core/docs/reference.txt

Source checked: 2026-06-19 Official source: https://docs.windsurf.com/windsurf/cascade/mcp

Windsurf/Cascade has its own MCP config conventions, including serverUrl in some flows. Do not assume the Cursor config shape.

Recommended setup path:

  1. Fetch the current Windsurf MCP docs.
  2. Detect whether the user has local Windsurf config available.
  3. Back up config before editing.
  4. Use the current documented remote MCP shape.
  5. Note any enterprise/admin controls or tool-count limits if tools do not appear.