Skip to content

Windsurf

Windsurf is the agentic IDE built by Codeium, and its headline feature is Cascade — an AI agent with deep awareness of your entire codebase, your in-IDE actions, and the terminal output. Cascade doesn't just see the file you're editing; it tracks every file you open, every command you run, and every diff you review, building a rich context graph. MCP tools extend Cascade's reach beyond the local codebase to external systems and APIs.


Wi
Windsurf
Codeium · windsurf.com
TRANSPORT
Streamable HTTP ✓
PLATFORM
Windows · macOS · Linux
MCP VIA
Cascade MCP Integration

Cascade: Codebase-Aware Agent + MCP

Cascade's distinguishing factor is implicit context. While other agents require you to explicitly reference files or symbols, Cascade already knows what you've been working on. It sees your terminal output, your recent file edits, and the pattern of changes across your project. MCP tools feed additional external context into this awareness graph.

Supercomplete goes beyond traditional code completion. It predicts your next action, not just your next token — suggest running a test, opening a related file, or calling an MCP tool based on what you just did.

Flows merge the copilot and agent paradigms. Instead of switching between "ask AI" and "let AI act", Cascade operates on a spectrum — sometimes completing your code, sometimes taking multi-step autonomous actions, always adapting to the situation.

Features:

  • Cascade — deep codebase awareness with action-level context tracking
  • Supercomplete — next-action prediction beyond code completion
  • Flows — copilot and agent behavior in one seamless experience
  • Turbo mode — auto-execute terminal commands without approval
  • Codelenses — inline AI insights on code logic and complexity
  • Custom MCP — add your own MCP servers for external data
  • Multi-model — Gemini, Claude, and other leading models

Configuration

1. Create a Token

In Vinkius Cloud, go to your server → Connection TokensCreate. Copy the URL.

2. Add MCP Server

In Windsurf → SettingsCascadeMCP Servers → paste your Vinkius URL.

3. Code with Cascade

Cascade uses MCP tools during multi-step coding tasks. It calls tools, reads the results, and incorporates data into its coding decisions.


FAQ

How does Cascade use MCP tools differently? Cascade has deep codebase awareness. When it calls an MCP tool, it combines the result with its understanding of your project structure, recent changes, and terminal output.

What is Supercomplete? An action-level prediction system. It suggests your next move (run test, open file, call MCP tool) rather than just completing code on the current line.

Can I auto-execute terminal commands? Yes. Turbo mode lets Cascade run terminal commands without prompting for approval.

Is Windsurf free? Free tier available. Pro plans unlock advanced Cascade features.