campaign_chest

AI Marketing Orchestrator Toolbox — 35 MCP tools for end-to-end campaign automation.

Integrates Hi.Events + Cal.com + Mautic into a single curated toolset designed for LangGraph agents running the deterministic campaign pipeline:

Create Event (Hi.Events) → Publish → Get ticket URL
    → Create Booking Page (Cal.com) → Get booking URL
    → Inject URLs into email templates (Mautic)
    → Create segment + drip campaign → Add contacts

Tool Inventory

Hi.Events: Ticketed Events (11 tools)

Tool	Purpose
hi_events_list_organizers	Get organizer_id before creating events
hi_events_list	Check if event already exists
hi_events_get	Get event details + construct public URL
hi_events_create	Create event as DRAFT
hi_events_update_settings	Set location, timezone, support_email
hi_events_create_ticket	Create ticket type with price + quantity
hi_events_create_capacity	Set total event capacity
hi_events_publish	Publish event LIVE → URL becomes active
hi_events_list_tickets	List ticket types + IDs
hi_events_get_stats	Ticket sales, revenue, attendance rate
hi_events_list_attendees	Who registered (for Mautic contact import)

Cal.com: Consultation Booking (8 tools)

Tool	Purpose
calcom_get_profile	Get username + timezone for URL construction
calcom_list_schedules	Pick schedule when creating event type
calcom_list_event_types	Check existing consultation pages + get URLs
calcom_get_event_type	Get booking URL after creation
calcom_create_event_type	Create consultation booking page
calcom_get_available_slots	Show host availability to agent/user
calcom_create_booking	Programmatically create a booking
calcom_list_bookings	Monitor incoming consultation bookings

Mautic: Email Campaign (16 tools)

Tool	Purpose
mautic_list_contacts	Check who already exists
mautic_get_contact	Verify contact details
mautic_create_contact	Add prospect
mautic_update_contact	Update contact fields
mautic_list_segments	Check existing segments
mautic_create_segment	Create campaign audience
mautic_add_to_segment	Manual add — reliable (filter-based requires cron)
mautic_list_emails	Check existing email templates
mautic_create_email	Create email template with injected URLs
mautic_update_email	Edit email content
mautic_list_campaigns	Check existing campaigns
mautic_create_campaign	Create drip campaign with event timeline
mautic_get_campaign	Verify campaign state + published status
mautic_list_campaign_contacts	Verify contacts entered campaign
mautic_send_email	Direct send fallback (bypasses cron)
mautic_add_to_campaign	Manually push contact into campaign

Installation

cd /Users/ds/my-mcp-servers/campaign_chest
uv pip install -e ".[mcp]"

Environment Variables

Variable	Service	Required
HI_EVENTS_BASE_URL	Hi.Events	Yes
HI_EVENTS_EMAIL	Hi.Events	Yes
HI_EVENTS_PASSWORD	Hi.Events	Yes
CALCOM_BASE_URL	Cal.com	No (default: https://api.cal.com)
CALCOM_API_KEY	Cal.com	Yes
MAUTIC_BASE_URL	Mautic	Yes
MAUTIC_USERNAME	Mautic	Yes
MAUTIC_PASSWORD	Mautic	Yes

Claude Desktop Config

"campaign-chest": {
  "command": "uv",
  "args": ["--directory", "/Users/ds/my-mcp-servers/campaign_chest",
           "run", "--extra", "mcp", "mcp_server.py"],
  "env": {
    "HI_EVENTS_BASE_URL": "https://events.brothersbit.com/api",
    "HI_EVENTS_EMAIL": "...",
    "HI_EVENTS_PASSWORD": "...",
    "CALCOM_BASE_URL": "https://connect-api.marketfier.com",
    "CALCOM_API_KEY": "...",
    "MAUTIC_BASE_URL": "https://marketing.brothersbit.com",
    "MAUTIC_USERNAME": "...",
    "MAUTIC_PASSWORD": "..."
  }
}

Key API Quirks

• Hi.Events: location_details causes 500 on event create — always use update_settings() separately
• Hi.Events: Public ticket URL: {base_url without /api}/event/{id}/{slug}
• Hi.Events: Products are returned via /product-categories (not /products which 500s)
• Cal.com: Slots use start/end params (NOT startTime/endTime)
• Mautic: Campaign triggerMode: "date" causes 500 — use "immediate" or "interval" only
• Mautic: publishUp format: "YYYY-MM-DD HH:MM:SS" (no T, no timezone offset)
• Mautic: Campaign events need BOTH parent field AND canvasSettings.connections
• Mautic: Use manual add_to_segment() — filter-based segments require cron to process
• Mautic: emailType: "transactional" bypasses frequency rules (right for event invitations)