How to Use the EmailOctopus MCP in Windsurf

Q: Can Windsurf create new EmailOctopus subscriber lists automatically?

Yes. Cascade calls createemaillist when it detects you need a fresh segment for a new feature. It handles the naming and configuration based on your project context.

Q: Why is Windsurf failing to trigger my EmailOctopus automation?

The triggerautomationforcontact endpoint requires the API trigger to be explicitly enabled in your account settings. Tell Cascade to check your dashboard configuration if the code looks correct but the emails stay queued.

Q: How do I filter contacts by status?

The listcontactsinlist tool accepts a status parameter. Your agent passes "subscribed" or "unsubscribed" to pull exactly the segment you need for local testing.

Let Windsurf Cascade autonomously manage your subscriber lists and trigger email campaigns straight from 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 EmailOctopus MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomously Chain Contact Workflows

The `add_contact_to_list` tool lets Windsurf inject new users straight into your marketing funnels. Cascade reads your backend logic, realizes a new signup needs an email profile, and chains this together with `update_contact_profile` without asking for your permission. You set a goal to sync your local database with your newsletter, and the agent figures out the exact API steps. It does not stop at simple additions. If a user unsubscribes in your test environment, Cascade fires `remove_contact_from_list` to mirror that state. You watch the terminal output while Windsurf handles the entire synchronization process in the background.

Windsurf MCP Server For Campaign Analytics

Using `get_campaign_summary_report`, this MCP Server pulls raw performance metrics right into your workspace. Cascade grabs the open rates and click data, formats them into a markdown table, and drops it into your current file. You skip logging into a web dashboard entirely. When you need deeper context on why a specific send failed, the agent chains `list_email_campaigns` to find the ID and runs `get_campaign_details`. Windsurf reads the configuration, compares it against your local email templates, and points out exactly where your tracking links broke.

Fire Onboarding Sequences From Code

The `trigger_automation_for_contact` tool forces a specific automation path to start for a given subscriber. When you write a new billing script, Windsurf spots the payment success function and automatically suggests wiring up this endpoint to send the receipt sequence. It builds the integration while you focus on the payment logic. You also get complete visibility into the setup before execution. Cascade runs `list_email_lists` and `get_list_details` to verify the target audience actually exists before committing the code. The agent checks the list status, confirms the API trigger is enabled, and finalizes the implementation.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "emailoctopus-alternative-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 EmailOctopus. 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 EmailOctopus 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 EmailOctopus MCP in Windsurf

Open your Settings and navigate to the Cascade MCP Servers UI. Add the server details under the mcpServers array and click Refresh. The marketplace also offers a one-click install option.

Yes. Cascade calls `create_email_list` when it detects you need a fresh segment for a new feature. It handles the naming and configuration based on your project context.

The `trigger_automation_for_contact` endpoint requires the API trigger to be explicitly enabled in your account settings. Tell Cascade to check your dashboard configuration if the code looks correct but the emails stay queued.

The `list_contacts_in_list` tool accepts a status parameter. Your agent passes "subscribed" or "unsubscribed" to pull exactly the segment you need for local testing.

Windsurf only processes the exact subscriber email addresses and profile fields you query via the endpoints. The V8 Isolate Sandbox destroys all memory the second the connection drops, meaning your contact lists never persist 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