Skip to main content
Glama

MisarMail MCP Server

通过任何 AI 助手发送电子邮件、运行营销活动、管理联系人和自动化、进行 A/B 测试,并审计送达率。

npm license

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 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" }
    }
  }
}

Related MCP server: Nitrosend

身份验证

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

  1. 浏览器登录。 在未配置密钥的情况下启动服务器,并运行 login 工具。 它会打开 MisarMail 授权页面,你可以查看所请求的权限, 随后密钥会直接返回并保存到 ~/.misarmail/config.json。

  2. API 密钥。 在 https://mail.misar.io/developers 创建一个 API 密钥,并设置 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

获取投递和互动分析——已发送、已投递、已打开、已点击、已退回和已投诉——按天/周/月分组,适用于账户或单个活动..

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

创建带有邮件捕获表单的托管落地页。

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

生成可供利益相关者直接使用的每周邮件表现摘要。

资源

代理可以附加的只读上下文,无需消耗工具调用。

URI

描述

misarmail://account/domains

您的发件域名及其验证状态和 DNS 记录。

misarmail://account/deliverability

当前账户的送达率评分(0–100)、等级及影响因素。

misarmail://account/warmup

IP/域名预热阶段及今日剩余发送容量——批量发送必须低于的上限。

misarmail://templates

已保存的模板及其声明的变量,可在营销活动和发送中复用。

代理技能

打包在 skills/ 中——当任务匹配时,代理会加载的指导。

技能

使用场景

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),以便客户端在执行前提示。技能会指示代理在发送邮件、发布内容或任何其他人可见的操作之前进行确认。

发现(initialize、tools/list、prompts/list、resources/list)永远不需要凭据,因此注册中心可以在没有凭据的情况下索引服务器。而每个操作都需要。


链接

MIT © Misar AI

Available Tools

58 tools
add_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_emailA
Idempotent
Inspect

Move an email to the archive folder. Reversible — the message is not deleted.

Inputs: id (required).

auth_statusA
Read-onlyIdempotent
Inspect

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_emailsA
Idempotent
Inspect

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_dmarcA
Read-onlyIdempotent
Inspect

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_sandboxA
DestructiveIdempotent
Inspect

Delete every captured sandbox email. Affects only intercepted test messages, never real sent mail.

Inputs: no named parameters.

configure_inbound_domainA
Idempotent
Inspect

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_reportB
Read-onlyIdempotent
Inspect

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_analyticsA
Read-onlyIdempotent
Inspect

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_timelineA
Read-onlyIdempotent
Inspect

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_automationA
Read-onlyIdempotent
Inspect

Get one automation workflow in full: trigger, every step with its delay, and per-step completion stats.

Inputs: automation_id (required).

get_campaignA
Read-onlyIdempotent
Inspect

Get full details for one campaign: content, audience segment, schedule, and delivery statistics (sent, opened, clicked, bounced, complained).

Inputs: campaign_id (required).

get_contact_scoreA
Read-onlyIdempotent
Inspect

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_scoreA
Read-onlyIdempotent
Inspect

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_emailA
Idempotent
Inspect

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_formA
Read-onlyIdempotent
Inspect

Get one signup form including its fields, embed code, and redirect behaviour.

Inputs: form_id (required).

get_form_submissionsA
Read-onlyIdempotent
Inspect

List submissions for a signup form, including the submitted field values and timestamps.

Inputs: form_id (required), page, limit.

get_inbox_conversation_messagesA
Read-onlyIdempotent
Inspect

Get every message in one inbox conversation, oldest first, with sender and timestamps.

Inputs: conversation_id (required).

get_integrationA
Read-onlyIdempotent
Inspect

Get one integration's configuration, scopes, and last sync result.

Inputs: integration_id (required).

get_marketplace_itemA
Read-onlyIdempotent
Inspect

Get one marketplace listing with its full preview, author, and install count.

Inputs: item_id (required).

get_monetization_statsA
Read-onlyIdempotent
Inspect

Get newsletter monetization stats: paid subscribers, MRR, churn, and sponsorship revenue for the period.

Inputs: period.

get_revenue_attributionB
Read-onlyIdempotent
Inspect

Attribute ecommerce revenue to email — revenue per campaign, per contact, and average order value from tracked conversions.

Inputs: period, campaign_id.

get_warmup_statusA
Read-onlyIdempotent
Inspect

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_contactsA
Destructive
Inspect

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_testsB
Read-onlyIdempotent
Inspect

List A/B tests with per-variant results and whether a winner has been selected yet.

Inputs: page, type, limit.

list_api_keysA
Read-onlyIdempotent
Inspect

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_automationsB
Read-onlyIdempotent
Inspect

List automation workflows (welcome series, re-engagement, drip sequences) with their trigger type and active state.

Inputs: page, limit, status.

list_campaignsA
Read-onlyIdempotent
Inspect

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_contactsA
Read-onlyIdempotent
Inspect

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_domainsA
Read-onlyIdempotent
Inspect

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_emailsA
Read-onlyIdempotent
Inspect

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_formsA
Read-onlyIdempotent
Inspect

List signup forms with their embed status and conversion counts.

Inputs: page, limit, status.

list_inbox_conversationsA
Read-onlyIdempotent
Inspect

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_integrationsA
Read-onlyIdempotent
Inspect

List connected third-party integrations and their sync status.

Inputs: page, limit.

list_marketplace_itemsA
Read-onlyIdempotent
Inspect

Browse the MisarMail template marketplace for ready-made email and automation templates.

Inputs: page, limit, search, category.

list_sandbox_sendsA
Read-onlyIdempotent
Inspect

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_templatesA
Read-onlyIdempotent
Inspect

List saved email templates with their variable placeholders, so you can pick one for a campaign or transactional send.

Inputs: page, type, limit.

loginA
Idempotent
Inspect

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.

logoutA
DestructiveIdempotent
Inspect

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_templateA
Read-onlyIdempotent
Inspect

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_auditA
Read-onlyIdempotent
Inspect

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_winnerA
Destructive
Inspect

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_campaignA
Destructive
Inspect

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_automationA
Idempotent
Inspect

Activate or pause an automation. Activating starts enrolling contacts and sending on the configured schedule.

Inputs: active (required), automation_id (required).

toggle_integrationA
Idempotent
Inspect

Enable or disable an integration. Disabling stops all syncing but preserves the stored credentials.

Inputs: enabled (required), integration_id (required).

update_contactA
DestructiveIdempotent
Inspect

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.

upgradeA
Read-onlyIdempotent
Inspect

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_emailA
Read-onlyIdempotent
Inspect

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_domainA
Idempotent
Inspect

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

    A3.6/5.0

    Scored across 58 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness3/5

    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

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Enables 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.
      443
      1,979 npm
      4
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      AI-native email marketing platform built for agents. Control campaigns, automations, contacts, templates, and analytics via MCP with OAuth authentication.
      57 npm
      162
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      An 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.
      52
      1,007 npm
      161
      LGPL 3.0
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides 35 MCP tools for automated marketing campaigns, integrating event management, booking, and email marketing into a deterministic pipeline for AI agents.
      -