How to Use the Maropost MCP in Windsurf

Q: How does Cascade handle multiple Maropost contact lists?

Cascade uses listlists to fetch your directory, then targets specific ones using listcontactsinlist. You just tell Windsurf which segment you want to analyze, and the agent figures out the required API sequence.

Give Windsurf direct control over your Maropost marketing campaigns and contact lists.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Maropost MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Maropost Campaigns in Windsurf

The `list_campaigns` and `get_campaign_details` tools let Cascade read your active marketing deployments directly from the editor. You don't have to switch tabs to check bounce rates or send volumes. Cascade pulls the raw campaign data, analyzes the metrics, and formats them into whatever local markdown report you need. If you want to dig deeper into performance, Cascade chains that data with `list_reports` and `get_report_details`. You ask for a summary of last week's email blasts, and the agent executes the sequence, fetching the exact IDs and compiling the stats. It handles the pagination and API calls silently.

Manage Contacts and Lists

The `create_contact` tool gives your IDE the ability to add or update subscriber records on the fly. When you test a new signup form locally, Cascade can push the test email straight to Maropost. You skip the manual web dashboard entry entirely. Need to verify list segments? Cascade runs `list_lists` to find the target segment, then follows up with `list_contacts_in_list` to dump the current subscribers. You can also target specific users with `get_contact` to check their exact attribute mapping before writing your frontend integration code.

Inspect Marketing Workflows

The `list_workflows` tool exposes your entire automated journey structure to the agent. Cascade reads the active triggers and branches. This means you can write application logic that perfectly matches the timing of your Maropost drip campaigns. When a specific journey misfires, tell Cascade to run `get_workflow_details`. It grabs the node configuration and outputs the exact steps the workflow takes. You fix the backend event trigger in your code while looking at the actual marketing automation rules.

Setup guide

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

mcp_config.json

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

Open your Windsurf settings and navigate to the Cascade MCP Servers UI. Add the server details there, or edit your ~/.codeium/windsurf/mcp_config.json file directly. Click refresh in the MCP panel to load the tools.

No. The current tools only support reading campaign data via list_campaigns and get_campaign_details. You can manage contacts, but campaign creation still requires the Maropost dashboard.

Cascade uses list_lists to fetch your directory, then targets specific ones using list_contacts_in_list. You just tell Windsurf which segment you want to analyze, and the agent figures out the required API sequence.

The server provides read-only access to workflows. You use list_workflows and get_workflow_details to inspect the logic, but you cannot modify the journey steps through the agent.

This server processes email addresses and subscriber attributes. Vinkius isolates the connection inside a V8 sandbox. The agent reads the memory temporarily during execution, and the container terminates the moment the task finishes. Nothing persists 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