mcpengine/servers/klaviyo/README.md

Klaviyo MCP Server

Complete Klaviyo Model Context Protocol server with 60+ tools and 16 production-ready apps.

Features

Tools (60+)

• Profiles: Create, update, subscribe, unsubscribe, suppress
• Lists: Create, update, delete, manage profiles
• Segments: View, update, get profiles and tags
• Campaigns: Create, update, send, clone, manage messages
• Flows: Create, update, manage actions and messages
• Templates: Create, update, clone, delete
• Metrics: Query aggregate data
• Events: Track events, get related data
• Catalogs: Manage items and variants
• Forms: View forms
• Tags: Create, update, delete, tag campaigns/flows
• Reporting: Campaign and flow analytics

Apps (16)

1. Profile Manager - Manage customer profiles and subscriptions
2. List Builder - Create and manage email lists
3. Segment Viewer - View and analyze customer segments
4. Campaign Dashboard - Monitor and manage campaigns
5. Flow Designer - Create and manage automated flows
6. Template Gallery - Browse and manage email templates
7. Metrics Dashboard - Track key performance metrics
8. Event Feed - Real-time customer event tracking
9. Catalog Browser - Browse and manage product catalog
10. Form Manager - Manage signup forms and popups
11. Tag Organizer - Organize campaigns and flows with tags
12. Email Analytics - Track email performance metrics
13. Revenue Dashboard - Track revenue and sales performance
14. A/B Test Viewer - Analyze campaign A/B test results
15. Audience Builder - Build targeted audiences
16. Integration Status - Monitor integration health and data sync

Installation

npm install

Configuration

Set your Klaviyo API key:

export KLAVIYO_API_KEY=your_api_key_here

Usage

As MCP Server

npm run build
node dist/index.js

Development

npm run dev

Type Check

npm run typecheck

API

All tools follow Klaviyo's JSON:API format with:

• Bearer token authentication
• API revision: 2024-02-15
• Rate limit: 75 requests/second (automatic throttling)
• Cursor-based pagination

Architecture

• Client: Axios-based client with rate limiting and error handling
• Types: Full TypeScript definitions for all Klaviyo resources
• Tools: 12 tool modules covering all major Klaviyo APIs
• Apps: 16 React apps with ErrorBoundary, Suspense, dark theme, responsive design
• UI Components: Shared components (Toast, LoadingSkeleton, hooks)

License

MIT