Skip to main content
Glama

MisarMail MCP Server

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

npm 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

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

Related MCP server: Nitrosend

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

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.


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.
      -