Cascade agentic IDE host Fact-checked · 2026-11-17

Windsurf Hub: Cascade Modes, Prompt Credits, Workflows and MCP Setup

Understand Windsurf's Cascade agent, monthly Prompt Credits, automatic Memories, `.windsurfrules`, `/workflows` and `mcp_config.json` integration.

The host itself is closed-source or hosted and is not FARS-scored; open-source extensions below carry their own FARS reviews.

Key takeaways

  • Windsurf is a closed-source AI IDE centered on its Cascade agent (Write and Chat modes) and real-time editor/terminal awareness.
  • Uses a monthly Prompt Credits billing model with a free starter tier and paid Pro, Teams and Enterprise plans.
  • Customizes behavior via automatic Memories, `.windsurfrules` and Markdown workflows in `.windsurf/workflows/`.
  • Connects to external tools through `~/.codeium/windsurf/mcp_config.json`.

Key facts: pricing, models, surfaces & safety

Pricing & quota
Free starter tier + Pro / Teams monthly Prompt Credits

Includes a free tier with unlimited autocomplete and trial Cascade credits; paid plans allocate monthly Prompt Credits consumed at model-specific multipliers.

Models & providers
In-house SWE-1 models + hosted Claude, GPT, Gemini & DeepSeek

Provides unified access to frontier coding models and Windsurf's own SWE-1 family.

OS & surfaces
macOS · Windows · Linux desktop IDE + JetBrains / VS Code plugins

Standalone Windsurf desktop editor plus extensions for JetBrains IDEs, VS Code and Neovim.

Safety & permissions
Configurable command auto-execution + Zero-Data Retention

Terminal execution honors allow/deny lists and confirmation settings; Zero-Data Retention is available for privacy-sensitive teams.

Extension points: Memories, Rules, Workflows and MCP

Cascade workflows and extensions rely on three configuration surfaces:

.windsurfrules & Memories

Combines explicit workspace/global rule files with Cascade's auto-generated cross-session memories.

Windsurf Workflows (.windsurf/workflows/)

Markdown playbooks invoked via `/workflow-name` inside Cascade.

MCP Servers (mcp_config.json)

External Model Context Protocol servers configured in `~/.codeium/windsurf/mcp_config.json`.

Windsurf ecosystem & extensions

Plugins, config packs, switchers and orchestration layers in the directory built for Windsurf, by stars; each has its own FARS review.

Browse Windsurf skills on FollowSkills →

Windsurf comparisons & rankings

Related concepts

Frequently asked questions

How does Windsurf compare to Cursor?

Both are VS Code-based AI IDEs. Windsurf emphasizes real-time shared context in Cascade, built-in Memories and `/workflows`, while Cursor offers broader BYOK options, cloud Background Agents and a larger `.cursor/rules` ecosystem.

Where is Windsurf's MCP configuration file?

Windsurf stores MCP server definitions in `~/.codeium/windsurf/mcp_config.json`, which can also be edited from the Cascade toolbar.

Host agent ecosystem hubs