{
  "markdown": "# MisarMail MCP Server\n\n> Send email, run campaigns, manage contacts and automations, A/B test, and audit deliverability — from any AI assistant.\n\n[![npm](https://img.shields.io/npm/v/@misarmail/mcp)](https://www.npmjs.com/package/@misarmail/mcp)\n[![smithery](https://img.shields.io/badge/smithery-misar%2Fmisarmail--mcp-blue)](https://smithery.ai/servers/misar/misarmail-mcp)\n[![license](https://img.shields.io/badge/license-MIT-green)](./LICENSE)\n\n**54 tools · 8 prompts · 4 resources · 8 agent skills**\n\nWorks with Claude (Desktop, Code, and web), Cursor, VS Code, Windsurf, Cline,\nZed, Gemini CLI, ChatGPT, and any other MCP-compatible client — over stdio or\nStreamable HTTP.\n\n---\n\n## Install\n\n### Smithery (recommended)\n\n```bash\nnpx -y @smithery/cli install misar/misarmail-mcp --client claude\n```\n\n### Claude Code\n\n```bash\nclaude mcp add misarmail -- npx -y @misarmail/mcp@latest\n```\n\n### Manual (any client)\n\n```json\n{\n  \"mcpServers\": {\n    \"misarmail\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@misarmail/mcp@latest\"],\n      \"env\": { \"MISARMAIL_API_KEY\": \"msk_your_key_here\" }\n    }\n  }\n}\n```\n\nReady-made configs for every client live in [`connectors/`](./connectors).\n\n### Remote (no install)\n\n```json\n{\n  \"mcpServers\": {\n    \"misarmail\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://api.misar.io/mail/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer msk_your_key_here\" }\n    }\n  }\n}\n```\n\n---\n\n## Authentication\n\nTwo options — no copy-paste needed for the first:\n\n1. **Browser login.** Start the server with no key and run the `login` tool.\n   It opens the MisarMail consent screen, you review the requested\n   permissions, and the key is delivered straight back and saved to\n   `~/.misarmail/config.json`.\n2. **API key.** Create one at https://mail.misar.io/developers and set `MISARMAIL_API_KEY`.\n\nSelf-hosted instances: set `MISARMAIL_BASE_URL`.\n\n---\n\n## Tools\n\n| Tool | Description |\n| --- | --- |\n| `send_email` | Send a transactional email from a verified MisarMail account. |\n| `list_emails` | List emails from a mailbox folder with optional full-text search across subject and body. |\n| `get_email` | Read the full content of a single email by ID, including headers, body, and attachments metadata. |\n| `reply_to_email` | Reply to an existing email thread. |\n| `archive_email` | Move an email to the archive folder. |\n| `validate_email` | Validate an email address before sending: syntax, MX records, disposable-domain and role-account detection. |\n| `list_campaigns` | List email marketing campaigns with their status, audience size, and headline metrics. |\n| `get_campaign` | Get full details for one campaign: content, audience segment, schedule, and delivery statistics (sent, opened, clicked, bounced, complained).. |\n| `create_campaign` | Create a new email marketing campaign as a draft. |\n| `send_campaign` | Send a campaign now, or schedule it for a future time by passing scheduled_at. |\n| `list_contacts` | List contacts with their subscription status and engagement metrics. |\n| `create_contact` | Add a single contact. |\n| `update_contact` | Update an existing contact by email address, including changing subscription status. |\n| `import_contacts` | Bulk-import up to 5,000 contacts in one call. |\n| `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. |\n| `list_templates` | List saved email templates with their variable placeholders, so you can pick one for a campaign or transactional send.. |\n| `create_template` | Create a reusable email template. |\n| `render_template` | Render a template with sample variables and return the resulting HTML and subject. |\n| `list_automations` | List automation workflows (welcome series, re-engagement, drip sequences) with their trigger type and active state.. |\n| `get_automation` | Get one automation workflow in full: trigger, every step with its delay, and per-step completion stats.. |\n| `create_automation` | Create an automation workflow from a trigger and an ordered list of steps. |\n| `toggle_automation` | Activate or pause an automation. |\n| `list_ab_tests` | List A/B tests with per-variant results and whether a winner has been selected yet.. |\n| `create_ab_test` | Create an A/B test on a campaign with two or more variants. |\n| `select_ab_test_winner` | Select the winning variant and send it to the remaining audience. |\n| `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.. |\n| `generate_report` | Generate a structured analytics report over a date range. |\n| `get_revenue_attribution` | Attribute ecommerce revenue to email — revenue per campaign, per contact, and average order value from tracked conversions.. |\n| `get_monetization_stats` | Get newsletter monetization stats: paid subscribers, MRR, churn, and sponsorship revenue for the period.. |\n| `get_deliverability_score` | Get the account deliverability score (0–100) and letter grade (A–F) with the factors dragging it down. |\n| `run_deliverability_audit` | Run a full deliverability audit across authentication (SPF/DKIM/DMARC), domain reputation, list hygiene, content signals, and blocklist status. |\n| `get_warmup_status` | Get IP/domain warm-up progress and today's remaining send capacity. |\n| `check_dmarc` | Check live SPF, DKIM, and DMARC DNS records for a domain and report alignment problems with the exact record to publish. |\n| `list_domains` | List sending domains with verification status and their DKIM/SPF/DMARC records. |\n| `add_domain` | Add a sending domain and return the DNS records to publish. |\n| `verify_domain` | Re-check a domain's DNS records and mark it verified if they resolve. |\n| `configure_inbound_domain` | Configure inbound email routing for a subdomain so replies land in the MisarMail unified inbox. |\n| `list_forms` | List signup forms with their embed status and conversion counts.. |\n| `get_form` | Get one signup form including its fields, embed code, and redirect behaviour.. |\n| `get_form_submissions` | List submissions for a signup form, including the submitted field values and timestamps.. |\n| `create_landing_page` | Create a hosted landing page with an email capture form. |\n| `list_marketplace_items` | Browse the MisarMail template marketplace for ready-made email and automation templates.. |\n| `get_marketplace_item` | Get one marketplace listing with its full preview, author, and install count.. |\n| `list_inbox_conversations` | List unified-inbox conversations (threads) with their status and detected intent. |\n| `get_inbox_conversation_messages` | Get every message in one inbox conversation, oldest first, with sender and timestamps.. |\n| `categorize_inbox_emails` | Run AI categorisation over a batch of inbox emails to label intent and priority. |\n| `list_api_keys` | List API keys on the account with their scopes and last-used time. |\n| `generate_subject_lines` | Generate AI subject-line variants for a campaign topic, optionally tuned to a tone and audience. |\n| `list_integrations` | List connected third-party integrations and their sync status.. |\n| `get_integration` | Get one integration's configuration, scopes, and last sync result.. |\n| `toggle_integration` | Enable or disable an integration. |\n| `list_sandbox_sends` | List emails captured by sandbox mode. |\n| `clear_sandbox` | Delete every captured sandbox email. |\n| `upgrade` | Show the current MisarMail plan, how much of each quota is left, and what upgrading unlocks. |\n\n## Prompts\n\nReusable workflows your client exposes as slash-commands.\n\n| Prompt | Description |\n| --- | --- |\n| `compose_email` | Draft a professional email and send it via MisarMail after confirmation. |\n| `campaign_performance_report` | Analyse campaign performance and produce prioritized improvements. |\n| `contact_import_guide` | Import and organise contacts safely, with consent and hygiene checks. |\n| `automation_builder_guide` | Design and build an email automation workflow step by step. |\n| `deliverability_improvement_plan` | Diagnose deliverability and produce a prioritized weekly action plan. |\n| `ab_test_plan` | Design a statistically meaningful A/B test for a campaign. |\n| `list_hygiene_audit` | Find and clean the contacts that are hurting sender reputation. |\n| `weekly_email_report` | Produce a stakeholder-ready weekly email performance summary. |\n\n## Resources\n\nRead-only context an agent can attach without spending a tool call.\n\n| URI | Description |\n| --- | --- |\n| `misarmail://account/domains` | Your sending domains with verification state and DNS records. |\n| `misarmail://account/deliverability` | Current account deliverability score (0–100), grade, and contributing factors.. |\n| `misarmail://account/warmup` | IP/domain warm-up stage and remaining send capacity for today — the ceiling a bulk send must stay under.. |\n| `misarmail://templates` | Saved templates with their declared variables, for reuse in campaigns and sends.. |\n\n## Agent skills\n\nBundled in [`skills/`](./skills) — guidance an agent loads when a task matches.\n\n| Skill | Use when |\n| --- | --- |\n| `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. |\n| `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. |\n| `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. |\n| `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\". |\n| `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. |\n| `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. |\n| `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. |\n| `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. |\n\n---\n\n## Safety\n\nDestructive and irreversible actions are annotated (`destructiveHint`) so\nclients can prompt before running them. The skills instruct agents to confirm\nbefore anything that sends mail, publishes content, or is otherwise visible to\nother people.\n\nDiscovery (`initialize`, `tools/list`, `prompts/list`, `resources/list`)\nnever requires credentials, so registries can index the server without one.\nEvery action does.\n\n---\n\n## Links\n\n- Website — https://www.misarmail.com\n- App — https://mail.misar.io\n- Documentation — https://docs.misar.io/mail/mcp\n- Smithery — https://smithery.ai/servers/misar/misarmail-mcp\n- Smithery skills — [send-transactional-email](https://smithery.ai/skills/misar/send-transactional-email), [run-email-campaign](https://smithery.ai/skills/misar/run-email-campaign), [ab-test-campaign](https://smithery.ai/skills/misar/ab-test-campaign), [build-email-automation](https://smithery.ai/skills/misar/build-email-automation), [clean-contact-list](https://smithery.ai/skills/misar/clean-contact-list), [setup-sending-domain](https://smithery.ai/skills/misar/setup-sending-domain), [audit-deliverability](https://smithery.ai/skills/misar/audit-deliverability), [email-performance-report](https://smithery.ai/skills/misar/email-performance-report)\n- npm — https://www.npmjs.com/package/@misarmail/mcp\n- Source — https://github.com/Misar-AI/misarmail-mcp\n\nMIT © [Misar AI](https://misar.io)\n",
  "bytes": 12395,
  "sha": "5b4dc8b0a6ebb551b11fd9f7d15881acae28d3718711efd9b21de6905fc8672b",
  "repo_slug": "mrgulshanyadav/misarmail-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mrgulshanyadav_misarmail_mcp_547b0f65/readme"
}