How to Use the Braze MCP in Windsurf

Q: How do I connect the Braze MCP Server to Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers key. Alternatively, go to Settings, select Cascade, and use the MCP Servers UI to paste the endpoint. Refresh the panel, and Cascade will instantly discover the tools.

Trigger Braze campaigns and track user profiles autonomously inside Windsurf using Cascade.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Braze MCP to Windsurf

Create your Vinkius account to connect Braze to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Braze with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Braze campaigns directly from Windsurf

The Braze MCP Server provides tools to trigger and manage marketing workflows directly from your IDE. You don't need to open the Braze dashboard to launch a campaign or test a canvas. Cascade uses `trigger_campaign` and `trigger_canvas` to run these jobs during your development workflow. Instead of manual API testing, write a prompt telling Cascade to fire a test journey. It will check the parameters, pull details using `get_campaign_details`, and fire the trigger. You see the immediate result in your output log without context switching.

Manage user profiles and track events

This MCP Server exposes tools like `track_user` and `identify_user` to manage customer data straight from Cascade. You don't have to write custom curl scripts to test user attribute updates. Cascade runs these updates in the background while you focus on writing code. If you need to clean up test data, the agent can call `delete_user` to wipe profiles. Cascade chains these steps together, finding the right user IDs with `export_user_ids` before executing the deletion.

Inspect live marketing assets

This MCP Server provides instant access to your marketing assets via the `list_campaigns` and `list_canvases` tools. Cascade reads your active marketing flows to check their setup before you build integration code. You can ask Cascade to fetch the specific steps of a user journey using `get_canvas_details`. It reads the canvas parameters, verifies the API keys, and confirms everything matches your local code setup.

Setup guide

Set up Braze MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Braze MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Braze payment history." If connected, Cascade will call the Braze tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "braze-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Braze. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Braze now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Braze MCP in Windsurf

Open your ~/.codeium/windsurf/mcp_config.json file and add the server configuration under the mcpServers key. Alternatively, go to Settings, select Cascade, and use the MCP Servers UI to paste the endpoint. Refresh the panel, and Cascade will instantly discover the tools.

Yes. Cascade chains tools together to find your canvas ID using `list_canvases` and then runs it with `trigger_canvas`. You just tell it the goal, and it executes the sequence.

Yes, your keys are stored locally on your machine or managed securely inside the Vinkius vault. Windsurf connects over a secure transport, meaning your credentials never leak into public LLM training sets.

Cascade displays the raw tool output inside the chat interface when an execution fails. If `track_user` fails due to bad payload formats, Cascade reads the error message and automatically corrects the JSON structure.

This server handles Braze user profiles, tracking events, and campaign metadata. Vinkius runs the server inside a sandboxed V8 Isolate, ensuring that your customer records are processed in an ephemeral environment and never cached.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript