# Klaviyo Marketing Automation MCP

> Klaviyo (Marketing Automation) lets your AI agent take full control of your B2C e-commerce marketing. Access customer profiles, track campaign performance, and audit complex automation flows—all through natural conversation. Manage everything from segmenting audiences to ensuring every welcome series step is firing correctly.

## Overview
- **Category:** growth-engine
- **Price:** Free
- **Tags:** b2c-crm, personalized-marketing, sms-marketing, customer-profiles, automation-flows, e-commerce-marketing

## Description

Need to manage an e-commerce CRM without jumping between a dozen dashboards? This MCP connects your AI agent directly into Klaviyo's core systems for customer data and marketing automation. You stop searching and start asking. Your agent can retrieve detailed customer profiles, pulling everything from basic contact info to custom behavioral properties and predictive metrics like churn risk. Need an update? Simply ask the agent to add existing users to specific lists or check which automated sequences are running. If you're managing growth campaigns across multiple accounts, Vinkius makes connecting your AI client easy, giving you one place to manage all this data.

It’s about asking questions like: 'Show me the performance for the last three email campaigns targeting high-value customers,' or 'What are the current triggers and steps in my abandoned cart flow?' You get instant answers and actionable insights without writing a single API call.

## Tools

### get_flow_details
Details the operational mechanics of an automation flow, including entry triggers and every subsequent action step (emails, delays).

### list_audience_segments
Lists dynamic audience segments that automatically update based on user behavior and predictive data.

### list_profiles
Retrieves a list of existing Klaviyo contacts, providing their profile IDs, email addresses, and names to start an audit.

### create_profile
Adds a brand new customer record to Klaviyo using an email address; name fields are optional but helpful for personalization.

### list_lists
Shows all existing audience lists, including their IDs and the total number of contacts in each list.

### add_profiles_to_list
Moves specific user profiles into a defined marketing list for targeted messaging campaigns.

### list_email_campaigns
Provides an overview of current and past email campaigns, including their IDs and scheduled send dates.

### get_campaign_details
Retrieves the full status, target audience IDs, and content details for any specified campaign.

### list_automation_flows
Lists all automated sequences—like welcome series or cart abandonment—along with their active status.

### get_profile
Pulls all data for a single user ID, including contact details, custom properties, and predictive metrics like CLV.

## Prompt Examples

**Prompt:** 
```
List all active email campaigns in my Klaviyo account
```

**Response:** 
```
I've found 3 active campaigns: 'Spring Sale 2024' (ID: camp-123), 'Monthly Newsletter' (ID: camp-456), and 'Product Reveal' (ID: camp-789). Would you like to see the targeted audience or performance metrics for any of these?
```

**Prompt:** 
```
Show me the details for automation flow ID 'flow-987'
```

**Response:** 
```
Retrieving flow 'flow-987' ('Welcome Series')… It is currently ACTIVE. The trigger is 'When someone joins Newsletter'. The sequence includes 3 emails sent over 7 days. Current completion rate is 84%. Would you like to see the individual step details?
```

**Prompt:** 
```
Create a profile for 'Sarah Doe' with email 'sarah@example.com'
```

**Response:** 
```
Profile for Sarah Doe (sarah@example.com) created successfully. ID: prof-012345. I can now add her to your 'New Customers' list or update her profile with custom behavioral properties. What would you like to do next?
```

## Capabilities

### Get detailed customer profiles
Retrieve full contact information, custom properties, and predictive analytics for any user ID.

### Audit marketing campaigns
List all active email broadcasts, check their current status, and see details about who they target.

### Monitor automation flows
Examine automated sequences like welcome or abandoned cart series to verify triggers, steps, and operational status.

### Manage customer lists and segments
Identify target audience groups and add specific user profiles to defined marketing lists.

### Create new user records
Manually insert leads or synchronize data from other sources into a new profile.

## Use Cases

