Skip to main content
Windsurf’s Cascade agent supports remote Model Context Protocol (MCP) servers over the Streamable HTTP transport. You can add Brivvy by dropping a single entry into your MCP configuration file. Once connected, Cascade can call Brivvy tools to retrieve brand voice rules, glossary terms and template instructions without leaving the editor. This is useful for generating on-brand README files, API documentation, code comments and user-facing copy right where you work.

​
Before you start

  • Windsurf installed and signed in to your account.
  • A Brivvy account on a plan that includes MCP access.
  • Node.js 18 or later installed if you plan to edit the config file directly.

​
Steps

  1. Open the Cascade panel in Windsurf. Click the Cascade icon in the top-right corner, or press Cmd+Option+B on macOS or Ctrl+Alt+B on Windows to toggle the sidebar.
  2. Open the MCP configuration. Click the hammer icon in the Cascade panel, then click Configure. This opens the Manage plugins view. Click View raw config to open mcp_config.json in the editor. On macOS and Linux, this file lives at ~/.codeium/windsurf/mcp_config.json. On Windows, it lives at %USERPROFILE%\.codeium\windsurf\mcp_config.json.
  3. Add the Brivvy entry. Paste the following configuration into the file. If an mcpServers block already exists, add brivvy as an additional entry rather than creating a second block: 
   {
     "mcpServers": {
       "brivvy": {
         "serverUrl": "https://mcp.brivvy.io"
       }
     }
   }
  1. Save the file. Press Cmd+S on macOS or Ctrl+S on Windows to write your changes.
  2. Refresh the MCP connection. Return to the Manage plugins view and click Refresh. Windsurf will load the new configuration and prompt you to authenticate.
  3. Authenticate with Brivvy. Your browser will open an authorization page. Sign in to Brivvy and click Authorize to grant Cascade access. After you approve, Windsurf stores the OAuth credentials locally.
  4. Confirm the connection. Back in Windsurf, check that Brivvy shows a connected status in the Manage plugins view. Expand the entry to see the available tools: list_voices, get_voice, list_templates and get_template.

​
How to know it worked

Open a new Cascade conversation and send a prompt that requires brand voice context, for example: “Using Brivvy, get the brand voice rules and write a two-sentence product update.” Cascade will call the appropriate Brivvy tool and return a response shaped by your brand voice rules rather than a generic output.