Ecomail MCP Server

A Model Context Protocol (MCP) server for Ecomail — the email marketing platform. Manage lists, subscribers, campaigns, automations, transactional emails, e-commerce transactions, templates, domains, and more — directly from any MCP client like Claude Desktop, Cursor, or Claude Code.

Features

• Lists — View, create, update lists. Get subscribers, subscribe/unsubscribe, bulk subscribe, manage segments.
• Subscribers — Get subscriber details globally, delete subscribers, search contacts across all lists.
• Campaigns — List, create, update, send campaigns. Get aggregate and per-subscriber stats, segment stats.
• Automations — List automations, trigger for subscribers, get aggregate and detailed stats.
• Transactional Emails — Send transactional emails with custom content or templates. View stats and double opt-in stats.
• Transactions — Create, update, delete e-commerce transactions. Bulk create/delete. Get paginated transactions.
• Templates — Create and retrieve email templates.
• Domains — List, create, and delete sending domains.
• Feeds — Refresh product and data feeds.
• Tracker Events — Track custom subscriber events server-side.
• Discount Coupons — Import and delete coupon codes.
• Webhooks — Set, get, and delete webhook URL for campaign stats.

Setup

1. Log in to your Ecomail account
2. Go to Manage your account > For developers
3. Click Copy API Key

Usage

Claude Code

claude mcp add ecomail -e ECOMAIL_API_KEY=your_api_key -- npx -y ecomail-mcp

Cursor

Open the command palette and choose "Cursor Settings" > "MCP" > "Add new global MCP server".

{
  "mcpServers": {
    "ecomail": {
      "command": "npx",
      "args": ["-y", "ecomail-mcp"],
      "env": {
        "ECOMAIL_API_KEY": "your_api_key"
      }
    }
  }
}

Claude Desktop

Open Claude Desktop settings > "Developer" tab > "Edit Config".

{
  "mcpServers": {
    "ecomail": {
      "command": "npx",
      "args": ["-y", "ecomail-mcp"],
      "env": {
        "ECOMAIL_API_KEY": "your_api_key"
      }
    }
  }
}

Options

• --key: Your Ecomail API key (alternative to ECOMAIL_API_KEY env var)

Environment variables:

• ECOMAIL_API_KEY: Your Ecomail API key (required)

Available Tools

Lists

Tool	Description
list-lists	View all subscriber lists
create-list	Create a new subscriber list
get-list	Show list detail with custom fields, groups, segments, and subscriber counts
update-list	Update an existing list
get-subscribers	Get paginated subscribers from a list
get-subscriber-from-list	Get a subscriber by email from a list
get-subscriber-by-phone	Get a subscriber by phone from a list
subscribe	Add a new subscriber to a list
subscribe-bulk	Add up to 3000 subscribers at once
unsubscribe	Unsubscribe from a list
update-subscriber	Update subscriber data in a list
get-segments	Get all segments for a list

Subscribers

Tool	Description
get-subscriber	Get subscriber details globally across all lists
delete-subscriber	Permanently delete a subscriber
find-contact	Search for a subscriber by email across the account

Campaigns

Tool	Description
list-campaigns	List campaigns with filtering
create-campaign	Create a new campaign (draft)
get-campaign	Get campaign detail with stats
update-campaign	Update a draft campaign
send-campaign	Queue campaign for immediate sending
get-campaign-stats	Get aggregate campaign statistics
get-campaign-stats-detail	Get per-subscriber campaign statistics
get-segment-stats	Get segment performance across campaigns

Automations

Tool	Description
list-automations	List all automations
trigger-automation	Trigger automation for a subscriber
get-automation-stats	Get aggregate automation statistics
get-automation-stats-detail	Get per-subscriber automation statistics
get-automation-stats-emails	Get stats for specific emails in an automation

Transactional Emails

Tool	Description
send-transactional-email	Send transactional email with custom content
send-transactional-template	Send transactional email using a template
get-transactional-stats	Get transactional email stats (6 months)
get-doi-stats	Get double opt-in email stats (6 months)

Transactions

Tool	Description
create-transaction	Create an e-commerce transaction
create-bulk-transactions	Create up to 1000 transactions at once
get-transactions	Get paginated transactions with filters
update-transaction	Overwrite an existing transaction
delete-transaction	Delete a transaction by order ID
delete-bulk-transactions	Delete up to 1000 transactions at once

Templates

Tool	Description
create-template	Create a new email template
get-template	Get template by ID with HTML content

Domains

Tool	Description
list-domains	List all domains
create-domain	Add a new domain
delete-domain	Remove a domain

Feeds

Tool	Description
refresh-product-feed	Trigger product feed refresh
refresh-data-feed	Trigger data feed refresh

Tracker Events

Tool	Description
create-event	Track a custom event for a subscriber

Discount Coupons

Tool	Description
import-coupons	Import coupon codes
delete-coupons	Delete coupon codes

Webhooks

Tool	Description
set-webhook-url	Set webhook URL for campaign stats
get-webhook-url	Get current webhook URL
delete-webhook-url	Remove webhook URL

Local Development

1. Clone and build:

git clone <repo-url>
cd ecomail-mcp
pnpm install
pnpm run build

2. Use the local build in your MCP client:

{
  "mcpServers": {
    "ecomail": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_PROJECT/dist/index.js"],
      "env": {
        "ECOMAIL_API_KEY": "your_api_key"
      }
    }
  }
}

Testing with MCP Inspector

1. Set your API key:

   export ECOMAIL_API_KEY=your_key_here

2. Start the inspector:

   pnpm inspector

3. In the browser (Inspector UI):

   • Choose stdio (launch a process).
   • Command: node
   • Args: dist/index.js
   • Env: ECOMAIL_API_KEY=your_key_here
   • Click Connect, then use "List tools" to verify the server is working.

Resources

• Ecomail
• API Documentation

License

MIT