Back to Browse

Misarmail MCP Server

Developer ToolsUse Caution4.8MCP RegistryLocalRemote
Free

Server data from the Official MCP Registry

Send transactional email, run campaigns, manage contacts and automations, audit deliverability.

About

Send transactional email, run campaigns, manage contacts and automations, audit deliverability.

Remote endpoints: streamable-http: https://api.misar.io/mail/mcp

Security Report

4.8
Use Caution4.8High Risk

Well-structured MCP server with proper authentication controls and appropriate permission scoping. Security mechanisms are sound: auth is required for all sensitive operations, tokens are stored securely in config files rather than hardcoded, and the server correctly gates discovery endpoints. Minor code quality findings around error handling do not significantly impact security posture. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.

7 files analyzed · 9 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

process_spawn

Check that this permission is expected for this type of plugin.

system_info

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Your MisarMail API key (msk_…). Create one at https://mail.misar.io/developers, or omit it and run the "login" tool to authenticate via browser.Required

Environment variable: MISARMAIL_API_KEY

Override the API base URL. Only needed for self-hosted instances.Optional

Environment variable: MISARMAIL_BASE_URL

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Documentation

View on GitHub

From the project's GitHub README.

MisarMail MCP Server

Send email, run campaigns, manage contacts and automations, A/B test, and audit deliverability — from any AI assistant.

npm smithery license

54 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 claude

Claude Code

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

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

Authentication

Two options — no copy-paste needed for the first:

  1. Browser login. Start the server with no key and run the login tool. It opens the MisarMail consent screen, you review the requested permissions, and the key is delivered straight back and saved to ~/.misarmail/config.json.
  2. API key. Create one at https://mail.misar.io/developers and set MISARMAIL_API_KEY.

Self-hosted instances: set MISARMAIL_BASE_URL.


Tools

