Mautic 7 (Columba Edition) 마케팅 자동화 플랫폼을위한 포괄적 인 모델 Context Protocol (MCP) 서버. 모두 지원 v1 (FOSRestBundle) 및 v2 (API 플랫폼) 엔드 포인트 68 도구.

빠른 시작

그런 다음 MCP 구성에 서버를 추가하고 같은 자연 언어 명령을 사용하여 시작하십시오.

• “이메일에서 gmail로 모든 연락처 검색”
• “Q1 캠페인 리소스를 구성하는 새로운 프로젝트”
• “Clone Campaign 5 및 노후화에 대한 수출”
• “이메일 템플릿 12을 할당 된 세그먼트에 보내십시오”

v2.0에서 새로운 기능 (Mautic 7 지원)

프로젝트 (API v2)

Mautic 7의 새로운 API 플랫폼 v2 엔드포인트를 사용하여 단일 논리 구조 아래 마케팅 리소스를 구성합니다.

• list projects, get project, create project, update project, patch project, delete 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