Mautic MCP Server

A comprehensive Model Context Protocol (MCP) server for Mautic 7 (Columba Edition) marketing automation platform. Supports both v1 (FOSRestBundle) and v2 (API Platform) endpoints with 68 tools.

Quick Start

# Clone and setup
git clone https://github.com/Cbrown35/mantic-MCP.git
cd mantic-MCP
npm install

# Configure your Mautic credentials
cp .env.example .env
# Edit .env with your Mautic API credentials

# Build and run
npm run build

Then add the server to your MCP configuration and start using natural language commands like:

• “Search for all contacts with gmail in their email”
• “Create a new project to organize my Q1 campaign resources”
• “Clone campaign 5 and export it for staging”
• “Send email template 12 to its assigned segment”

What’s New in v2.0 (Mautic 7 Support)

Projects (API v2)

Organize marketing resources under a single logical structure using Mautic 7’s new API Platform v2 endpoints.

• list_projects, get_project, create_project, update_project, patch_project, delete_project

Campaign Import/Export

Move complete campaign setups between environments.

• clone_campaign - Clone an existing campaign
• export_campaign - Export campaign data with all related assets
• import_campaign - Import a campaign from JSON data

Campaign Analytics

• get_campaign_event_details - Detailed metrics for campaign events
• get_campaign_graph_stats - Campaign graph statistics for date ranges
• get_campaign_map_stats - Geographic map statistics

Segment-Based Email Sending

• send_email_to_segment - Send email to assigned segments with real-time audience adaptation

Email Reply Tracking

• record_email_reply - Record email replies by tracking hash
• get_email_graph_stats - Email graph statistics for date ranges

Deprecation Notice

SMS API classes have been removed in Mautic 7. The list_sms and create_sms tools include deprecation warnings.

Features

Authentication

• OAuth2 authentication with automatic token refresh
• Secure credential management through environment variables
• Dual API support: v1 (FOSRestBundle) and v2 (API Platform)

Contact Management (6 tools)

• create_contact - Create new contacts with custom fields
• update_contact - Update existing contact information
• get_contact - Retrieve contact details by ID or email
• search_contacts - Search contacts with filters and pagination
• delete_contact - Remove contacts from Mautic
• add_contact_to_segment - Add contacts to specific segments