Enginemailer MCP Server

An MCP server that provides access to Enginemailer's email marketing and transactional email capabilities.

Installation

Quick Start (Recommended)

npx @lightyoruichi/enginemailer-mcp

With Environment Variables

ENGINEMAILER_API_KEY=your-api-key-here npx @lightyoruichi/enginemailer-mcp

Tools Available

📧 Transactional Emails

• send_email - Send transactional emails with attachments, CC/BCC, and substitution tags
• tx_export_report_v2 - Export delivery reports
• tx_check_export_status_v2 - Check export status

👥 Subscriber Management

• subscriber_get - Get subscriber details
• subscriber_insert - Add new subscriber
• subscriber_update - Update subscriber info
• subscriber_unsub - Unsubscribe
• subscriber_activate - Reactivate
• subscriber_get_custom_field - Get available custom fields
• subscriber_get_subcategory - Get categories/subcategories
• subscriber_update_category - Create/update categories

📊 Batch Operations

• batch_update_subscribers - Batch insert/update subscribers
• batch_update_status - Check batch job status

📈 Campaign Management

• campaign_create - Create email campaign
• campaign_update - Update campaign
• campaign_delete - Delete campaign
• campaign_assign_recipients - Assign recipients
• campaign_delete_recipient_list - Remove recipients
• campaign_pause - Pause campaign
• campaign_send - Send campaign
• campaign_schedule - Schedule campaign
• campaign_list - List campaigns
• campaign_analytics_summary - Get campaign analytics
• campaign_analytics_delivery - Get delivery stats

🔧 System

• health - Server health check
• verify_connection - Test API connectivity

Example Queries

• "Send a welcome email to [email protected]"
• "Add a new subscriber with email [email protected] and first name Jane"
• "Create a welcome campaign for new subscribers"
• "Get all subscribers in the growth operator category"
• "Send a transactional email with attachment"
• "Export delivery reports for last month"
• "Update subscriber categories for marketing team"
• "Schedule a campaign for next week"
• "Get campaign analytics for campaign ID 123"

MCP Configuration

For Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "enginemailer": {
      "command": "npx",
      "args": [
        "-y",
        "@lightyoruichi/enginemailer-mcp"
      ],
      "env": {
        "ENGINEMAILER_API_KEY": "your-api-key-here",
        "ENGINEMAILER_API_BASE": "https://api.enginemailer.com/restapi",
        "ENGINEMAILER_HOST": "https://api.enginemailer.com",
        "ENGINEMAILER_TX_SEND_PATH": "/RESTAPI/V2/Submission/SendEmail",
        "ENGINEMAILER_TX_EXPORT_PATH": "/RESTAPI/V2/Submission/Report/Export",
        "ENGINEMAILER_TX_CHECK_EXPORT_PATH": "/RESTAPI/V2/Submission/Report/CheckExport",
        "ENGINEMAILER_BATCH_UPDATE_PATH": "/subscriber/emsubscriber/batchUpdateSubscribers",
        "ENGINEMAILER_BATCH_STATUS_PATH": "/subscriber/emsubscriber/batchUpdateStatus",
        "HTTP_TIMEOUT_MS": "30000"
      }
    }
  }
}

For Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)

{
  "mcpServers": {
    "enginemailer": {
      "command": "npx",
      "args": [
        "-y",
        "@lightyoruichi/enginemailer-mcp"
      ],
      "env": {
        "ENGINEMAILER_API_KEY": "your-api-key-here",
        "ENGINEMAILER_API_BASE": "https://api.enginemailer.com/restapi",
        "ENGINEMAILER_HOST": "https://api.enginemailer.com",
        "ENGINEMAILER_TX_SEND_PATH": "/RESTAPI/V2/Submission/SendEmail",
        "ENGINEMAILER_TX_EXPORT_PATH": "/RESTAPI/V2/Submission/Report/Export",
        "ENGINEMAILER_TX_CHECK_EXPORT_PATH": "/RESTAPI/V2/Submission/Report/CheckExport",
        "ENGINEMAILER_BATCH_UPDATE_PATH": "/subscriber/emsubscriber/batchUpdateSubscribers",
        "ENGINEMAILER_BATCH_STATUS_PATH": "/subscriber/emsubscriber/batchUpdateStatus",
        "HTTP_TIMEOUT_MS": "30000"
      }
    }
  }
}

For Other MCP Clients

{
  "mcpServers": {
    "enginemailer": {
      "command": "npx",
      "args": ["-y", "@lightyoruichi/enginemailer-mcp"],
      "env": {
        "ENGINEMAILER_API_KEY": "your-api-key-here"
      }
    }
  }
}

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | ENGINEMAILER_API_KEY | Your Enginemailer API key | Required | | ENGINEMAILER_API_BASE | API base URL | https://api.enginemailer.com/restapi | | ENGINEMAILER_HOST | API host | https://api.enginemailer.com | | ENGINEMAILER_TX_SEND_PATH | Transactional send endpoint | /RESTAPI/V2/Submission/SendEmail | | ENGINEMAILER_TX_EXPORT_PATH | Export endpoint | /RESTAPI/V2/Submission/Report/Export | | ENGINEMAILER_TX_CHECK_EXPORT_PATH | Export status endpoint | /RESTAPI/V2/Submission/Report/CheckExport | | ENGINEMAILER_BATCH_UPDATE_PATH | Batch update endpoint | /subscriber/emsubscriber/batchUpdateSubscribers | | ENGINEMAILER_BATCH_STATUS_PATH | Batch status endpoint | /subscriber/emsubscriber/batchUpdateStatus | | HTTP_TIMEOUT_MS | HTTP timeout in milliseconds | 30000 |

CLI Usage

# Show help
npx @lightyoruichi/enginemailer-mcp --help

# Show version
npx @lightyoruichi/enginemailer-mcp --version

# Health check
npx @lightyoruichi/enginemailer-mcp --health

# Run with custom API base
ENGINEMAILER_API_BASE=https://api.enginemailer.com/compass/restapi npx @lightyoruichi/enginemailer-mcp

Get Your API Key

Get your API key from: https://portal.enginemailer.com/Account/UserProfile

⚠️ Security Warning: Never expose your API key in client-side code. Use backend services for security. If your key is compromised, regenerate it immediately.

Requirements

• Node.js 18+
• Enginemailer API key
• Verified sender domain for transactional emails
• Paid account required for campaign features, but transactions email works ok.

Development

If you want to contribute or run from source:

# Clone the repository
git clone https://github.com/lightyoruichi/enginemailer-mcp.git
cd enginemailer-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev