Mautic 7(Columba Edition)マーケティングオートメーションプラットフォーム用の包括的なモデルコンテキストプロトコル(MCP)サーバー。 v1(FOSRestBundle)とv2(APIプラットフォーム)のエンドポイントを68ツールでサポートします。

クイックスタート

その後、サーバーをMCP設定に追加し、以下のような自然言語コマンドを使い始めます。

• 「メール内のすべての連絡先を検索」
• 「Q1キャンペーンリソースを整理するための新しいプロジェクトを作成」
• 「キャンペーン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