MisarMail MCP Server

MisarMail MCP 服务

通过任意 AI 助手发送邮件、运行营销活动、管理联系人和自动化流程、进行 A/B 测试并审查送达情况。

55 个工具 · 8 个提示词 · 4 个资源 · 8 个 Agent 技能

支持 Claude（Desktop、Code 和 Web）、Cursor、VS Code、Windsurf、Cline、 Zed、Gemini CLI、ChatGPT 以及任何其他兼容 MCP 的客户端，可通过标准输入/输出或 Streamable HTTP 连接。

---

安装

Smithery（推荐）

npx -y @smithery/cli install misar/misarmail-mcp --client claude

Claude Code

claude mcp add misarmail -- npx -y @misarmail/mcp@latest

手动安装（任意客户端）

{
  "mcpServers": {
    "misarmail": {
      "command": "npx",
      "args": ["-y", "@misarmail/mcp@latest"],
      "env": { "MISARMAIL_API_KEY": "msk_your_key_here" }
    }
  }
}

每种客户端的现成配置都在 connectors/ 中。

远程连接（无需安装）

{
  "mcpServers": {
    "misarmail": {
      "type": "streamable-http",
      "url": "https://api.misar.io/mail/mcp",
      "headers": { "Authorization": "Bearer msk_your_key_here" }
    }
  }
}

---

身份验证

有两种方式——第一种无需复制粘贴：

1. 浏览器登录。 不提供密钥启动服务，然后运行 login 工具。 它会打开 MisarMail 授权页面，你可以查看请求的 权限，密钥随后会直接返回并保存到 ~/.misarmail/config.json。
2. API 密钥。 在 https://mail.misar.io/developers 创建密钥，并设置 MISARMAIL_API_KEY。

自托管实例：设置 MISARMAIL_BASE_URL。

---

工具

工具	描述
send_email	从经过验证的 MisarMail 账户发送事务性邮件。
list_emails	列出邮箱文件夹中的邮件，可选择按主题和正文进行全文搜索。
get_email	按 ID 读取单封邮件的完整内容，包括邮件头、正文和附件元数据。
reply_to_email	回复现有邮件会话。
archive_email	将邮件移至存档文件夹。
validate_email	发送前验证电子邮件地址：检查语法、MX 记录，并检测一次性邮箱域名和角色账户。
list_campaigns	列出电子邮件营销活动及其状态、受众规模和关键指标。
get_campaign	获取单个营销活动的完整详情：内容、受众细分、计划安排和投递统计数据（已发送、已打开、已点击、退信、投诉）。
create_campaign	创建新的电子邮件营销活动草稿。
send_campaign	立即发送营销活动，或通过传入 scheduled_at 将其安排在未来时间发送。
list_contacts	列出联系人及其订阅状态和互动指标。
create_contact	添加单个联系人。
update_contact	按电子邮件地址更新现有联系人，包括更改订阅状态。
import_contacts	一次调用批量导入最多 5,000 个联系人。
get_contact_score	获取单个联系人的互动评分、互动等级和流失风险；若省略 contact_id，则获取列表中互动度最低的联系人。
list_templates	列出已保存的电子邮件模板及其变量占位符，方便你为营销活动或事务性邮件选择模板。
create_template	创建可重复使用的电子邮件模板。
render_template	使用示例变量渲染模板，并返回生成的 HTML 和主题。
list_automations	列出自动化工作流（欢迎系列、重新互动、滴灌序列）及其触发类型和启用状态。
get_automation	获取单个自动化工作流的完整信息：触发条件、每个步骤及其延迟时间，以及每个步骤的完成统计数据。
create_automation	根据触发条件创建自动化工作流，并保存为已暂停的草稿。
toggle_automation	启用或暂停自动化。
list_ab_tests	列出 A/B 测试及各变体的结果，以及是否已选出获胜者。
create_ab_test	为营销活动创建一个 A/B 测试变体。
select_ab_test_winner	选出获胜变体，并将其发送给剩余受众。
get_analytics	获取账户或单个营销活动的投递和互动分析数据——已发送、已投递、已打开、已点击、退信和投诉，并按天、周或月分组。
get_analytics_timeline	获取按天、周或月划分的已发送、已投递、已打开、已点击、退信、投诉、回复和退订数据，涵盖所有发送渠道（营销活动、收件箱撰写、API、MCP、SDK、GraphQL、自动化）。
generate_report	生成指定日期范围内的结构化分析报告。
get_revenue_attribution	将电商收入归因于电子邮件——按营销活动、按联系人统计的收入，以及基于跟踪转化计算的平均订单价值。
get_monetization_stats	获取时事通讯变现统计数据：统计周期内的付费订阅者、MRR、流失率和赞助收入。
get_deliverability_score	获取账户的邮件送达评分（0–100）和字母等级（A–F），以及导致评分下降的因素。
run_deliverability_audit	对身份验证（SPF/DKIM/DMARC）、域名信誉、列表卫生、内容信号和封锁名单状态进行全面的邮件送达审计。
get_warmup_status	获取 IP/域名预热进度以及今天剩余的发送容量。
check_dmarc	检查域名的实时 SPF、DKIM 和 DMARC DNS 记录，并报告对齐问题及需要发布的确切记录。
list_domains	列出发送域名及其验证状态和 DKIM/SPF/DMARC 记录。
add_domain	添加发送域名，并返回需要发布的 DNS 记录。
verify_domain	重新检查域名的 DNS 记录，并在解析成功时将其标记为已验证。
configure_inbound_domain	为子域名配置入站邮件路由，使回复进入 MisarMail 统一收件箱。
list_forms	列出注册表单及其嵌入状态和转化次数。
get_form	获取单个注册表单，包括其字段、嵌入代码和重定向行为。
get_form_submissions	列出注册表单的提交记录，包括已提交的字段值和时间戳。
create_landing_page	创建托管落地页，包含一个主视觉区块（标题、副标题、CTA）。
list_marketplace_items	浏览 MisarMail 模板市场中的现成电子邮件和自动化模板。
get_marketplace_item	获取单个市场商品的完整预览、作者和安装次数。
list_inbox_conversations	列出统一收件箱中的会话（邮件线程）及其状态和检测到的意图。
get_inbox_conversation_messages	获取单个收件箱会话中的所有邮件，按时间从早到晚排列，并包含发件人和时间戳。
categorize_inbox_emails	对一批收件箱邮件运行 AI 分类，标记意图和优先级。
list_api_keys	列出账户中的 API 密钥及其权限范围和最后使用时间。
generate_subject_lines	为营销活动主题生成 AI 主题行变体，可选择按语气和受众进行调整。
list_integrations	列出已连接的第三方集成及其同步状态。
get_integration	获取单个集成的配置、权限范围和上次同步结果。
toggle_integration	启用或禁用集成。
list_sandbox_sends	列出沙盒模式捕获的邮件。
clear_sandbox	删除所有捕获的沙盒邮件。
upgrade	显示当前 MisarMail 套餐、各项配额的剩余量、升级后可解锁的内容，以及升级链接。

