How to Use the MailWizz MCP in Windsurf

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

Open your mcpconfig.json file in Windsurf or use the Cascade settings UI. Add the server details under the mcpServers block and click refresh. Cascade will instantly discover the new endpoints.

Q: Can Windsurf pause a live MailWizz broadcast?

Yes. Cascade can trigger the pauseemailcampaign tool. If you spot an error in your template, you just tell the agent to stop the send, and it executes the command immediately.

Q: Does Windsurf handle bulk MailWizz subscriber updates?

Cascade can loop through records using listlistsubscribers and apply changes via updatelistsubscriber. You just point it at your data source and let the agent run the batch process.

Q: What happens to my subscriber data when Windsurf reads it?

The getlistdetails and subscriber fetching tools only pull email addresses and custom fields into your local V8 Isolate Sandbox. Vinkius drops the ephemeral container the second your session ends, leaving zero traces of your contact lists on our infrastructure.

Let Windsurf's Cascade agent autonomously manage your MailWizz campaigns and subscriber lists without leaving your editor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect MailWizz MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autopilot for your mailing lists in Windsurf

The `add_subscriber_to_list` tool gives Cascade direct write access to your MailWizz contacts. You tell the agent to sync a CSV file of new signups, and it handles the data mapping automatically. Cascade doesn't stop there. It uses `update_list_subscriber` and `delete_list_subscriber` to scrub bad emails from your database. You just write a prompt asking to clean up bounced addresses, and the agent executes the entire sequence.

Command email campaigns directly

This MCP Server exposes `list_email_campaigns` so Windsurf can pull your live marketing metrics straight into your workspace. You ask for a performance summary, and Cascade fetches the open rates and click data. If something looks wrong, the agent steps in. Using `pause_email_campaign`, Cascade halts a failing broadcast before it damages your sender reputation. It reads the context, makes the call, and shows you the result.

Deep dive into list architecture

Windsurf uses this MCP Server and the `list_subscriber_collections` tool to map out your entire audience structure. When you need to build a new segment, Cascade reads the existing lists and figures out where the gaps are. It pulls specific segment rules via `get_list_details`. Instead of clicking through a web dashboard, you get a full breakdown of your audience routing logic right inside your code editor.

Setup guide

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

mcp_config.json

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

Open your mcp_config.json file in Windsurf or use the Cascade settings UI. Add the server details under the mcpServers block and click refresh. Cascade will instantly discover the new endpoints.

Yes. Cascade can trigger the pause_email_campaign tool. If you spot an error in your template, you just tell the agent to stop the send, and it executes the command immediately.

Cascade can loop through records using list_list_subscribers and apply changes via update_list_subscriber. You just point it at your data source and let the agent run the batch process.

Context switching kills momentum. Having an MCP Server inside your IDE means you can write email templates and deploy them to your lists without opening a browser tab.

The get_list_details and subscriber fetching tools only pull email addresses and custom fields into your local V8 Isolate Sandbox. Vinkius drops the ephemeral container the second your session ends, leaving zero traces of your contact lists on our infrastructure.

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