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.
LABSCO SUMMARY
Everything that actually reaches a real inbox is a separate, deliberate call.
create_campaign only drafts, create_automation starts paused, and the irreversible steps are annotated so a client can prompt before running them — which matters when the failure mode is a real send to a real list. Sandbox mode is the other half of that: it captures messages instead of delivering them while you get a template or a drip sequence right. If mail is already going astray, start at get_deliverability_score for the grade and the reasons behind it, then let check_dmarc hand you the exact DNS record to publish.
What it is
MisarMail's MCP server, covering the whole platform: transactional sending, a unified inbox, marketing campaigns, contacts, templates, automations, A/B tests, analytics and deliverability tooling. Alongside the tools it ships prompts your client shows as slash-commands and read-only resources an agent can attach without spending a call. It runs locally over stdio or as a remote streamable-HTTP endpoint at https://api.misar.io/mail/mcp.
What you get
- Transactional and inbox: send_email from a verified sender, list_emails with full-text search over subject and body, get_email, reply_to_email with the threading headers derived from the original, archive_email, and validate_email for syntax, MX records, disposable domains and role accounts
- Campaigns are deliberately two steps: create_campaign only drafts, get_campaign shows the content, audience and the sent, opened, clicked, bounced and complained counts, and send_campaign is what actually delivers — now or at scheduled_at
- Contacts: list_contacts, create_contact, update_contact, import_contacts up to 5,000 in one call with per-row results showing which rows were rejected and why, and get_contact_score for engagement tier and churn risk — or the lowest-engagement contacts when you name none
- Templates carry {{variable}} placeholders and render_template returns the substituted HTML and subject, so personalisation can be checked before anything is sent
- Automations are created paused: create_automation takes a trigger and ordered steps, get_automation returns every step with its delay and completion stats, toggle_automation starts enrolling contacts
- A/B tests send a sample percentage first and select_ab_test_winner delivers the winner to the audience held back; generate_subject_lines produces the variants to test
- Deliverability is a full shelf: get_deliverability_score returns 0-100 with a letter grade and the factors dragging it down, run_deliverability_audit covers SPF/DKIM/DMARC, domain reputation, list hygiene, content signals and blocklists, check_dmarc reports the exact record to publish for any domain, get_warmup_status gives today's remaining send capacity, and add_domain, verify_domain and configure_inbound_domain handle the DNS
- Analytics: get_analytics by day, week or month, generate_report as campaign_performance, engagement_funnel, cohort_analysis or send_time_heatmap, plus get_revenue_attribution and get_monetization_stats. Sandbox mode intercepts sends rather than delivering them, and list_sandbox_sends shows what was captured
Requirements
Runs over stdio as npx -y @misarmail/mcp@latest, or as a remote server at https://api.misar.io/mail/mcp with Authorization: Bearer msk_…. Two ways in: set MISARMAIL_API_KEY from mail.misar.io/developers, or start with no key and call the login tool, which opens the consent screen and saves the returned key to ~/.misarmail/config.json. MISARMAIL_BASE_URL points the client at a self-hosted instance. Discovery works without credentials; every action needs them. MIT.
Setup effort
One command — npx -y @smithery/cli install misar/misarmail-mcp --client claude
USE CASES
01
Sending one email properly from your own domain
Check which sender domains are verified, validate the recipient address before you spend reputation on it, and send. An unverified sender is the usual cause of a rejected send.
02
Getting a campaign out without an accident
Draft it, read back the audience and content, then send as a separate call. Nothing leaves until that second step, and a schedule is just an argument on it.
03
Finding out why emails are landing in spam
Start with the account score and the factors behind it, run the full audit across authentication, reputation, hygiene and blocklists, then check what the DNS actually resolves to today.
04
Cleaning a list before a big send
Find the unsubscribed and bounced addresses, score the rest for engagement and churn risk, and mark the ones that should stop receiving mail.
05
Building a welcome series and testing it on nobody
Create the workflow with its trigger and step delays, preview the rendered template with sample variables, and let sandbox mode capture the sends until the sequence reads right.
06
Testing a subject line before committing the whole list
Generate variants, run them against a sample of the audience, and release the winner to everyone who was held back once the results are in.
07
Reporting on what email actually earned
Delivery and engagement grouped by period, a structured report over a date range, and revenue attributed per campaign and per contact from tracked conversions.
57 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
archive_email
Move an email to the archive folder. Reversible — the message is not deleted.
auth_status
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.
categorize_inbox_emails
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.
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.
clear_sandbox
Delete every captured sandbox email. Affects only intercepted test messages, never real sent mail.
configure_inbound_domain
Configure inbound email routing for a subdomain so replies land in the MisarMail unified inbox. Returns the MX record to publish.
create_ab_test
Create an A/B test on a campaign with two or more variants. A sample percentage is sent first; the winner goes to the remainder once selected.
create_automation
Create an automation workflow from a trigger and an ordered list of steps. Created paused by default — call toggle_automation to activate once the steps are reviewed.
create_campaign
Create a new email marketing campaign as a draft. Creating never sends — call send_campaign separately once the content and audience are confirmed.
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.
create_landing_page
Create a hosted landing page with an email capture form. Returns the public URL; subscribers flow straight into your contact list.
create_template
Create a reusable email template. Use {{variable}} placeholders for personalisation — they are substituted at send time and previewable via render_template.
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).
generate_subject_lines
Generate AI subject-line variants for a campaign topic, optionally tuned to a tone and audience. Good input for create_ab_test.
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_automation
Get one automation workflow in full: trigger, every step with its delay, and per-step completion stats.
get_campaign
Get full details for one campaign: content, audience segment, schedule, and delivery statistics (sent, opened, clicked, bounced, complained).
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.
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.
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.
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.
get_inbox_conversation_messages
Get every message in one inbox conversation, oldest first, with sender and timestamps.
get_integration
Get one integration's configuration, scopes, and last sync result.
get_marketplace_item
Get one marketplace listing with its full preview, author, and install count.
get_monetization_stats
Get newsletter monetization stats: paid subscribers, MRR, churn, and sponsorship revenue for the period.
get_revenue_attribution
Attribute ecommerce revenue to email — revenue per campaign, per contact, and average order value from tracked conversions.
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.
import_contacts
Bulk-import up to 5,000 contacts in one call. Existing addresses are updated rather than duplicated. Returns per-row results so you can see which rows were rejected and why.
list_ab_tests
List A/B tests with per-variant results and whether a winner has been selected yet.
list_api_keys
List API keys on the account with their scopes and last-used time. Key secrets are never returned — only metadata.
list_automations
List automation workflows (welcome series, re-engagement, drip sequences) with their trigger type and active state.
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.
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.
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.
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.
list_forms
List signup forms with their embed status and conversion counts.
list_inbox_conversations
List unified-inbox conversations (threads) with their status and detected intent. Use this for triage; use list_emails for individual messages in a folder.
list_integrations
List connected third-party integrations and their sync status.
list_marketplace_items
Browse the MisarMail template marketplace for ready-made email and automation templates.
list_sandbox_sends
List emails captured by sandbox mode. Sandbox intercepts sends instead of delivering them — use it to verify templates and automations without emailing anyone.
list_templates
List saved email templates with their variable placeholders, so you can pick one for a campaign or transactional send.
login
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.
logout
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.
render_template
Render a template with sample variables and return the resulting HTML and subject. Use this to preview personalisation before sending anything.
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.
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.
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.
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.
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.
toggle_automation
Activate or pause an automation. Activating starts enrolling contacts and sending on the configured schedule.
toggle_integration
Enable or disable an integration. Disabling stops all syncing but preserves the stored credentials.
update_contact
Update an existing contact by email address, including changing subscription status. Setting status to unsubscribed immediately excludes them from every future campaign.
upgrade
Show the current MisarMail plan, how much of each quota is left, and what upgrading unlocks. Call it any time — not only after hitting a limit. Set open=true to open the checkout page in the default browser.
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.
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.
BEFORE YOU INSTALL
What to know first
Tools you get
57 tools when we connected. login, logout and auth_status handle authentication; the other 54 are product tools. Every tool lists without credentials, but none works without a key or a browser login.
Requires
npx on PATH
Optional
MISARMAIL_API_KEY in your environment
CONTEXT COST
Moderate Standing cost
Rated by the size of the 57 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
npx
Claude Desktop — Smithery
TERMINAL
npx -y @smithery/cli install misar/misarmail-mcp --client claudeHosted endpoint
ENDPOINT URL
https://api.misar.io/mail/mcpAdd this hosted endpoint to your MCP client.
MCP Clients
Claude Code
CLAUDE CODE · TERMINAL
claude mcp add misarmail -- npx -y @misarmail/mcp@latestAny MCP client — npx
ANY MCP CLIENT — NPX · JSON
{
"mcpServers": {
"misarmail": {
"command": "npx",
"args": [
"-y",
"@misarmail/mcp@latest"
],
"env": {
"MISARMAIL_API_KEY": "<YOUR_MISARMAIL_API_KEY>"
}
}
}
}Any MCP client — Remote
ANY MCP CLIENT — REMOTE · JSON
{
"mcpServers": {
"misarmail": {
"type": "streamable-http",
"url": "https://api.misar.io/mail/mcp",
"headers": {
"Authorization": "Bearer <YOUR_MISARMAIL_API_KEY>"
}
}
}
}Clients spell the "type" value differently: Claude Code and VS Code use "http", Cline uses "streamableHttp", and Roo Code uses "streamable-http". Claude Desktop does not accept a URL entry in its config file; remote servers go under Settings → Connectors.
