About Misarmail MCP
Misarmail MCP is an MCP server published by Misar-AI in the Communication category: misarMail MCP server — 54 tools for email, campaigns, contacts, automations, A/B testing, and deliverability. Works with Claude, Cursor, VS Code, Windsurf, ChatGPT & any MCP client.
The repository has 1 stars and 0 forks, with the last commit 4 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/Misar-AI/misarmail-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (55)
add_domainAdd a sending domain and return the DNS records to publish.
Parameters not published.
archive_emailMove an email to the archive folder.
Parameters not published.
categorize_inbox_emailsRun AI categorisation over a batch of inbox emails to label intent and priority.
Parameters not published.
check_dmarcCheck live SPF, DKIM, and DMARC DNS records for a domain and report alignment problems with the exact record to publish.
Parameters not published.
clear_sandboxDelete every captured sandbox email.
Parameters not published.
configure_inbound_domainConfigure inbound email routing for a subdomain so replies land in the MisarMail unified inbox.
Parameters not published.
create_ab_testCreate one A/B test variant on a campaign.
Parameters not published.
create_automationCreate an automation workflow from a trigger, saved as a paused draft.
Parameters not published.
create_campaignCreate a new email marketing campaign as a draft.
Parameters not published.
create_contactAdd a single contact.
Parameters not published.
Show all 55 tools
create_landing_pageCreate a hosted landing page with a single hero block (headline, subheadline, CTA).
Parameters not published.
create_templateCreate a reusable email template.
Parameters not published.
generate_reportGenerate a structured analytics report over a date range.
Parameters not published.
generate_subject_linesGenerate AI subject-line variants for a campaign topic, optionally tuned to a tone and audience.
Parameters not published.
get_analyticsGet delivery and engagement analytics — sent, delivered, opened, clicked, bounced, and complained — for the account or one campaign, grouped by day/week/month..
Parameters not published.
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).
Parameters not published.
get_automationGet one automation workflow in full: trigger, every step with its delay, and per-step completion stats..
Parameters not published.
get_campaignGet full details for one campaign: content, audience segment, schedule, and delivery statistics (sent, opened, clicked, bounced, complained)..
Parameters not published.
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.
Parameters not published.
get_deliverability_scoreGet the account deliverability score (0–100) and letter grade (A–F) with the factors dragging it down.
Parameters not published.
get_emailRead the full content of a single email by ID, including headers, body, and attachments metadata.
Parameters not published.
get_formGet one signup form including its fields, embed code, and redirect behaviour..
Parameters not published.
get_form_submissionsList submissions for a signup form, including the submitted field values and timestamps..
Parameters not published.
get_inbox_conversation_messagesGet every message in one inbox conversation, oldest first, with sender and timestamps..
Parameters not published.
get_integrationGet one integration's configuration, scopes, and last sync result..
Parameters not published.
get_marketplace_itemGet one marketplace listing with its full preview, author, and install count..
Parameters not published.
get_monetization_statsGet newsletter monetization stats: paid subscribers, MRR, churn, and sponsorship revenue for the period..
Parameters not published.
get_revenue_attributionAttribute ecommerce revenue to email — revenue per campaign, per contact, and average order value from tracked conversions..
Parameters not published.
get_warmup_statusGet IP/domain warm-up progress and today's remaining send capacity.
Parameters not published.
import_contactsBulk-import up to 5,000 contacts in one call.
Parameters not published.
list_ab_testsList A/B tests with per-variant results and whether a winner has been selected yet..
Parameters not published.
list_api_keysList API keys on the account with their scopes and last-used time.
Parameters not published.
list_automationsList automation workflows (welcome series, re-engagement, drip sequences) with their trigger type and active state..
Parameters not published.
list_campaignsList email marketing campaigns with their status, audience size, and headline metrics.
Parameters not published.
list_contactsList contacts with their subscription status and engagement metrics.
Parameters not published.
list_domainsList sending domains with verification status and their DKIM/SPF/DMARC records.
Parameters not published.
list_emailsList emails from a mailbox folder with optional full-text search across subject and body.
Parameters not published.
list_formsList signup forms with their embed status and conversion counts..
Parameters not published.
list_inbox_conversationsList unified-inbox conversations (threads) with their status and detected intent.
Parameters not published.
list_integrationsList connected third-party integrations and their sync status..
Parameters not published.
list_marketplace_itemsBrowse the MisarMail template marketplace for ready-made email and automation templates..
Parameters not published.
list_sandbox_sendsList emails captured by sandbox mode.
Parameters not published.
list_templatesList saved email templates with their variable placeholders, so you can pick one for a campaign or transactional send..
Parameters not published.
render_templateRender a template with sample variables and return the resulting HTML and subject.
Parameters not published.
reply_to_emailReply to an existing email thread.
Parameters not published.
run_deliverability_auditRun a full deliverability audit across authentication (SPF/DKIM/DMARC), domain reputation, list hygiene, content signals, and blocklist status.
Parameters not published.
select_ab_test_winnerSelect the winning variant and send it to the remaining audience.
Parameters not published.
send_campaignSend a campaign now, or schedule it for a future time by passing scheduled_at.
Parameters not published.
send_emailSend a transactional email from a verified MisarMail account.
Parameters not published.
toggle_automationActivate or pause an automation.
Parameters not published.
toggle_integrationEnable or disable an integration.
Parameters not published.
update_contactUpdate an existing contact by email address, including changing subscription status.
Parameters not published.
upgradeShow the current MisarMail plan, how much of each quota is left, and what upgrading unlocks.
Parameters not published.
validate_emailValidate an email address before sending: syntax, MX records, disposable-domain and role-account detection.
Parameters not published.
verify_domainRe-check a domain's DNS records and mark it verified if they resolve.
Parameters not published.
Ask AI
Ask AI about Misarmail MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 4 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
2 checks have not been run yet.
Releases
README
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 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:
- 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_email |
Send a transactional email from a verified MisarMail account. |
list_emails |
List emails from a mailbox folder with optional full-text search across subject and body. |
get_email |
Read the full content of a single email by ID, including headers, body, and attachments metadata. |
reply_to_email |
Reply to an existing email thread. |
archive_email |
Move an email to the archive folder. |
validate_email |
Validate an email address before sending: syntax, MX records, disposable-domain and role-account detection. |
list_campaigns |
List email marketing campaigns with their status, audience size, and headline metrics. |
get_campaign |
Get full details for one campaign: content, audience segment, schedule, and delivery statistics (sent, opened, clicked, bounced, complained).. |
create_campaign |
Create a new email marketing campaign as a draft. |
send_campaign |
Send a campaign now, or schedule it for a future time by passing scheduled_at. |
list_contacts |
List contacts with their subscription status and engagement metrics. |
create_contact |
Add a single contact. |
update_contact |
Update an existing contact by email address, including changing subscription status. |
import_contacts |
Bulk-import up to 5,000 contacts in one call. |
get_contact_score |
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_templates |
List saved email templates with their variable placeholders, so you can pick one for a campaign or transactional send.. |
create_template |
Create a reusable email template. |
render_template |
Render a template with sample variables and return the resulting HTML and subject. |
list_automations |
List automation workflows (welcome series, re-engagement, drip sequences) with their trigger type and active state.. |
get_automation |
Get one automation workflow in full: trigger, every step with its delay, and per-step completion stats.. |
create_automation |
Create an automation workflow from a trigger, saved as a paused draft. |
toggle_automation |
Activate or pause an automation. |
list_ab_tests |
List A/B tests with per-variant results and whether a winner has been selected yet.. |
create_ab_test |
Create one A/B test variant on a campaign. |
select_ab_test_winner |
Select the winning variant and send it to the remaining audience. |
get_analytics |
Get delivery and engagement analytics — sent, delivered, opened, clicked, bounced, and complained — for the account or one campaign, grouped by day/week/month.. |
get_analytics_timeline |
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_report |
Generate a structured analytics report over a date range. |
get_revenue_attribution |
Attribute ecommerce revenue to email — revenue per campaign, per contact, and average order value from tracked conversions.. |
get_monetization_stats |
Get newsletter monetization stats: paid subscribers, MRR, churn, and sponsorship revenue for the period.. |
get_deliverability_score |
Get the account deliverability score (0–100) and letter grade (A–F) with the factors dragging it down. |
run_deliverability_audit |
Run a full deliverability audit across authentication (SPF/DKIM/DMARC), domain reputation, list hygiene, content signals, and blocklist status. |
get_warmup_status |
Get IP/domain warm-up progress and today's remaining send capacity. |
check_dmarc |
Check live SPF, DKIM, and DMARC DNS records for a domain and report alignment problems with the exact record to publish. |
list_domains |
List sending domains with verification status and their DKIM/SPF/DMARC records. |
add_domain |
Add a sending domain and return the DNS records to publish. |
verify_domain |
Re-check a domain's DNS records and mark it verified if they resolve. |
configure_inbound_domain |
Configure inbound email routing for a subdomain so replies land in the MisarMail unified inbox. |
list_forms |
List signup forms with their embed status and conversion counts.. |
get_form |
Get one signup form including its fields, embed code, and redirect behaviour.. |
get_form_submissions |
List submissions for a signup form, including the submitted field values and timestamps.. |
create_landing_page |
Create a hosted landing page with a single hero block (headline, subheadline, CTA). |
list_marketplace_items |
Browse the MisarMail template marketplace for ready-made email and automation templates.. |
get_marketplace_item |
Get one marketplace listing with its full preview, author, and install count.. |
list_inbox_conversations |
List unified-inbox conversations (threads) with their status and detected intent. |
get_inbox_conversation_messages |
Get every message in one inbox conversation, oldest first, with sender and timestamps.. |
categorize_inbox_emails |
Run AI categorisation over a batch of inbox emails to label intent and priority. |
list_api_keys |
List API keys on the account with their scopes and last-used time. |
generate_subject_lines |
Generate AI subject-line variants for a campaign topic, optionally tuned to a tone and audience. |
list_integrations |
List connected third-party integrations and their sync status.. |
get_integration |
Get one integration's configuration, scopes, and last sync result.. |
toggle_integration |
Enable or disable an integration. |
list_sandbox_sends |
List emails captured by sandbox mode. |
clear_sandbox |
Delete every captured sandbox email. |
upgrade |
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 |
|---|---|
compose_email |
Draft a professional email and send it via MisarMail after confirmation. |
campaign_performance_report |
Analyse campaign performance and produce prioritized improvements. |
contact_import_guide |
Import and organise contacts safely, with consent and hygiene checks. |
automation_builder_guide |
Design and build an email automation workflow step by step. |
deliverability_improvement_plan |
Diagnose deliverability and produce a prioritized weekly action plan. |
ab_test_plan |
Design a statistically meaningful A/B test for a campaign. |
list_hygiene_audit |
Find and clean the contacts that are hurting sender reputation. |
weekly_email_report |
Produce a stakeholder-ready weekly email performance summary. |
Resources
Read-only context an agent can attach without spending a tool call.
| URI | Description |
|---|---|
misarmail://account/domains |
Your sending domains with verification state and DNS records. |
misarmail://account/deliverability |
Current account deliverability score (0–100), grade, and contributing factors.. |
misarmail://account/warmup |
IP/domain warm-up stage and remaining send capacity for today — the ceiling a bulk send must stay under.. |
misarmail://templates |
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 |
|---|---|
ab-test-campaign |
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. |
audit-deliverability |
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. |
build-email-automation |
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. |
clean-contact-list |
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". |
email-performance-report |
Produce 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-campaign |
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-transactional-email |
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. |
setup-sending-domain |
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
- Smithery — https://smithery.ai/server/misar/misarmail-mcp
- npm — https://www.npmjs.com/package/@misarmail/mcp
- Source — https://github.com/Misar-AI/misarmail-mcp
MIT © Misar.AI
README fetched from the repository 4 days ago. The original is authoritative.