How to Use the Brevo MCP in Windsurf

Q: How does Windsurf use the Brevo MCP server to clean up my contact lists?

Cascade uses listcrmcontacts to fetch your Brevo audience and runs deletecrmcontact to prune dead profiles from Windsurf. You don't have to write custom scripts or manually edit Brevo spreadsheets.

Q: Can Cascade send test emails through Brevo during a Windsurf debugging session?

Yes, Cascade calls sendtransactionalemail to fire Brevo test messages directly from your Windsurf editor. It uses your verified Brevo domains to prevent bounces while you trace your Windsurf mailer functions.

Q: How do I configure the Brevo MCP server inside Windsurf?

Add the Brevo server details to your local Windsurf mcpconfig.json file or use the settings panel. Once added, Cascade automatically discovers all ten Brevo tools and starts executing them.

Q: What happens if my Brevo API quota runs out while using Cascade in Windsurf?

Cascade runs getsmtpaccountdetails to check your current Brevo limits and remaining quotas. If you hit a limit, Cascade alerts you in the Windsurf chat interface before trying to send more messages.

Let Cascade autonomously manage your Brevo contact lists and fire off transactional alerts directly from your Windsurf editor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Brevo MCP to Windsurf

Create your Vinkius account to connect Brevo 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 Brevo with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous CRM Syncing in Windsurf

The `list_crm_contacts` tool lets Cascade pull your current Brevo audience database directly into your Windsurf workspace context. Cascade reads this Brevo contact feed, cross-references it with your local databases, and plans updates without you typing a single prompt. When Cascade spots a mismatch, it chains `create_crm_contact` and `update_contact_attributes` to align your Brevo lists with your Windsurf codebase. These Brevo API calls are handled in the background by Cascade while you write code.

Automated List and Segment Organization

Running `create_contact_list` builds new target audience directories inside your Brevo account when Cascade detects a new marketing campaign in your Windsurf files. Cascade scans your local directory, finds your segment definitions, and creates the corresponding Brevo folders. By invoking `list_contact_folders` alongside `get_contact_attributes`, Cascade maps out your existing Brevo campaign structures. This lets Windsurf organize your Brevo users into clean buckets without manual database exports.

Multi-Channel Alerts Sent from Code

Sending messages via `send_transactional_email` transmits system alerts through your verified Brevo domains directly from Windsurf. Your Windsurf workspace configuration and Brevo domain status are checked automatically by Cascade before dispatching the outgoing payloads. For urgent alerts, Cascade triggers `send_transactional_sms` to send Brevo text messages directly to user phones. This MCP server lets Windsurf test your Brevo communication workflows live while you modify your application logic.

Setup guide

Set up Brevo 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 Brevo 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 Brevo payment history." If connected, Cascade will call the Brevo tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "brevo-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 Brevo. 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 Brevo 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 Brevo MCP in Windsurf

Cascade uses `list_crm_contacts` to fetch your Brevo audience and runs `delete_crm_contact` to prune dead profiles from Windsurf. You don't have to write custom scripts or manually edit Brevo spreadsheets.

Yes, Cascade calls `send_transactional_email` to fire Brevo test messages directly from your Windsurf editor. It uses your verified Brevo domains to prevent bounces while you trace your Windsurf mailer functions.

Add the Brevo server details to your local Windsurf `mcp_config.json` file or use the settings panel. Once added, Cascade automatically discovers all ten Brevo tools and starts executing them.

Cascade runs `get_smtp_account_details` to check your current Brevo limits and remaining quotas. If you hit a limit, Cascade alerts you in the Windsurf chat interface before trying to send more messages.

Your Brevo API keys, contact emails, and phone numbers never pass through third-party LLM servers. All operations execute locally inside this MCP server sandbox, keeping your Brevo customer data completely isolated.

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