Misarmail Mcp

io.github.mrgulshanyadavPublished by GitHub account mrgulshanyadavv2.0.6Updated Oct 24, 2026

Send emails, manage campaigns, subscribers, and templates from MisarMail.

VerifiedSTDIODesktop onlyCommunication & CollaborationData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Lets an assistant send email, run campaigns, manage contacts, templates and automations, and audit deliverability through MisarMail.

What you can do
Exposes 55 tools for MisarMail email marketing: send transactional email, list, read, reply to and archive mail, and validate addresses. It manages campaigns, contacts, templates, automations, A/B tests, signup forms, landing pages and the unified inbox. Analytics tools cover delivery and engagement metrics, revenue attribution, monetization, and deliverability audits including SPF, DKIM and DMARC checks. It also ships 8 prompts, 4 read-only resources and 8 agent skills.
When to use it
Use it when an assistant should operate a MisarMail account: drafting and sending mail, launching or scheduling campaigns, importing and cleaning contacts, building automations, running A/B tests, or diagnosing spam and deliverability problems. It suits marketing and lifecycle email work rather than general-purpose messaging.
Requirements
Runs locally over stdio via the npm package @misarmail/mcp (Node.js and npx required), or as a remote Streamable HTTP endpoint. Needs a MisarMail account and either the MISARMAIL_API_KEY environment variable or a browser login that stores the key in ~/.misarmail/config.json. Self-hosted instances set MISARMAIL_BASE_URL. Network access is required. Desktop only; no web executable.
Before you install
Requires a MisarMail API key (MISARMAIL_API_KEY) or a browser login that saves the key to a local config file. Many tools act on the outside world: sending email, sending or scheduling campaigns, activating automations, selecting A/B winners, importing contacts, adding domains, and deleting sandbox mail. The README says destructive actions are annotated and skills ask for confirmation, but confirmations depend on the client. Sending mail and importing contacts can incur cost or breach consent or

Installation

In SourceWeft

  1. Open Misarmail Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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]

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)

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

Claude Code

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

Manual (any client)

json
{  "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)

json
{  "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, saved as a paused draft.
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 one A/B test variant on a campaign.
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..
get_analytics_timelineGet 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_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 a single hero block (headline, subheadline, CTA).
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, with the link to upgrade.

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

Source: README.md at commit f31d9f9

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v2.0.6LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts