MisarMail MCP Server
MisarMail MCP Server lets an AI assistant operate a full email marketing platform — sending transactional mail and campaigns, managing contacts, automations, templates, and domains, and auditing deliverability.
Transactional email & mailbox: send email, reply to threads, list/read/archive messages, with an
idempotency_keyto prevent duplicate sendsCampaigns: create, list, inspect, send now or schedule, plus create A/B tests and select winners (real sends, irreversible)
Contacts: list, create, update, bulk-import up to 5,000, and get engagement/churn scores
Templates: list, create, render previews with variables, and browse the marketplace
Automations: create step-based workflows from triggers, inspect steps, activate or pause (pausing holds in-flight contacts)
Analytics & revenue: delivery/engagement metrics, timelines, structured reports, revenue attribution, newsletter monetization stats
Deliverability: score and grade, full audit, warm-up status/remaining capacity, SPF/DKIM/DMARC checks for any domain
Domains: list, add, verify sending domains, configure inbound subdomains
Forms & landing pages: list forms, read embed code and submissions (personal data), create hosted landing pages
Unified inbox: list conversations and full threads, categorize emails by intent/priority with AI
Account & ops: validate email addresses, list API keys, manage integrations, use sandbox mode, check plan/quotas, browser login, logout, auth status
Bundled extras: 8 reusable prompts (e.g.
compose_email,weekly_email_report), 4 read-only resources, and 8 agent skills covering campaigns, deliverability, automation, and list hygiene
Enables sending messages through the WhatsApp Business API as part of multi-channel marketing and communication workflows.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
MisarMail MCP Server
Send email, run campaigns, manage contacts and automations, A/B test, and audit deliverability — from any AI assistant.
55 tools · 8 prompts · 4 resources · 8 agent skills
Works with Claude (Desktop, Code, and web), Cursor, VS Code, Windsurf, Cline, Zed, Gemini CLI, ChatGPT, and any other MCP-compatible client — over stdio or Streamable HTTP.
Install
Smithery (recommended)
npx -y @smithery/cli install misar/misarmail-mcp --client claudeClaude Code
claude mcp add misarmail -- npx -y @misarmail/mcp@latestManual (any client)
{
"mcpServers": {
"misarmail": {
"command": "npx",
"args": ["-y", "@misarmail/mcp@latest"],
"env": { "MISARMAIL_API_KEY": "msk_your_key_here" }
}
}
}Ready-made configs for every client live in connectors/.
Remote (no install)
{
"mcpServers": {
"misarmail": {
"type": "streamable-http",
"url": "https://api.misar.io/mail/mcp",
"headers": { "Authorization": "Bearer msk_your_key_here" }
}
}
}Related MCP server: Nitrosend
Authentication
Two options — no copy-paste needed for the first:
Browser login. Start the server with no key and run the
logintool. It opens the MisarMail consent screen, you review the requested permissions, and the key is delivered straight back and saved to~/.misarmail/config.json.API key. Create one at https://mail.misar.io/developers and set
MISARMAIL_API_KEY.
Self-hosted instances: set MISARMAIL_BASE_URL.
Tools
Tool | Description |
| Send a transactional email from a verified MisarMail account. |
| List emails from a mailbox folder with optional full-text search across subject and body. |
| Read the full content of a single email by ID, including headers, body, and attachments metadata. |
| Reply to an existing email thread. |
| Move an email to the archive folder. |
| Validate an email address before sending: syntax, MX records, disposable-domain and role-account detection. |
| List email marketing campaigns with their status, audience size, and headline metrics. |
| Get full details for one campaign: content, audience segment, schedule, and delivery statistics (sent, opened, clicked, bounced, complained).. |
| Create a new email marketing campaign as a draft. |
| Send a campaign now, or schedule it for a future time by passing scheduled_at. |
| List contacts with their subscription status and engagement metrics. |
| Add a single contact. |
| Update an existing contact by email address, including changing subscription status. |
| Bulk-import up to 5,000 contacts in one call. |
| Get engagement score, engagement tier, and churn risk for one contact — or the lowest-engagement contacts across the list when contact_id is omitted. |
| List saved email templates with their variable placeholders, so you can pick one for a campaign or transactional send.. |
| Create a reusable email template. |
| Render a template with sample variables and return the resulting HTML and subject. |
| List automation workflows (welcome series, re-engagement, drip sequences) with their trigger type and active state.. |
| Get one automation workflow in full: trigger, every step with its delay, and per-step completion stats.. |
| Create an automation workflow from a trigger, saved as a paused draft. |
| Activate or pause an automation. |
| List A/B tests with per-variant results and whether a winner has been selected yet.. |
| Create one A/B test variant on a campaign. |
| Select the winning variant and send it to the remaining audience. |
| Get delivery and engagement analytics — sent, delivered, opened, clicked, bounced, and complained — for the account or one campaign, grouped by day/week/month.. |
| 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). |
| Generate a structured analytics report over a date range. |
| Attribute ecommerce revenue to email — revenue per campaign, per contact, and average order value from tracked conversions.. |
| Get newsletter monetization stats: paid subscribers, MRR, churn, and sponsorship revenue for the period.. |
| Get the account deliverability score (0–100) and letter grade (A–F) with the factors dragging it down. |
| Run a full deliverability audit across authentication (SPF/DKIM/DMARC), domain reputation, list hygiene, content signals, and blocklist status. |
| Get IP/domain warm-up progress and today's remaining send capacity. |
| Check live SPF, DKIM, and DMARC DNS records for a domain and report alignment problems with the exact record to publish. |
| List sending domains with verification status and their DKIM/SPF/DMARC records. |
| Add a sending domain and return the DNS records to publish. |
| Re-check a domain's DNS records and mark it verified if they resolve. |
| Configure inbound email routing for a subdomain so replies land in the MisarMail unified inbox. |
| List signup forms with their embed status and conversion counts.. |
| Get one signup form including its fields, embed code, and redirect behaviour.. |
| List submissions for a signup form, including the submitted field values and timestamps.. |
| Create a hosted landing page with a single hero block (headline, subheadline, CTA). |
| Browse the MisarMail template marketplace for ready-made email and automation templates.. |
| Get one marketplace listing with its full preview, author, and install count.. |
| List unified-inbox conversations (threads) with their status and detected intent. |
| Get every message in one inbox conversation, oldest first, with sender and timestamps.. |
| Run AI categorisation over a batch of inbox emails to label intent and priority. |
| List API keys on the account with their scopes and last-used time. |
| Generate AI subject-line variants for a campaign topic, optionally tuned to a tone and audience. |
| List connected third-party integrations and their sync status.. |
| Get one integration's configuration, scopes, and last sync result.. |
| Enable or disable an integration. |
| List emails captured by sandbox mode. |
| Delete every captured sandbox email. |
| Show the current MisarMail plan, how much of each quota is left, and what upgrading unlocks, with the link to upgrade. |
Prompts
Reusable workflows your client exposes as slash-commands.
Prompt | Description |
| Draft a professional email and send it via MisarMail after confirmation. |
| Analyse campaign performance and produce prioritized improvements. |
| Import and organise contacts safely, with consent and hygiene checks. |
| Design and build an email automation workflow step by step. |
| Diagnose deliverability and produce a prioritized weekly action plan. |
| Design a statistically meaningful A/B test for a campaign. |
| Find and clean the contacts that are hurting sender reputation. |
| Produce a stakeholder-ready weekly email performance summary. |
Resources
Read-only context an agent can attach without spending a tool call.
URI | Description |
| Your sending domains with verification state and DNS records. |
| Current account deliverability score (0–100), grade, and contributing factors.. |
| IP/domain warm-up stage and remaining send capacity for today — the ceiling a bulk send must stay under.. |
| Saved templates with their declared variables, for reuse in campaigns and sends.. |
Agent skills
Bundled in skills/ — guidance an agent loads when a task matches.
Skill | Use when |
| Design and run an A/B test on a MisarMail campaign — subject line, content, sender name, or send time. Use for "A/B test", "split test", "which subject works better", or testing email variants. |
| Diagnose why MisarMail emails land in spam or bounce, and produce a prioritized fix list. Use for "emails going to spam", "not being delivered", "low open rate", "domain reputation", DMARC/SPF/DKIM, or blocklist questions. |
| Design and build a MisarMail automation workflow — welcome series, drip sequence, re-engagement, or onboarding. Use for "automate", "drip", "welcome series", "sequence", or trigger-based email. |
| Audit and clean a MisarMail contact list — bounced, complained, and unengaged contacts. Use for list hygiene, re-engagement, suppression, or "why is my open rate falling". |
| Produce a MisarMail performance report — opens, clicks, deliverability, revenue attribution. Use for "how are my emails doing", weekly/monthly reports, or campaign performance analysis. |
| Create, review, and send a bulk email campaign in MisarMail. Use when the user wants to email a list, newsletter, segment, or announcement to many recipients. |
| Send a one-off or transactional email through MisarMail. Use when the user asks to send, draft-and-send, or reply to an email — including receipts, notifications, welcome messages, and personal outreach. |
| Add and verify a custom sending domain in MisarMail, including SPF, DKIM, DMARC, and inbound routing. Use for "send from my own domain", DNS setup, domain verification, or inbound email. |
Safety
Destructive and irreversible actions are annotated (destructiveHint) so
clients can prompt before running them. The skills instruct agents to confirm
before anything that sends mail, publishes content, or is otherwise visible to
other people.
Discovery (initialize, tools/list, prompts/list, resources/list)
never requires credentials, so registries can index the server without one.
Every action does.
Links
Website — https://www.misarmail.com
App — https://mail.misar.io
Documentation — https://docs.misar.io/mail/mcp
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.-