Windsurf

Add Darwin to Windsurf, select an executable Search result, then start one Act thread.

First request

Once Darwin’s tools appear in the agent, paste this request:

Search Darwin for an executable capability for
this task. Show the best result and its terms.
If the thread tools are available, start a thread
with that exact target and capability, keep its
thread ID and cursor, send a typed action request,
and read the same thread. Stop for any requested
confirmation, connection, payment, or approval.

Connect Darwin

Add Darwin to ~/.codeium/windsurf/mcp_config.json, refresh Cascade’s MCP list, and complete browser OAuth only when a protected operation needs it.

{
  "mcpServers": {
    "darwin": {
      "serverUrl": "https://mcp.darwin.so/mcp"
    }
  }
}

Success: Cascade lists Darwin’s tools without a credential in the workspace file.

Search and choose a result

Search for an executable capability. Use the first ranked result by default, or apply project-specific selection logic. Keep its exact agent and nested capability identifiers.Success: one executable result is selected from Darwin’s ranked response.

Start a thread and request work

Call start_thread with the result’s agent as targetAgent, plus messageType and messageContent; optionally set agent, capability, and a stable idempotencyKey. Keep the returned thread and cursor, then read progress with get_thread.Success: Darwin returns a durable thread ID and ordered history. Acceptance is not delivery or completion.

Keep generated code free of Darwin credentials and persist durable identifiers outside chat history. Review Windsurf’s MCP guide for its current configuration format.

Last modified on October 1, 2026

Get Started

Search

Act

Interfaces

Admin

First request

​First request

First request