ToolDescription
send_emailSend a transactional email from a verified MisarMail account.
list_emailsList emails from a mailbox folder with optional full-text search across subject and body.
get_emailRead the full content of a single email by ID, including headers, body, and attachments metadata.
reply_to_emailReply to an existing email thread.
archive_emailMove an email to the archive folder.
validate_emailValidate an email address before sending: syntax, MX records, disposable-domain and role-account detection.
list_campaignsList email marketing campaigns with their status, audience size, and headline metrics.
get_campaignGet full details for one campaign: content, audience segment, schedule, and delivery statistics (sent, opened, clicked, bounced, complained)..
create_campaignCreate a new email marketing campaign as a draft.
send_campaignSend a campaign now, or schedule it for a future time by passing scheduled_at.
list_contactsList contacts with their subscription status and engagement metrics.
create_contactAdd a single contact.
update_contactUpdate an existing contact by email address, including changing subscription status.
import_contactsBulk-import up to 5,000 contacts in one call.
get_contact_scoreGet engagement score, engagement tier, and churn risk for one contact — or the lowest-engagement contacts across the list when contact_id is omitted.
list_templatesList saved email templates with their variable placeholders, so you can pick one for a campaign or transactional send..
create_templateCreate a reusable email template.
render_templateRender a template with sample variables and return the resulting HTML and subject.
list_automationsList automation workflows (welcome series, re-engagement, drip sequences) with their trigger type and active state..
get_automationGet one automation workflow in full: trigger, every step with its delay, and per-step completion stats..
create_automationCreate an automation workflow from a trigger and an ordered list of steps.
toggle_automationActivate or pause an automation.
list_ab_testsList A/B tests with per-variant results and whether a winner has been selected yet..
create_ab_testCreate an A/B test on a campaign with two or more variants.
select_ab_test_winnerSelect the winning variant and send it to the remaining audience.
get_analyticsGet delivery and engagement analytics — sent, delivered, opened, clicked, bounced, and complained — for the account or one campaign, grouped by day/week/month..
generate_reportGenerate a structured analytics report over a date range.
get_revenue_attributionAttribute ecommerce revenue to email — revenue per campaign, per contact, and average order value from tracked conversions..
get_monetization_statsGet newsletter monetization stats: paid subscribers, MRR, churn, and sponsorship revenue for the period..
get_deliverability_scoreGet the account deliverability score (0–100) and letter grade (A–F) with the factors dragging it down.
run_deliverability_auditRun a full deliverability audit across authentication (SPF/DKIM/DMARC), domain reputation, list hygiene, content signals, and blocklist status.
get_warmup_statusGet IP/domain warm-up progress and today's remaining send capacity.
check_dmarcCheck live SPF, DKIM, and DMARC DNS records for a domain and report alignment problems with the exact record to publish.
list_domainsList sending domains with verification status and their DKIM/SPF/DMARC records.
add_domainAdd a sending domain and return the DNS records to publish.
verify_domainRe-check a domain's DNS records and mark it verified if they resolve.
configure_inbound_domainConfigure inbound email routing for a subdomain so replies land in the MisarMail unified inbox.
list_formsList signup forms with their embed status and conversion counts..
get_formGet one signup form including its fields, embed code, and redirect behaviour..
get_form_submissionsList submissions for a signup form, including the submitted field values and timestamps..
create_landing_pageCreate a hosted landing page with an email capture form.
list_marketplace_itemsBrowse the MisarMail template marketplace for ready-made email and automation templates..
get_marketplace_itemGet one marketplace listing with its full preview, author, and install count..
list_inbox_conversationsList unified-inbox conversations (threads) with their status and detected intent.
get_inbox_conversation_messagesGet every message in one inbox conversation, oldest first, with sender and timestamps..
categorize_inbox_emailsRun AI categorisation over a batch of inbox emails to label intent and priority.
list_api_keysList API keys on the account with their scopes and last-used time.
generate_subject_linesGenerate AI subject-line variants for a campaign topic, optionally tuned to a tone and audience.
list_integrationsList connected third-party integrations and their sync status..
get_integrationGet one integration's configuration, scopes, and last sync result..
toggle_integrationEnable or disable an integration.
list_sandbox_sendsList emails captured by sandbox mode.
clear_sandboxDelete every captured sandbox email.
upgradeShow the current MisarMail plan, how much of each quota is left, and what upgrading unlocks.

Prompts

Reusable workflows your client exposes as slash-commands.

PromptDescription
compose_emailDraft a professional email and send it via MisarMail after confirmation.
campaign_performance_reportAnalyse campaign performance and produce prioritized improvements.
contact_import_guideImport and organise contacts safely, with consent and hygiene checks.
automation_builder_guideDesign and build an email automation workflow step by step.
deliverability_improvement_planDiagnose deliverability and produce a prioritized weekly action plan.
ab_test_planDesign a statistically meaningful A/B test for a campaign.
list_hygiene_auditFind and clean the contacts that are hurting sender reputation.
weekly_email_reportProduce a stakeholder-ready weekly email performance summary.

Resources

Read-only context an agent can attach without spending a tool call.

URIDescription
misarmail://account/domainsYour sending domains with verification state and DNS records.
misarmail://account/deliverabilityCurrent account deliverability score (0–100), grade, and contributing factors..
misarmail://account/warmupIP/domain warm-up stage and remaining send capacity for today — the ceiling a bulk send must stay under..
misarmail://templatesSaved templates with their declared variables, for reuse in campaigns and sends..

Agent skills

Bundled in skills/ — guidance an agent loads when a task matches.

SkillUse when
ab-test-campaignDesign 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.
audit-deliverabilityDiagnose 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.
build-email-automationDesign 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.
clean-contact-listAudit 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".
email-performance-reportProduce a MisarMail performance report — opens, clicks, deliverability, revenue attribution. Use for "how are my emails doing", weekly/monthly reports, or campaign performance analysis.
run-email-campaignCreate, 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-transactional-emailSend 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.
setup-sending-domainAdd 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

MIT © Misar AI

Reviews

No reviews yet

Be the first to review this server!