MisarMail MCP Server

Last 30 days

Uptime

100%

Response time

880 ms typical, 880 ms slowest 5%

Last check

9 h ago

Next check

any minute now

How to call it

Add it to any MCP client that supports remote servers.

{
  "mcpServers": {
    "misarmail-mcp-server": {
      "type": "http",
      "url": "https://api.misar.io/mail/mcp"
    }
  }
}

55 tools

• send_email

  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.

• list_emails

  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.

• get_email

  Read the full content of a single email by ID, including headers, body, and attachments metadata. Side effect: marks the email as read.

• reply_to_email

  Reply to an existing email thread. The sender address and threading headers are derived from the original message, so only the body is required.

• archive_email

  Move an email to the archive folder. Reversible — the message is not deleted.

• validate_email

  Validate an email address before sending: syntax, MX records, disposable-domain and role-account detection. Use this to protect sender reputation on imported lists.

• list_campaigns

  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.

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

• send_campaign

  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.

• list_contacts

  List contacts with their subscription status and engagement metrics. Filter by status to find unsubscribed or bounced addresses that should be excluded from sends.

• create_contact

  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.

• update_contact

  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.

• import_contacts

  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.

• 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. Use before a re-engagement campaign.

• 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. Use {{variable}} placeholders for personalisation — they are substituted at send time and previewable via render_template.

• render_template

  Render a template with sample variables and return the resulting HTML and subject. Use this to preview personalisation before sending anything.

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

• toggle_automation

  Activate or pause an automation. Activating starts enrolling contacts and sending on the configured schedule.

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

• select_ab_test_winner

  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.

• 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). The timeline counterpart to get_analytics's period totals.

• generate_report

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

• 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. Start here when asked why emails are landing in spam.

• run_deliverability_audit

  Run a full deliverability audit across authentication (SPF/DKIM/DMARC), domain reputation, list hygiene, content signals, and blocklist status. Returns prioritized findings.

• get_warmup_status

  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.

• check_dmarc

  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.

• list_domains

  List sending domains with verification status and their DKIM/SPF/DMARC records. Check here first when a send fails with an unverified-sender error.

• add_domain

  Add a sending domain and return the DNS records to publish. The domain cannot send until those records are live and verify_domain succeeds.

• verify_domain

  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.

• configure_inbound_domain

  Configure inbound email routing for a subdomain so replies land in the MisarMail unified inbox. Returns the MX record to publish.

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

Security scan

• No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks