Busabase for Windsurf

Connect Windsurf to Busabase

The Cascade agent's editor; MCP servers live in a single JSON file and support OAuth per transport type.

Paste this into Windsurf

Read https://busabase.com/SETUP_SKILL.md and set up Busabase for me. Follow it through to the end, then confirm the connection works.

Read the Windsurf Skills documentation

Busabase

Agent Skill

Give your agent this one instruction

You end up with more than a connector: the busabase skill carries the whole change-request workflow, the CLI, and the full API — available in every future session without re-pasting anything.

Asks first

Busabase Cloud or Personal Desktop — your call, before anything happens.

Connects

Signs you in and stores the credential itself. No API key to copy by hand.

Seeds a Base

Creates and fills your first Base, so the workspace is not an empty screen.

Installs the skills

busabase and busabase-app-creator become permanent, for every session after this.

Prefer a connector?

If you would rather wire Busabase in as MCP tools than let the agent install a skill, use the server URL below.

Windsurf MCP documentation

At a glance

Vendor: Cognition
How it connects: MCP + OAuth · Plugin / Skill
Transport: Streamable HTTP
Authentication: OAuth (dynamic registration)
Config file: ~/.codeium/windsurf/mcp_config.json

Add Busabase to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "busabase": {
      "serverUrl": "https://busabase.com/api/mcp"
    }
  }
}

Or use the MCPs icon in the top right of the Cascade panel, or Settings → Cascade → MCP Servers.

Complete OAuth in the browser when Cascade connects, then ask it to call auth_verify.

Known gotchas

The key is `serverUrl`, not `url` — a `url` key is silently ignored. The config also supports `${env:VAR}` interpolation, so a token never has to be hardcoded.

How it compares

Connection capabilities side by side with other agents already in this directory.

Capability	Windsurf	Claude Code	Cursor
Type	AI editors	Terminal agents	AI editors
Recommended path	Agent Skill	Agent Skill	Agent Skill
How it connects	MCP + OAuth · Plugin / Skill	MCP + OAuth · Plugin / Skill	MCP + OAuth · Plugin / Skill
Transport	Streamable HTTP	Streamable HTTP	Streamable HTTP
Authentication	OAuth (dynamic registration)	OAuth (dynamic registration)	OAuth (dynamic registration)

These stepsFrom official docsNo check date recorded

Written from this agent's own documentation. We have not re-run every step on a real machine, so check the linked docs if a command has changed.

Where these steps come from Official site

Let your agent do the setup

One instruction, one authorization, and every change it makes afterwards carries a message and a diff you can check or revert.

Browse every agent

Paste this into Windsurf

Read https://busabase.com/SETUP_SKILL.md and set up Busabase for me. Follow it through to the end, then confirm the connection works.

All agents

Busabase for Windsurf

Connect Windsurf to Busabase

The Cascade agent's editor; MCP servers live in a single JSON file and support OAuth per transport type.

Paste this into Windsurf

Read https://busabase.com/SETUP_SKILL.md and set up Busabase for me. Follow it through to the end, then confirm the connection works.

Read the Windsurf Skills documentation

Busabase

Agent Skill

Give your agent this one instruction

You end up with more than a connector: the busabase skill carries the whole change-request workflow, the CLI, and the full API — available in every future session without re-pasting anything.

Asks first

Busabase Cloud or Personal Desktop — your call, before anything happens.

Connects

Signs you in and stores the credential itself. No API key to copy by hand.

Seeds a Base

Creates and fills your first Base, so the workspace is not an empty screen.

Installs the skills

busabase and busabase-app-creator become permanent, for every session after this.

Prefer a connector?

If you would rather wire Busabase in as MCP tools than let the agent install a skill, use the server URL below.

Windsurf MCP documentation

At a glance

Vendor: Cognition
How it connects: MCP + OAuth · Plugin / Skill
Transport: Streamable HTTP
Authentication: OAuth (dynamic registration)
Config file: ~/.codeium/windsurf/mcp_config.json

Add Busabase to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "busabase": {
      "serverUrl": "https://busabase.com/api/mcp"
    }
  }
}

