Question 1

How do I add Neobrutalism MCP to Windsurf Cascade?

Accepted Answer

Open Windsurf Settings → Cascade → MCP Servers → Manage (or edit ~/.codeium/windsurf/mcp_config.json). Add `neobrutalism` with `serverUrl` set to your registry URL including the token. Save, then hit refresh in the MCP panel — you should see 12 tools.

Question 2

Where does Windsurf store the Neobrutalism MCP config?

Accepted Answer

Typically ~/.codeium/windsurf/mcp_config.json (user-level). That’s the right place so the server is available across projects without committing secrets to a repo.

Question 3

How do I verify Neobrutalism MCP from Cascade?

Accepted Answer

After refresh, ask Cascade: “show me neobrutalism pricing blocks.” It should call search_items and list real slugs. If tools are missing, refresh again or restart Cascade’s MCP panel.

Question 4

Tools don’t show up after saving mcp_config.json — what now?

Accepted Answer

Use the refresh action in the MCP panel — Windsurf doesn’t always hot-reload. If the server shows an error: 401 bad token, 403 no Pro. Re-copy the token from Dashboard → Account and refresh again.

Question 5

Can I keep the Neobrutalism token out of Windsurf’s config file?

Accepted Answer

Yes. Windsurf supports `${env:VAR}` interpolation — write `?token=${env:NEOBRUTALISM_TOKEN}` in serverUrl and export the variable in your shell profile so the secret never sits in JSON.

Question 6

Do I need Pro for Neobrutalism MCP in Windsurf?

Accepted Answer

Yes — Cascade needs Neobrutalism Pro for block source and install tools. Missing token → 401; token without Pro → 403. Upgrade, keep the same serverUrl, hit refresh in the MCP panel.

Question 7

Where is the token for Windsurf’s Neobrutalism serverUrl?

Accepted Answer

Dashboard → Account. Same registry token as Pro shadcn CLI installs.

Question 8

Is it safe to put my token in Windsurf mcp_config.json?

Accepted Answer

It’s a personal, revocable, read-scoped secret. Prefer env interpolation and never commit the file with a real token. Rotate from the dashboard if it leaks.

Question 9

Can my team use Neobrutalism MCP with Cascade?

Accepted Answer

Team/Org Pro seats each get their own token. Every teammate adds their own serverUrl — don’t share one token in a company repo.

Question 10

What can Cascade do with Neobrutalism MCP?

Accepted Answer

Search components and Pro blocks, inspect real source, open previews, and emit token-ready install commands while you stay in the Windsurf flow.

Question 11

How is this different from Cascade without MCP or free shadcn MCP?

Accepted Answer

Without our server, Cascade only has your repo and generic tools. Free shadcn MCP is local and free-components-only. Neobrutalism MCP is hosted Pro access to the full block library and install pipeline.

Question 12

Can Cascade install a Pro block into my Windsurf project?

Accepted Answer

Yes. Ask for a block; Cascade uses get_install_command and returns a `shadcn add` line with your token baked in. Run it in the project terminal to install for your backend.

Question 13

Do I need to refresh MCP every time I open Windsurf?

Accepted Answer

No — once configured, the server should reconnect. If tools vanish after an update, open the MCP panel and hit refresh once.

Question 14

Which backend does Cascade get from Neobrutalism?

Accepted Answer

Base UI by default, or Radix / React Aria when you ask. Source is flattened to that backend before return.

The Neobrutalism MCP serverin Windsurf

One command
to connect

Works with Your Favorite
AI Agent

Windsurf setup
FAQ