How to Use the Emarsys MCP in Windsurf

Q: Can Windsurf read my active Emarsys email campaigns?

Yes. Cascade calls listemailcampaigns directly from the editor. It returns the full array of active, paused, and completed campaigns configured in your account.

Q: Does Cascade know which triggers fire automation programs?

The agent figures this out by executing listtriggerevents. It pulls the external event IDs and matches them against the workflows returned from your account.

Connect the Emarsys MCP Server to Windsurf and let Cascade autonomously manage your marketing automation data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Emarsys MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Windsurf MCP Server for Marketing Automation

The Emarsys MCP Server lets Cascade autonomously map your email marketing architecture. You set a goal to audit active workflows, and Windsurf immediately pulls `list_automation_programs` followed by `list_audience_segments` without asking for permission. Cascade reads the context of your request and chains the exact operations needed. If you want a full funnel review, the agent executes a `quick_engagement_volume_audit` and then drills down into specific segments using `get_campaign_details` to show you the exact status of your outbound messages.

Map Trigger Events to Workflows

Developers spend hours tracking down which external events fire which emails. Windsurf bypasses that manual search by chaining `list_trigger_events` with `list_registration_forms`. You tell the IDE to document the lead capture flow. Cascade fetches the active subscription endpoints and cross-references them against your automation programs, generating a clear map of how contacts enter the database.

Inspect Contact Configurations

Debugging a failed segment sync requires looking at the actual list settings. Windsurf uses `list_marketing_contact_lists` to grab the directory, then automatically runs `get_contact_list_details` on the suspected failures. The agent handles the pagination and ID matching in the background. You just read the final output detailing exactly how your organization configured those specific contact lists.

Setup guide

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

mcp_config.json

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

Open the MCP panel in your editor and navigate to Settings, then Cascade. Add the server details under the mcpServers key in your configuration file and click refresh. Cascade auto-discovers the tools immediately.

Yes. Cascade calls `list_email_campaigns` directly from the editor. It returns the full array of active, paused, and completed campaigns configured in your account.

The agent figures this out by executing `list_trigger_events`. It pulls the external event IDs and matches them against the workflows returned from your account.

You skip the UI clicks. Cascade chains multiple API calls together in seconds, letting you audit forms and campaigns while you write the actual integration code.

The server processes contact list metadata and campaign settings through a V8 Isolate Sandbox. Windsurf only receives the specific JSON payload requested by the tool, and the ephemeral execution environment destroys the memory state immediately after returning the response.

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