一个全面的模型上下文协议（MCP）服务器，适用于 Mautic 7（Columba 版）营销自动化平台。支持 v1（FOSRestBundle）和 v2（API 平台）端点，配备 68 个工具。

快速启动

然后把服务器添加到你的MCP配置中，开始使用自然语言命令，比如：

• “搜索所有电子邮件中使用 Gmail 的联系人”
• “创建一个新项目来组织我的第一季度活动资源”
• “克隆战役5并导出用于分阶段”
• “发送邮件模板12至其指定段”

v2.0（Mautic 7 支持）有什么新内容

项目（API v2）

利用 Mautic 7 的新 API 平台 v2 端点，将营销资源组织在单一逻辑结构下。

• list_projects，get_project，create_project，update_project，patch_project，delete_project

战役进出口

将完整的战役设置在不同环境中移动。

• clone_campaign - 克隆现有战役
• export_campaign - 导出包含所有相关资源的活动数据
• import_campaign - 从 JSON 数据导入广告活动

竞选分析

• get_campaign_event_details - 活动活动的详细指标

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