Or use the MCPs icon in the top right of the Cascade panel, or Settings → Cascade → MCP Servers.

Complete OAuth in the browser when Cascade connects, then ask it to call auth_verify.

Known gotchas

The key is `serverUrl`, not `url` — a `url` key is silently ignored. The config also supports `${env:VAR}` interpolation, so a token never has to be hardcoded.

How it compares

Connection capabilities side by side with other agents already in this directory.

Capability	Windsurf	Claude Code	Cursor
Type	AI editors	Terminal agents	AI editors
Recommended path	Agent Skill	Agent Skill	Agent Skill
How it connects	MCP + OAuth · Plugin / Skill	MCP + OAuth · Plugin / Skill	MCP + OAuth · Plugin / Skill
Transport	Streamable HTTP	Streamable HTTP	Streamable HTTP
Authentication	OAuth (dynamic registration)	OAuth (dynamic registration)	OAuth (dynamic registration)

These stepsFrom official docsNo check date recorded

Written from this agent's own documentation. We have not re-run every step on a real machine, so check the linked docs if a command has changed.

Where these steps come from Official site

Let your agent do the setup

One instruction, one authorization, and every change it makes afterwards carries a message and a diff you can check or revert.

Browse every agent

Paste this into Windsurf

Read https://busabase.com/SETUP_SKILL.md and set up Busabase for me. Follow it through to the end, then confirm the connection works.

All agents

Busabase for Windsurf

Connect Windsurf to Busabase

The Cascade agent's editor; MCP servers live in a single JSON file and support OAuth per transport type.

Paste this into Windsurf

Read https://busabase.com/SETUP_SKILL.md and set up Busabase for me. Follow it through to the end, then confirm the connection works.

Read the Windsurf Skills documentation

Busabase

Agent Skill

Give your agent this one instruction

You end up with more than a connector: the busabase skill carries the whole change-request workflow, the CLI, and the full API — available in every future session without re-pasting anything.

Asks first

Busabase Cloud or Personal Desktop — your call, before anything happens.

Connects

Signs you in and stores the credential itself. No API key to copy by hand.

Seeds a Base

Creates and fills your first Base, so the workspace is not an empty screen.

Installs the skills

busabase and busabase-app-creator become permanent, for every session after this.

Prefer a connector?

If you would rather wire Busabase in as MCP tools than let the agent install a skill, use the server URL below.

Windsurf MCP documentation

At a glance

Vendor: Cognition
How it connects: MCP + OAuth · Plugin / Skill
Transport: Streamable HTTP
Authentication: OAuth (dynamic registration)
Config file: ~/.codeium/windsurf/mcp_config.json

Add Busabase to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "busabase": {
      "serverUrl": "https://busabase.com/api/mcp"
    }
  }
}

Or use the MCPs icon in the top right of the Cascade panel, or Settings → Cascade → MCP Servers.

Complete OAuth in the browser when Cascade connects, then ask it to call auth_verify.

Known gotchas

The key is `serverUrl`, not `url` — a `url` key is silently ignored. The config also supports `${env:VAR}` interpolation, so a token never has to be hardcoded.

How it compares

Connection capabilities side by side with other agents already in this directory.

Capability	Windsurf	Claude Code	Cursor
Type	AI editors	Terminal agents	AI editors
Recommended path	Agent Skill	Agent Skill	Agent Skill
How it connects	MCP + OAuth · Plugin / Skill	MCP + OAuth · Plugin / Skill	MCP + OAuth · Plugin / Skill
Transport	Streamable HTTP	Streamable HTTP	Streamable HTTP
Authentication	OAuth (dynamic registration)	OAuth (dynamic registration)	OAuth (dynamic registration)

These stepsFrom official docsNo check date recorded

Written from this agent's own documentation. We have not re-run every step on a real machine, so check the linked docs if a command has changed.

Where these steps come from Official site

Let your agent do the setup

One instruction, one authorization, and every change it makes afterwards carries a message and a diff you can check or revert.

Browse every agent

Paste this into Windsurf

Read https://busabase.com/SETUP_SKILL.md and set up Busabase for me. Follow it through to the end, then confirm the connection works.