ecomail-public-mcp

MCPAI代理

提供方 Ecomailcz · 包名 ecomail-mcp

AI代理 stdio · 本地进程 API Key 社区 / 第三方 Claude DesktopClaudeCursor
查看接入方式

Ecomail MCP Server is a server that brings Ecomail email marketing platform capabilities to MCP clients via the Model Context Protocol, enabling management of subscriber lists, subscribers, campaigns, automations, transactional emails, e-commerce transactions, templates, domains, and more for developers using Claude Desktop, Cursor, and other MCP clients.

一句话选型结论

按资料字段整理

ecomail-public-mcp 属于AI代理类 MCP 服务器,stdio · 本地进程,API Key,可直接接入 Claude Desktop、Claude、Cursor,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权API Key 部署方式本地部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

Local Deployment Email Marketing MCP Server TypeScript Subscriber Management Campaign Management Marketing Automation Transactional Email E-commerce Transactions Email Templates

支持客户端

适用场景

Local DeploymentEmail MarketingMCP Server

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
npx -y ecomail-mcp

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 node,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
ecomail-public-mcp当前 未标注 stdio · 本地进程 本地部署 有 2026-02-23
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Ecomailcz上游标注的维护方 Ecomailcz
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时ecomail-mcp · node本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-02-23上游最后核验时间

详细介绍

6.8 KB
来自项目仓库与上游目录的原文,未做删改

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```bash

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".```json
{
  "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".```json
{
"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:```bash
git clone <repo-url>
cd ecomail-mcp
pnpm install
pnpm run build
  1. Use the local build in your MCP client:json { "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:bash export ECOMAIL_API_KEY=your_key_here

  2. Start the inspector:bash 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

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
ecomail-public-mcp 怎么安装?

在客户端按下面的安装命令接入:npx -y ecomail-mcp。对应的包名是 ecomail-mcp。装完在客户端配置里引用同一个包或端点。

ecomail-public-mcp 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

ecomail-public-mcp 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

ecomail-public-mcp 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

ecomail-public-mcp 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

ecomail-public-mcp 能提供哪些能力?

资料显示能力标签包括 Local Deployment、Email Marketing、MCP Server、TypeScript、Subscriber Management、Campaign Management。具体工具清单以官方文档为准。

ecomail-public-mcp 需要什么运行环境?

运行时为 node;属于本地进程,需要在本机装好运行环境。

ecomail-public-mcp 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-02-23。