提示词

客户端以斜杠命令形式公开的可复用工作流。

提示词	描述
compose_email	起草专业邮件，并在确认后通过 MisarMail 发送。
campaign_performance_report	分析营销活动表现，并制定按优先级排序的改进措施。
contact_import_guide	在检查许可和数据卫生的前提下，安全地导入和整理联系人。
automation_builder_guide	分步设计并构建邮件自动化工作流。
deliverability_improvement_plan	诊断邮件送达情况，并制定按优先级排序的每周行动计划。
ab_test_plan	为营销活动设计具有统计意义的 A/B 测试。
list_hygiene_audit	找出并清理影响发件人信誉的联系人。
weekly_email_report	生成可供利益相关方查看的每周邮件表现摘要。

资源

Agent 可附加的只读上下文，不会消耗工具调用。

URI	描述
misarmail://account/domains	你的发件域名及其验证状态和 DNS 记录。
misarmail://account/deliverability	当前账户的邮件送达评分（0–100）、等级和影响因素。
misarmail://account/warmup	IP/域名预热阶段，以及今天剩余的发送容量——批量发送不得超过此上限。
misarmail://templates	已保存的模板及其声明的变量，可在营销活动和邮件发送中重复使用。

Agent 技能

收录在 skills/ 中——当任务匹配时，Agent 会加载相应指南。

技能	适用场景
ab-test-campaign	为 MisarMail 营销活动设计并开展 A/B 测试——测试主题行、内容、发件人名称或发送时间。适用于“A/B 测试”“拆分测试”“哪个主题效果更好”或测试邮件变体等情况。
audit-deliverability	诊断 MisarMail 邮件进入垃圾邮件箱或退信的原因，并生成按优先级排序的修复清单。适用于“邮件进入垃圾邮件箱”“未送达”“打开率低”、域名信誉、DMARC/SPF/DKIM 或黑名单相关问题。
build-email-automation	设计并构建 MisarMail 自动化工作流——欢迎系列、滴灌序列、重新互动或新用户引导。适用于“自动化”“滴灌”“欢迎系列”“序列”或基于触发条件的邮件等情况。
clean-contact-list	审核并清理 MisarMail 联系人列表——包括退信、投诉和未互动的联系人。适用于列表卫生、重新互动、抑制发送，或“为什么我的打开率在下降”等情况。
email-performance-report	生成 MisarMail 表现报告——包括打开、点击、邮件送达情况和收入归因。适用于“我的邮件表现如何”、每周/月度报告或营销活动表现分析等情况。
run-email-campaign	在 MisarMail 中创建、审核并发送批量邮件营销活动。适用于用户希望向多个收件人发送邮件、新闻简报、细分受众内容或公告等情况。
send-transactional-email	通过 MisarMail 发送单次邮件或事务性邮件。适用于用户要求发送、起草并发送或回复邮件的情况，包括收据、通知、欢迎消息和个人联络邮件。
setup-sending-domain	在 MisarMail 中添加并验证自定义发件域名，包括 SPF、DKIM、DMARC 和入站路由。适用于“使用我自己的域名发送”、DNS 设置、域名验证或入站邮件等情况。

---

安全

破坏性和不可逆操作会标注（destructiveHint），以便客户端在运行前提示用户。技能会指示 Agent 在发送邮件、发布内容或执行其他对外可见的操作前进行确认。

发现操作（initialize、tools/list、prompts/list、resources/list）无需凭据，因此注册表可以在不提供凭据的情况下为服务建立索引。 每项操作都需要凭据。

Links

• Website — https://www.misarmail.com
• App — https://mail.misar.io
• Documentation — https://docs.misar.io/mail/mcp
• Smithery — https://smithery.ai/server/misar/misarmail-mcp
• npm — https://www.npmjs.com/package/@misarmail/mcp
• Source — https://github.com/Misar-AI/misarmail-mcp

MIT © Misar.AI