### Auditing an abandoned cart sequence
A marketer asks the agent: 'Check my abandoned cart flow.' The agent uses 'list_automation_flows' to confirm its status, then runs 'get_flow_details' to verify the trigger and action steps. They instantly know if the email delay is set correctly, saving hours of manual troubleshooting.

### Identifying high-value customers for a pitch
A growth engineer needs to find users who spent over $500 in Q2. The agent runs 'list_audience_segments' and filters based on custom properties, pulling the required list of IDs that can then be used with 'add_profiles_to_list'.

### Onboarding a new data source
A business owner gets a spreadsheet of new leads. Instead of manually entering them, they prompt the agent to use 'create_profile' for each email address, instantly syncing hundreds of records into Klaviyo.

### Checking campaign readiness before launch
Before sending a major announcement, the marketer asks: 'What are the details and target audience for the Q3 product reveal?' The agent uses 'list_email_campaigns' then 'get_campaign_details', providing confirmation on status and scope.

## Benefits

- Audit automation flows instantly: Instead of manually navigating the flow builder to check if a Welcome Series is running correctly, just ask your agent using 'list_automation_flows' and then 'get_flow_details'.
- Segment customers accurately: Use 'list_audience_segments' to find high-value cohorts based on actual behavior, letting you target groups far beyond simple demographics.
- Control user data flow: Need to update a lead? You can use 'create_profile' or 'get_profile' to pull and push specific behavioral traits for personalization.
- Execute targeted list management: Don't just create segments; use 'add_profiles_to_list' to immediately group users into defined marketing lists, ready for the next send.
- Gain campaign visibility: Quickly check if a planned broadcast is live or scheduled by listing campaigns with 'list_email_campaigns', eliminating manual dashboard checks.

## How It Works

The bottom line is that you talk to your agent like talking to a marketing analyst who has full read/write access to Klaviyo's backend.

1. Subscribe to this MCP and enter your Klaviyo Private API Key.
2. Select any compatible client, like Cursor or Claude, and activate the connector in your agent's settings.
3. Ask your AI client a natural language question, such as 'List all active email campaigns,' and let the agent execute the necessary data retrieval.

## Frequently Asked Questions

**How do I find my customer ID using the Klaviyo (Marketing Automation) MCP?**
You start by running 'list_profiles'. This tool retrieves a list of contacts, giving you their IDs and basic info. Use one of those returned IDs in the 'get_profile' tool to pull all associated data.

**Can I use Klaviyo (Marketing Automation) MCP to update user details?**
Yes, if you have a new lead or need to synchronize external data, you can use 'create_profile'. This adds the record and ensures all your marketing tools see the updated information.

**What is the difference between list_lists and list_audience_segments?**
Lists are static groupings you manage manually. Segments, accessed via 'list_audience_segments', update automatically based on real-time user behavior data, making them much more dynamic for marketing.

**Does the Klaviyo (Marketing Automation) MCP track campaign performance?**
Yes. You can use 'list_email_campaigns' to see what campaigns are active and then 'get_campaign_details' to retrieve metrics, status, and targeted audience information.

**If I run a new campaign, how do I make sure the right people get it?**
First, use 'list_audience_segments' to define your target group. Then, you can ensure those specific users are included in the mailing by using 'add_profiles_to_list'.

**Can I check the status of an automation flow using my agent?**
Yes. Use the `get_flow_details` tool with a specific Flow ID. Your agent will retrieve the comprehensive status, including entry triggers and the sequence of action steps, allowing you to audit your lifecycle marketing in real-time.

**How do I create a new customer profile through a conversation?**
Use the `create_profile` tool by providing the email address, first name, and last name. Your agent will generate the new contact profile in Klaviyo, ready for segmentation or being added to specific marketing lists.

**Can my agent list all dynamically updated audience segments?**
Absolutely. Use the `list_audience_segments` tool to retrieve all dynamic segments from your Klaviyo account. These segments update automatically based on user behavior and analytics conditions, and your agent can report on their status directly in your chat.