How to Use the Mailingwork MCP in Windsurf

Q: How do I connect Mailingwork to Windsurf?

Open your mcpconfig.json file in /.codeium/windsurf/ and add the server details. You can also use the Settings menu to navigate to the Cascade MCP Servers UI and configure it there. Click refresh, and the tools become active immediately.

Q: Does the Mailingwork MCP Server support A/B testing?

You can pull campaign variants using listmailings and check the results. The agent analyzes the performance data and prints a summary of the winning variant directly in your editor pane.

Connect Mailingwork to Windsurf and let Cascade handle your email campaigns.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mailingwork MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Windsurf automates list segmentation

The `list_subscribers` and `list_tags` tools give this MCP Server direct access to your audience data right inside your editor. You tell the agent to find users missing specific tags, and it queries the database to build that segment. No manual exporting or filtering required. Once it pulls the audience, Cascade can automatically loop through and fire `update_subscriber` to clean up profile data. It reads your prompt, plans the data correction steps, and executes the whole batch without asking for permission between every single update.

Trigger workflows from your codebase

Calling `trigger_automation` lets your AI client launch specific marketing sequences while you write the backend logic. If you just finished coding a new user onboarding flow, Cascade can hook up the exact email trigger to test it immediately. You don't have to leave the IDE to verify the result. The agent uses `get_subscriber` to confirm the test user actually entered the automation path. It shows you the raw JSON response so you know the API call succeeded.

Send transactional emails fast

The `send_transactional_email` tool pushes immediate messages like order confirmations or password resets straight through the Mailingwork MCP Server. Cascade can draft the HTML template, inject the variables, and fire the test email in one fluid motion. Checking campaign performance happens just as quickly. Your agent runs `list_mailings` and `get_mailing` to pull open rates and click data into your terminal. You see exactly how the test performed without opening a browser tab.

Setup guide

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

mcp_config.json

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

Open your mcp_config.json file in ~/.codeium/windsurf/ and add the server details. You can also use the Settings menu to navigate to the Cascade MCP Servers UI and configure it there. Click refresh, and the tools become active immediately.

Yes. Cascade can read a local CSV file and loop through the rows to fire `create_subscriber` for each contact. It handles the mapping and executes the API calls autonomously.

Cascade reads the error response and attempts to fix the payload. If it hits a rate limit or bad request, the agent adjusts the parameters and retries the operation without needing your input.

You can pull campaign variants using `list_mailings` and check the results. The agent analyzes the performance data and prints a summary of the winning variant directly in your editor pane.

Your email addresses, tags, and GDPR consent logs never leave your local machine or the Vinkius V8 Isolate Sandbox. The connection relies on a single endpoint token, meaning the AI client only reads the data needed for the current prompt and immediately discards it.

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