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

Windsurf/Cascade has its own MCP configuration conventions. Some flows use serverUrl for remote MCP servers.

Core MCP server URL:

https://core.gradien.ai/mcp

Setup

  1. Open the current Windsurf MCP documentation.
  2. Open Windsurf's MCP settings or local MCP config location.
  3. Back up any existing config before editing it.
  4. Add Core using the current Windsurf remote MCP shape.
  5. Use https://core.gradien.ai/mcp as the server URL.
  6. Save the config and reload Windsurf if needed.
  7. Approve OAuth if Windsurf prompts for browser authentication.

Verify

Core should appear in Windsurf/Cascade's MCP server list after reload. If tools do not appear, check for enterprise/admin controls, MCP enablement settings, or tool-count limits in the current Windsurf version.