How to Use the ActiveCampaign MCP in Windsurf

Q: How does Cascade handle missing contact information?

If you run createcontact and only have an email address, Cascade will execute the tool since email is the only strictly required field. It will then scan your workspace to see if it can find names or phone numbers to fill in the rest.

Trigger Cascade to run multi-step marketing workflows and sync sales pipelines directly inside Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ActiveCampaign MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Windsurf and Cascade automate ActiveCampaign list building

Cascade doesn't just write code; it handles your marketing operations directly. When you ask Windsurf to import a batch of users, it spins up `create_contact` to add them to your database, then chains `add_contact_to_list` to put them in the right segment. You don't have to prompt it for every single step. The agent reads the context of your workspace, detects new signups from your local database, and pushes them straight to your lists. This MCP connection lets Windsurf run these multi-step campaigns without requiring your constant attention.

Tag profiles and update sales pipelines instantly

Keeping your CRM updated used to mean clicking through dozens of web forms. Now, this MCP Server lets you run `add_tag_to_contact` to trigger your automated email sequences based on user actions. It can even check your active sales pipeline using `list_deals` to make sure your sales team is looking at accurate data. If a deal closes, Cascade spots the change in your local files and runs the necessary updates. It bridges the gap between your local codebase and your live marketing stack.

Audit your contacts directly from Windsurf

Finding a specific record shouldn't require opening a browser tab. Cascade uses `list_contacts` to search your database by email, pulling up full profiles right inside your workspace. Once it finds the contact, the agent can immediately modify their status or add them to new lists based on your instructions. It makes your marketing database feel like a local file system.

Setup guide

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

mcp_config.json

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

Open your Settings, navigate to Cascade, and add the server under the MCP Servers UI. Alternatively, you can paste the Vinkius endpoint directly into your `~/.codeium/windsurf/mcp_config.json` file. Windsurf also supports one-click installs through its built-in marketplace.

Yes, Cascade is built to chain actions autonomously. If you ask it to sync a new user, it will create the profile and add them to a list in one go. It uses tools like `create_contact` and `add_contact_to_list` sequentially without waiting for your approval.

Not at all. The server runs in a secure, sandboxed V8 isolate hosted by Vinkius, offloading the execution. Windsurf only receives the clean JSON payload back, keeping Cascade fast and responsive.

If you run `create_contact` and only have an email address, Cascade will execute the tool since email is the only strictly required field. It will then scan your workspace to see if it can find names or phone numbers to fill in the rest.

Your marketing contacts, tags, and sales deal pipelines are protected by Vinkius's zero-trust architecture. Connection credentials never touch your local machine, and the ephemeral sandbox destroys session data the moment the tool execution finishes.

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