How do I install MisarMail MCP Server?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does MisarMail MCP Server need an API key?

The publisher lists these environment variables: MISARMAIL_API_KEY, MISARMAIL_BASE_URL.

What transport does MisarMail MCP Server use?

MisarMail MCP Server is reached over HTTP.

When was MisarMail MCP Server last checked?

Last checked 2026-11-09. Send transactional email, run campaigns, manage contacts and automations, audit deliverability.

MisarMail MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://api.misar.io/mail/mcp

Credentials from the publisher

MISARMAIL_API_KEY — Your MisarMail API key (msk_…). Create one at https://mail.misar.io/developers, or omit it and run the "login" tool to authenticate via browser.
MISARMAIL_BASE_URL — Override the API base URL. Only needed for self-hosted instances.

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http io.github.misar-ai-misarmail-mcp https://api.misar.io/mail/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.misar-ai-misarmail-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://api.misar.io/mail/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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

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.

MisarMail MCP Server

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install MisarMail MCP Server?

Does MisarMail MCP Server need an API key?

What transport does MisarMail MCP Server use?

When was MisarMail MCP Server last checked?

Documentation

MisarMail MCP Server

Install

Smithery (recommended)

Claude Code

Manual (any client)

Remote (no install)

Authentication

Tools

Prompts

Resources

Agent skills

Safety

Links