Klaviyo MCP Server 4 15

🚀 Klaviyo API MCP Server

A comprehensive Model Context Protocol (MCP) server for interacting with Klaviyo's API. This server provides tools and resources for managing profiles, lists, events, campaigns, flows, templates, segments, metrics, catalogs, and data privacy.

🚀 Quick Start

This MCP server offers a wide - range of tools to interact with Klaviyo's API. You can manage various aspects of your Klaviyo account with ease.

✨ Features

• Comprehensive coverage of Klaviyo's API capabilities.
• Structured tools with proper validation using Zod.
• API reference documentation resources.
• Error handling and logging.

📦 Installation

1. Clone this repository.
2. Install the dependencies:

   npm install
   

3. Create a .env file containing your Klaviyo API key:

   KLAVIYO_API_KEY=your_private_api_key_here
   

4. Start the server:

   npm run dev
   

💻 Usage Examples

Basic Usage

You can test the server using the MCP Monitor:

npm run inspect

This will open a web interface that allows you to:

• View available tools and resources.
• Test tools with different inputs.
• View server logs and responses.

Available Tools

Profiles

• get_profiles: Get a list of profiles, with optional filtering.
• get_profile: Get a specific profile by ID.
• create_profile: Create a new profile.
• update_profile: Update an existing profile.
• delete_profile: Delete a profile.

Lists

• get_lists: Get all lists.
• get_list: Get a specific list by ID.
• create_list: Create a new list.
• update_list: Update an existing list.
• delete_list: Delete a list.
• get_list_profiles: Get profiles in a list.
• add_profiles_to_list: Add profiles to a list.
• remove_profiles_from_list: Remove profiles from a list.

Events

• get_events: Get a list of events, with optional filtering.
• get_event: Get a specific event by ID.
• create_event: Create a new event.

Campaigns

• get_campaigns: Get a list of campaigns, with optional filtering.
• get_campaign: Get a specific campaign by ID.
• create_campaign: Create a new campaign.
• update_campaign: Update an existing campaign.
• delete_campaign: Delete a campaign.

Flows

• get_flows: Get all flows.
• get_flow: Get a specific flow by ID.
• create_flow: Create a new flow.
• update_flow: Update an existing flow.
• delete_flow: Delete a flow.

Templates

• get_templates: Get all templates.
• get_template: Get a specific template by ID.
• create_template: Create a new template.
• update_template: Update an existing template.
• delete_template: Delete a template.

Segments

• get_segments: Get all segments.
• get_segment: Get a specific segment by ID.
• create_segment: Create a new segment.
• update_segment: Update an existing segment.
• delete_segment: Delete a segment.

Metrics

• get_metrics: Get a list of metrics.
• get_metric: Get a specific metric by ID.
• create_metric: Create a new metric.
• update_metric: Update an existing metric.
• delete_metric: Delete a metric.

Catalogs

• get_directories: Get all catalogs.
• get_directory: Get a specific catalog by ID.
• create_directory: Create a new catalog.
• update_directory: Update an existing catalog.
• delete_directory: Delete a catalog.

📚 Documentation

• Documentation path: Provides detailed API references and usage instructions.