How to Use the Klaviyo (Marketing Automation) MCP in Windsurf

Chain Klaviyo automation audits and subscriber syncs autonomously inside Windsurf using Cascade.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Klaviyo (Marketing Automation) MCP to Windsurf

Create your Vinkius account to connect Klaviyo (Marketing Automation) 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 Klaviyo (Marketing Automation) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Let Cascade chain your Klaviyo audience audits

Give Windsurf a high-level goal like finding inactive subscribers, and Cascade will chain `list_profiles` and `list_audience_segments` without asking for your permission at every step. It queries your active segments and pulls contact details to build a clear picture of your audience health. You don't need to write manual scripts or prompt Windsurf for every single Klaviyo API call. Cascade processes the segment lists, identifies inactive contacts, and formats the data into your workspace.

Automate list syncing via this MCP Server

Keep your Klaviyo subscription groups updated by letting Cascade handle manual lead insertions directly from your codebase using the `create_profile` tool. The agent reads incoming user data from your local files, then calls the API to register them. Once the profile exists, Cascade automatically triggers `add_profiles_to_list` to place those new signups into the correct marketing funnel. It does all of this in one continuous execution loop inside your Windsurf editor.

Verify Klaviyo campaign statuses and flow logic

Stop jumping back and forth to the web browser to check on your Klaviyo lifecycle marketing when Windsurf can inspect your setup using `list_automation_flows`. Ask Windsurf to inspect your setup, and Cascade uses the tool to verify that your abandoned cart sequences are active. The agent also runs `list_email_campaigns` and `get_campaign_details` to pull current email content and target lists. It gives you raw, immediate visibility into your active Klaviyo broadcasts directly alongside your application code in Windsurf.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "klaviyo-marketing-automation-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 Klaviyo. 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 Klaviyo (Marketing Automation) 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 Klaviyo (Marketing Automation) MCP in Windsurf

Open your Windsurf settings and navigate to Cascade MCP Servers, or edit `~/.codeium/windsurf/mcp_config.json` directly. Add the server under the `mcpServers` key, then click refresh in the MCP panel to let Cascade auto-discover the ten available tools.

Yes, Cascade is built to chain these tools autonomously. You can ask it to find a contact and add them to a list, and it will run the search and update in one continuous process.

Windsurf executes each step of its plan sequentially, which naturally spaces out the requests. If you run into rate limits during heavy list updates, Cascade reads the API error response and pauses before retrying.

No, you do not need to write any code. You simply tell Cascade what marketing data you need to inspect or update, and it handles the underlying tool execution for you.

Your customer profiles, emails, and phone numbers are processed locally within Windsurf's secure V8 isolate sandbox. No customer contact data is stored on Vinkius servers or shared with external parties.

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