MisarMail MCP Server
MisarMail MCP Server
通过任何 AI 助手发送电子邮件、运行营销活动、管理联系人和自动化、进行 A/B 测试,并审计送达率。
54 个工具 · 8 个提示词 · 4 个资源 · 8 个智能体技能
支持 Claude(Desktop、Code 和网页版)、Cursor、VS Code、Windsurf、Cline、 Zed、Gemini CLI、ChatGPT,以及任何其他兼容 MCP 的客户端——通过 stdio 或 Streamable HTTP。
安装
Smithery(推荐)
npx -y @smithery/cli install misar/misarmail-mcp --client claudeClaude 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" }
}
}
}Related MCP server: Nitrosend
身份验证
两种方式——第一种无需复制粘贴:
浏览器登录。 在未配置密钥的情况下启动服务器,并运行
login工具。 它会打开 MisarMail 授权页面,你可以查看所请求的权限, 随后密钥会直接返回并保存到~/.misarmail/config.json。API 密钥。 在 https://mail.misar.io/developers 创建一个 API 密钥,并设置
MISARMAIL_API_KEY。
自托管实例:请设置 MISARMAIL_BASE_URL。
工具
工具 | 描述 |
| 从已验证的 MisarMail 账户发送一封事务性邮件。 |
| 列出邮箱文件夹中的邮件,支持对主题和正文进行可选的全文搜索。 |
| 按 ID 读取单封邮件的完整内容,包括邮件头、正文和附件元数据。 |
| 回复现有的邮件线程。 |
| 将邮件移动到归档文件夹。 |
| 在发送前验证电子邮件地址:语法、MX 记录、一次性域名和角色账户检测。 |
| 列出电子邮件营销活动及其状态、受众规模和关键指标。 |
| 获取单个活动的完整详情:内容、受众细分、排期和投递统计(已发送、已打开、已点击、已退回、已投诉).. |
| 以草稿形式创建新的电子邮件营销活动。 |
| 立即发送活动,或通过传递 scheduled_at 将其安排到未来时间。 |
| 列出联系人及其订阅状态和互动指标。 |
| 添加单个联系人。 |
| 按电子邮件地址更新现有联系人,包括更改订阅状态。 |
| 一次调用批量导入最多 5,000 个联系人。 |
| 获取单个联系人的互动评分、互动层级和流失风险——或在省略 contact_id 时获取列表中互动度最低的联系人。 |
| 列出已保存的电子邮件模板及其变量占位符,以便为活动或事务性发送选择模板.. |
| 创建可复用的电子邮件模板。 |
| 使用示例变量渲染模板,并返回生成的 HTML 和主题。 |
| 列出自动化工作流(欢迎系列、重新互动、滴灌序列)及其触发类型和启用状态.. |
| 完整获取一个自动化工作流:触发器、每个步骤及其延迟,以及各步骤的完成统计.. |
| 从触发器和有序步骤列表创建自动化工作流。 |
| 启用或暂停自动化。 |
| 列出 A/B 测试及各变体的结果,以及是否已选出获胜者.. |
| 在活动上创建包含两个或更多变体的 A/B 测试。 |
| 选择获胜变体并将其发送给剩余受众。 |
| 获取投递和互动分析——已发送、已投递、已打开、已点击、已退回和已投诉——按天/周/月分组,适用于账户或单个活动.. |
| 在指定日期范围内生成结构化分析报告。 |
| 将电子商务收入归因于电子邮件——每个活动、每个联系人的收入,以及来自跟踪转化的平均订单价值.. |
| 获取新闻通讯变现统计:付费订阅者、MRR、流失率和该期间的赞助收入.. |
| 获取账户投递分数(0–100)和字母等级(A–F),以及拖累分数的因素。 |
| 在身份验证(SPF/DKIM/DMARC)、域名声誉、列表卫生、内容信号和黑名单状态方面运行完整的投递审计。 |
| 获取 IP/域名预热进度和今日剩余发送容量。 |
| 检查域名的实时 SPF、DKIM 和 DMARC DNS 记录,并报告需要发布的精确记录的对齐问题。 |
| 列出发送域名及其验证状态和 DKIM/SPF/DMARC 记录。 |
| 添加发送域名并返回需要发布的 DNS 记录。 |
| 重新检查域名的 DNS 记录,如果解析成功则将其标记为已验证。 |
| 为子域名配置入站邮件路由,使回复进入 MisarMail 统一收件箱。 |
| 列出注册表单及其嵌入状态和转化次数.. |
| 获取单个注册表单,包括其字段、嵌入代码和重定向行为.. |
| 列出注册表单的提交记录,包括提交的字段值和时间戳.. |
| 创建带有邮件捕获表单的托管落地页。 |
| 浏览 MisarMail 模板市场,寻找现成的邮件和自动化模板.. |
| 获取单个市场列表,包括完整预览、作者和安装次数.. |
| 列出统一收件箱会话(线程)及其状态和检测到的意图。 |
| 获取一个收件箱会话中的每条消息,按时间从旧到新排列,包含发件人和时间戳.. |
| 对一批收件箱邮件运行 AI 分类,以标记意图和优先级。 |
| 列出账户上的 API 密钥及其作用域和最后使用时间。 |
| 为活动主题生成 AI 主题行变体,可选地针对语气和受众进行调整。 |
| 列出已连接的第三方集成及其同步状态.. |
| 获取单个集成的配置、作用域和上次同步结果.. |
| 启用或禁用集成。 |
| 列出沙盒模式捕获的邮件。 |
| 删除所有捕获的沙盒邮件。 |
| 显示当前 MisarMail 套餐、每个配额剩余多少,以及升级解锁的内容。 |
提示词
客户端以斜杠命令形式暴露的可复用工作流。
提示词 | 描述 |
| 起草一封专业邮件,经确认后通过 MisarMail 发送。 |
| 分析营销活动表现,并生成按优先级排序的改进建议。 |
| 安全地导入和组织联系人,并进行同意与卫生检查。 |
| 逐步设计和构建邮件自动化工作流。 |
| 诊断送达率问题,并生成按优先级排序的每周行动计划。 |
| 为营销活动设计具有统计意义的 A/B 测试。 |
| 找出并清理损害发件人信誉的联系人。 |
| 生成可供利益相关者直接使用的每周邮件表现摘要。 |
资源
代理可以附加的只读上下文,无需消耗工具调用。
URI | 描述 |
| 您的发件域名及其验证状态和 DNS 记录。 |
| 当前账户的送达率评分(0–100)、等级及影响因素。 |
| IP/域名预热阶段及今日剩余发送容量——批量发送必须低于的上限。 |
| 已保存的模板及其声明的变量,可在营销活动和发送中复用。 |
代理技能
打包在 skills/ 中——当任务匹配时,代理会加载的指导。
技能 | 使用场景 |
| 在 MisarMail 营销活动上设计和运行 A/B 测试——主题行、内容、发件人名称或发送时间。适用于"A/B 测试"、"拆分测试"、"哪个主题效果更好"或测试邮件变体。 |
| 诊断 MisarMail 邮件为何进入垃圾邮件或被退回,并生成按优先级排序的修复清单。适用于"邮件进入垃圾邮件"、"无法送达"、"打开率低"、"域名信誉"、DMARC/SPF/DKIM 或黑名单问题。 |
| 设计和构建 MisarMail 自动化工作流——欢迎系列、滴灌序列、重新激活或引导流程。适用于"自动化"、"滴灌"、"欢迎系列"、"序列"或基于触发的邮件。 |
| 审计并清理 MisarMail 联系人列表——已退回、已投诉和未参与的联系人。适用于列表卫生、重新激活、抑制或"为什么我的打开率在下降"。 |
| 生成 MisarMail 表现报告——打开率、点击率、送达率、收入归因。适用于"我的邮件表现如何"、每周/每月报告或营销活动表现分析。 |
| 在 MisarMail 中创建、审核并发送批量邮件营销活动。当用户想向多个收件人发送列表、简报、细分群体或公告时使用。 |
| 通过 MisarMail 发送一次性或事务性邮件。当用户要求发送、起草并发送或回复邮件时使用——包括收据、通知、欢迎消息和个人外联。 |
| 在 MisarMail 中添加并验证自定义发件域名,包括 SPF、DKIM、DMARC 和入站路由。适用于"从我的域名发送"、DNS 设置、域名验证或入站邮件。 |
安全
破坏性和不可逆的操作会标注(destructiveHint),以便客户端在执行前提示。技能会指示代理在发送邮件、发布内容或任何其他人可见的操作之前进行确认。
发现(initialize、tools/list、prompts/list、resources/list)永远不需要凭据,因此注册中心可以在没有凭据的情况下索引服务器。而每个操作都需要。
链接
Smithery 技能 — send-transactional-email、run-email-campaign、ab-test-campaign、build-email-automation、clean-contact-list、setup-sending-domain、audit-deliverability、email-performance-report
MIT © Misar AI
Available Tools
58 toolsadd_domainAInspect
Add a sending domain and return the DNS records to publish. The domain cannot send until those records are live and verify_domain succeeds.
Inputs: domain (required).
archive_emailAIdempotentInspect
Move an email to the archive folder. Reversible — the message is not deleted.
Inputs: id (required).
auth_statusARead-onlyIdempotentInspect
Check whether this client is authenticated, which MisarMail account the stored key belongs to, and which API base URL it targets. Run this first when a tool reports an auth error.
Inputs: no named parameters.
categorize_inbox_emailsAIdempotentInspect
Run AI categorisation over a batch of inbox emails to label intent and priority. Consumes AI credits — pass only the emails you actually need triaged.
Inputs: email_ids (required).
check_dmarcARead-onlyIdempotentInspect
Check live SPF, DKIM, and DMARC DNS records for a domain and report alignment problems with the exact record to publish. Works for any domain, not only your own.
Inputs: domain (required).
clear_sandboxADestructiveIdempotentInspect
Delete every captured sandbox email. Affects only intercepted test messages, never real sent mail.
Inputs: no named parameters.
configure_inbound_domainAIdempotentInspect
Configure inbound email routing for a subdomain so replies land in the MisarMail unified inbox. Returns the MX record to publish.
Inputs: domain (required), subdomain (required), webhook_url (required).
create_ab_testAInspect
Create one A/B test variant on a campaign. The real API stores a single variant per call, so build a test by calling this once per variant (e.g. twice for a plain A/B split) using the same campaign_id and distinct variant labels. Each variant gets send_percent of the audience; auto_select_winner (with winner_wait_hours) can pick and send the winner automatically, or use select_ab_test_winner to do it manually.
Inputs: variant (required), campaign_id (required), subject, body_html, +8 more.
create_automationAInspect
Create an automation workflow from a trigger, saved as a paused draft. The API's create endpoint only accepts a name and trigger — it has no fields for workflow steps or starting active; configure the step sequence in the MisarMail dashboard's visual builder, and use toggle_automation to activate once reviewed.
Inputs: name (required), trigger (required), trigger_config.
create_campaignAInspect
Create a new email marketing campaign as a draft. Creating never sends or schedules anything — once the content and audience are confirmed, call send_campaign to send it now or schedule it for later.
Inputs: name (required), subject (required), from_name (required), from_email (required), +5 more.
create_contactAInspect
Add a single contact. Adding a contact records consent to email them — only add addresses that opted in, or the send will damage sender reputation and may breach CAN-SPAM/GDPR.
Inputs: email (required), tags, source, last_name, +2 more.
create_landing_pageAInspect
Create a hosted landing page with a single hero block (headline, subheadline, CTA). Returns the public URL. The real API stores pages as a page-builder block array with no dedicated headline/CTA fields, so this tool translates your inputs into one 'hero' block — for multi-block pages or a real CTA link, use the landing page editor in the MisarMail dashboard.
Inputs: name (required), headline (required), slug, cta_text, +1 more.
create_templateAInspect
Create a reusable email template. Use {{variable}} placeholders for personalisation — they are substituted at send time and previewable via render_template.
Inputs: html (required), name (required), subject (required), text, +2 more.
generate_reportBRead-onlyIdempotentInspect
Generate a structured analytics report over a date range. Report types: campaign_performance, engagement_funnel, cohort_analysis, and send_time_heatmap (best hour/day to send).
Inputs: report_type (required), date_to, date_from.
generate_subject_linesAInspect
Generate AI subject-line variants for a campaign topic, optionally tuned to a tone and audience. Good input for create_ab_test.
Inputs: topic (required), tone, count, audience.
get_analyticsARead-onlyIdempotentInspect
Get delivery and engagement analytics — sent, delivered, opened, clicked, bounced, and complained — for the account or one campaign, grouped by day/week/month.
Inputs: period, end_date, group_by, start_date, +1 more.
get_analytics_timelineARead-onlyIdempotentInspect
Get a day/week/month breakdown of sent, delivered, opened, clicked, bounced, complained, replied, and unsubscribed — across every send medium (campaigns, inbox compose, API, MCP, SDKs, GraphQL, automations). The timeline counterpart to get_analytics's period totals.
Inputs: period, end_date, group_by, start_date.
get_automationARead-onlyIdempotentInspect
Get one automation workflow in full: trigger, every step with its delay, and per-step completion stats.
Inputs: automation_id (required).
get_campaignARead-onlyIdempotentInspect
Get full details for one campaign: content, audience segment, schedule, and delivery statistics (sent, opened, clicked, bounced, complained).
Inputs: campaign_id (required).
get_contact_scoreARead-onlyIdempotentInspect
Get engagement score, engagement tier, and churn risk for one contact — or the lowest-engagement contacts across the list when contact_id is omitted. Use before a re-engagement campaign.
Inputs: contact_id.
get_deliverability_scoreARead-onlyIdempotentInspect
Get the account deliverability score (0–100) and letter grade (A–F) with the factors dragging it down. Start here when asked why emails are landing in spam.
Inputs: no named parameters.
get_emailAIdempotentInspect
Read the full content of a single email by ID, including headers, body, and attachments metadata. Side effect: marks the email as read.
Inputs: id (required).
get_formARead-onlyIdempotentInspect
Get one signup form including its fields, embed code, and redirect behaviour.
Inputs: form_id (required).
get_form_submissionsARead-onlyIdempotentInspect
List submissions for a signup form, including the submitted field values and timestamps.
Inputs: form_id (required), page, limit.
get_inbox_conversation_messagesARead-onlyIdempotentInspect
Get every message in one inbox conversation, oldest first, with sender and timestamps.
Inputs: conversation_id (required).
get_integrationARead-onlyIdempotentInspect
Get one integration's configuration, scopes, and last sync result.
Inputs: integration_id (required).
get_marketplace_itemARead-onlyIdempotentInspect
Get one marketplace listing with its full preview, author, and install count.
Inputs: item_id (required).
get_monetization_statsARead-onlyIdempotentInspect
Get newsletter monetization stats: paid subscribers, MRR, churn, and sponsorship revenue for the period.
Inputs: period.
get_revenue_attributionBRead-onlyIdempotentInspect
Attribute ecommerce revenue to email — revenue per campaign, per contact, and average order value from tracked conversions.
Inputs: period, campaign_id.
get_warmup_statusARead-onlyIdempotentInspect
Get IP/domain warm-up progress and today's remaining send capacity. Exceeding warm-up capacity on a new domain is the fastest way to get throttled or blocklisted.
Inputs: no named parameters.
import_contactsADestructiveInspect
Bulk-import up to 5,000 contacts in one call. By default, addresses that already exist are skipped rather than duplicated — pass update_existing: true to update them instead. Returns per-row results so you can see which rows were rejected and why.
Inputs: contacts (required), update_existing.
list_ab_testsBRead-onlyIdempotentInspect
List A/B tests with per-variant results and whether a winner has been selected yet.
Inputs: page, type, limit.
list_api_keysARead-onlyIdempotentInspect
List API keys on the account with their scopes and last-used time. Key secrets are never returned — only metadata.
Inputs: no named parameters.
list_automationsBRead-onlyIdempotentInspect
List automation workflows (welcome series, re-engagement, drip sequences) with their trigger type and active state.
Inputs: page, limit, status.
list_campaignsARead-onlyIdempotentInspect
List email marketing campaigns with their status, audience size, and headline metrics. Filter by status to find drafts ready to send or campaigns still sending.
Inputs: page, limit, status.
list_contactsARead-onlyIdempotentInspect
List contacts with their subscription status and engagement metrics. Filter by status to find unsubscribed or bounced addresses that should be excluded from sends.
Inputs: page, limit, search, status.
list_domainsARead-onlyIdempotentInspect
List sending domains with verification status and their DKIM/SPF/DMARC records. Check here first when a send fails with an unverified-sender error.
Inputs: page, limit.
list_emailsARead-onlyIdempotentInspect
List emails from a mailbox folder with optional full-text search across subject and body. Use this for reading the unified inbox; use list_campaigns for marketing sends.
Inputs: limit, folder, search.
list_formsARead-onlyIdempotentInspect
List signup forms with their embed status and conversion counts.
Inputs: page, limit, status.
list_inbox_conversationsARead-onlyIdempotentInspect
List unified-inbox conversations (threads) with their status and detected intent. Use this for triage; use list_emails for individual messages in a folder.
Inputs: q, limit, intent, offset, +2 more.
list_integrationsARead-onlyIdempotentInspect
List connected third-party integrations and their sync status.
Inputs: page, limit.
list_marketplace_itemsARead-onlyIdempotentInspect
Browse the MisarMail template marketplace for ready-made email and automation templates.
Inputs: page, limit, search, category.
list_sandbox_sendsARead-onlyIdempotentInspect
List emails captured by sandbox mode. Sandbox intercepts sends instead of delivering them — use it to verify templates and automations without emailing anyone.
Inputs: no named parameters.
list_templatesARead-onlyIdempotentInspect
List saved email templates with their variable placeholders, so you can pick one for a campaign or transactional send.
Inputs: page, type, limit.
loginAIdempotentInspect
Authenticate with your MisarMail account via browser — no API key copy-paste needed. Opens the MisarMail authorization page where you review the requested permissions and click 'Authorize'. The API key is delivered straight back to this client and saved to ~/.misarmail/config.json.
Inputs: port, force, app_url.
logoutADestructiveIdempotentInspect
Forget the locally stored MisarMail API key (~/.misarmail/config.json). Does not revoke the key server-side — delete it from mail.misar.io/developers to do that.
Inputs: no named parameters.
render_templateARead-onlyIdempotentInspect
Render a template with sample variables and return the resulting HTML and subject. Use this to preview personalisation before sending anything.
Inputs: template_id (required), variables.
reply_to_emailAInspect
Reply to an existing email thread. The sender address and threading headers are derived from the original message, so only the body is required.
Inputs: email_id (required), html, text.
run_deliverability_auditARead-onlyIdempotentInspect
Run a full deliverability audit across authentication (SPF/DKIM/DMARC), domain reputation, list hygiene, content signals, and blocklist status. Returns prioritized findings.
Inputs: no named parameters.
select_ab_test_winnerADestructiveInspect
Select the winning variant and send it to the remaining audience. This triggers a real send to everyone who was held back — it cannot be undone.
Inputs: test_id (required), winner_variant (required), metric.
send_campaignADestructiveInspect
Send a campaign now, or schedule it for a future time by passing scheduled_at. This delivers real email to real recipients and cannot be undone once sending starts — confirm the audience with get_campaign first.
Inputs: campaign_id (required), scheduled_at.
send_emailAInspect
Send a transactional email from a verified MisarMail account. from.email must match an email account you have already verified — use list_domains to check which sender domains are available. Returns the message ID and queue status.
Inputs: to (required), from (required), subject (required), cc, +8 more.
toggle_automationAIdempotentInspect
Activate or pause an automation. Activating starts enrolling contacts and sending on the configured schedule.
Inputs: active (required), automation_id (required).
toggle_integrationAIdempotentInspect
Enable or disable an integration. Disabling stops all syncing but preserves the stored credentials.
Inputs: enabled (required), integration_id (required).
update_contactADestructiveIdempotentInspect
Update an existing contact by email address, including changing subscription status. Setting status to unsubscribed immediately excludes them from every future campaign. Does not support tags, phone, company, or job title — the API has no fields for them.
Inputs: email (required), status, last_name, first_name, +1 more.
upgradeARead-onlyIdempotentInspect
Show the current MisarMail plan, how much of each quota is left, and what upgrading unlocks, with the link to upgrade. Call it any time — not only after hitting a limit. Reads only: it never changes the plan or takes payment; the user upgrades by following the link. On a local install, open=true also opens that link in the user's browser.
Inputs: open, plan.
validate_emailARead-onlyIdempotentInspect
Validate an email address before sending: syntax, MX records, disposable-domain and role-account detection. Use this to protect sender reputation on imported lists.
Inputs: email (required).
verify_domainAIdempotentInspect
Re-check a domain's DNS records and mark it verified if they resolve. Safe to retry — DNS propagation can take up to 48 hours.
Inputs: domain_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 58 tools
Most tools have distinct resource+action targets, and descriptions cross-reference siblings (e.g., list_inbox_conversations vs list_emails). However, with 58 tools there are clusters that can confuse: list_emails/get_email/get_inbox_conversation_messages, get_analytics/get_analytics_timeline/generate_report, and get_deliverability_score/run_deliverability_audit/check_dmarc. Descriptions mitigate but not eliminate overlap.
Predominantly snake_case verb_noun (list_campaigns, create_campaign, send_campaign), which is predictable. Exceptions like login, logout, upgrade, auth_status, and check_dmarc are minor deviations; overall still readable and consistent.
58 tools is far above the typical 3-15 range and exceeds the 25+ 'heavy' threshold by a wide margin. While each maps to a subdomain, the volume increases discovery and misselection risk for agents; consolidation would help.
Core workflows are covered (campaigns, contacts, templates, domains, inbox, automations, analytics), but several resources lack full lifecycle: no update/delete for campaigns/templates/contacts, no automation step editing, no form creation, and landing pages only have create. These are notable gaps, though many can be worked around via the dashboard.
Maintenance
Related MCP Connectors
AI-native email marketing. Campaigns, automations, transactional, contacts, and analytics.
AI-controlled email ops for campaigns, contacts, segments, analytics, and sending.
Email, WhatsApp and Telegram for AI agents: send, campaigns, automations, contacts, agent inboxes.
335 MCP tools, 75 playbooks. AI-native CRM, email/SMS, events, OAuth.
Related MCP Servers
AlicenseBqualityBmaintenanceEnables management of AI-powered email marketing automation, including subscriber segments, campaigns, and templates. It allows users to generate email sequences with AI and track detailed analytics through natural language commands.4431,979 npm4MIT- AlicenseNot gradedqualityBmaintenanceAI-native email marketing platform built for agents. Control campaigns, automations, contacts, templates, and analytics via MCP with OAuth authentication.57 npm162MIT
- AlicenseAqualityCmaintenanceAn MCP server providing comprehensive email capabilities via IMAP and SMTP, enabling AI assistants to read, search, send, manage, schedule, and analyze emails across multiple accounts.521,007 npm161LGPL 3.0
- FlicenseNot gradedqualityDmaintenanceProvides 35 MCP tools for automated marketing campaigns, integrating event management, booking, and email marketing into a deterministic pipeline for AI agents.-