Use TypeUI with Windsurf

Follow this guide to connect Windsurf to TypeUI while Cascade edits UI in your project.

Open Windsurf

Open the project where you want Cascade to build UI.

Add TypeUI to Windsurf

Click the button below to open TypeUI in the Windsurf MCP registry:

Install in Windsurf

If the button does not open Windsurf:

Open Windsurf Settings → Cascade → MCP Servers and add it manually.

Add this configuration:

Plain text
{
  "mcpServers": {
    "typeui": {
      "serverUrl": "https://mcp.typeui.sh/mcp"
    }
  }
}

Windsurf uses serverUrl for remote HTTP MCP servers.

Sign in with TypeUI if Windsurf asks you to authorize the connection.

Create a draft

Review the markdown

Open View markdown source files and review them before publishing.

Files to review

The main entry file. It tells AI tools how to use this design system and where to look next.Logo and brand asset guidance. Colors, typography, and spacing stay in their own files.Color tokens and usage guidance for brand, surfaces, text, borders, and states.Font families, sizes, weights, line heights, headings, labels, and body text rules.Spacing, grids, containers, responsive behavior, and layout structure rules.Button sizes, variants, states, icon spacing, focus behavior, and accessibility rules.+14 more

Edit the source files

Adjust the markdown when you need clearer rules, stronger component guidance, or product-specific language. After publishing, TypeUI MCP uses your saved edits when it helps your AI tool build UI.

Publish for MCP

Publish when ready so your MCP-connected AI tool can use it.

Start building UI

Build me a landing page.

Tell Cascade what to build. TypeUI helps it choose the right style and layout.

Review and refine

Run your app and review the changes. Ask Cascade for targeted improvements:

I don't like this pricing section, give me more variations.

TypeUI will now create three pricing variations so you can compare different layouts before choosing one.

Three pricing cards prompt preview
TypeUITypeUIPro

After you choose a direction, tell Cascade which one to use:

I like the comparison one. Let's use it.

Once Windsurf is connected to TypeUI, you can keep working in the same flow: choose a design system, ask for the interface you need, review the generated variations, and tell Cascade which direction to continue with.