How to Use the Mautic MCP in Windsurf

Q: How do I search Mautic contacts in Windsurf?

Use the listcontacts tool with a search query string. Cascade will parse your request and return the matching records directly in your chat.

Q: Can Windsurf update my Mautic segments automatically?

Yes, you can instruct Cascade to run addcontacttosegment whenever a specific condition is met. It handles the API handshake so you don't have to.

Q: Does Windsurf support listing all Mautic campaigns?

It does. Just ask Cascade to list them, and it triggers listcampaigns to pull the full set of active marketing initiatives for your review.

Automate your Mautic marketing workflows directly inside Windsurf using Cascade to chain complex contact and campaign tasks.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mautic MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage your contacts in Windsurf

Cascade handles lead data without you needing to switch tabs. Use `create_contact` to add new entries or pull specific records with `get_contact` to verify lead status instantly. Windsurf reads your request and runs the sequence. You'll see the data pop up in your chat panel after the agent finishes the call.

Sync Mautic segments and campaigns

Organize your outreach by triggering `add_contact_to_segment` during your coding sessions. It keeps your marketing lists clean while you focus on building features. Running `list_segments` lets Cascade see your current structure. The agent then maps your logic to the correct group without manual intervention.

Access Mautic assets via MCP Server

This MCP Server exposes your email templates and company data to the IDE. Fetch details using `get_email` or `get_company` to keep your project context accurate. Cascade parses the results from `list_emails` and `list_campaigns` to help you draft better copy. It’s all handled through standard API calls in the background.

Setup guide

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

mcp_config.json

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

Use the `list_contacts` tool with a search query string. Cascade will parse your request and return the matching records directly in your chat.

Yes, you can instruct Cascade to run `add_contact_to_segment` whenever a specific condition is met. It handles the API handshake so you don't have to.

Vinkius runs this in an ephemeral V8 sandbox. Your credentials and contact data are never stored permanently, and the connection is scoped strictly to your session.

It does. Just ask Cascade to list them, and it triggers `list_campaigns` to pull the full set of active marketing initiatives for your review.

Open your MCP settings and add the server configuration. Once connected, Cascade auto-discovers the tools and is ready to work immediately.

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