MisarMail MCP Server

Full email marketing platform accessible via Model Context Protocol

---

What is MisarMail MCP?

MisarMail MCP exposes the full MisarMail email marketing platform as a set of Model Context Protocol tools — making it directly callable from any MCP-compatible AI client.

Capability	Details
Tools	32 tools across email, campaigns, contacts, templates, automations, analytics, and more
Skills	11 pre-built skills for common workflows
Prompts	5 guided prompts
Transport	HTTP (Streamable HTTP)
Auth	OAuth 2.0 (PKCE) + API Key
Server URL	https://mail.misar.io/api/mcp

With MisarMail MCP, your AI assistant can send emails, manage contacts, create and launch campaigns, run A/B tests, check deliverability health, generate AI subject lines, send WhatsApp messages, and produce revenue analytics — all through natural language.

---

Quick Start

Pick your AI client and add MisarMail in under 60 seconds.

Claude Desktop / Claude Code

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json or Cursor → Settings → MCP):

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

VS Code (GitHub Copilot)

Add to .vscode/mcp.json in your workspace, or to your user settings:

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

Cline

Add to your Cline MCP configuration:

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

Windsurf

Add to your Windsurf MCP settings:

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

Docker (self-hosted proxy)

Run a local MCP proxy container that forwards to mail.misar.io/api/mcp:

docker run -p 3000:3000 ghcr.io/mrgulshanyadav/misarmail-mcp

Then point your client to http://localhost:3000.

npm

Run the MCP server directly without Docker:

npx misarmail-mcp-server

---

Authentication

MisarMail MCP supports two authentication methods:

OAuth 2.0 (Recommended)

OAuth 2.0 with PKCE is handled automatically by clients like Claude Desktop — you will be redirected to mail.misar.io to authorize and the token is managed for you. No manual setup required.

API Key

For programmatic access or clients that do not support OAuth:

1. Generate an API key at mail.misar.io/developers
2. Pass it as a Bearer token in the Authorization header:

Authorization: Bearer msk_your_api_key_here

API keys start with msk_.

---

Tools Reference

32 tools organized by category:

Category	Tool	Description
Email	email.list	List emails from inbox, sent, archive, or any folder
Email	email.read	Read a specific email by ID
Email	email.send	Send a transactional or marketing email
Email	email.reply	Reply to an existing email thread
Email	email.archive	Archive an email
Campaigns	campaign.list	List email marketing campaigns
Campaigns	campaign.get	Get details of a specific campaign
Campaigns	campaign.create	Create a new email marketing campaign
Campaigns	campaign.send	Send or schedule a campaign
Contacts	contact.list	List contacts from your contact lists
Contacts	contact.add	Add a new contact
Contacts	contact.update	Update an existing contact
Contacts	contact.score	Get contact engagement score, tier, and churn risk
Templates	template.create	Create a reusable email template
Analytics	analytics.get	Get campaign and deliverability analytics
Warmup	warmup.get	Get IP warmup status and progress
Deliverability	account.score	Get deliverability score (0–100) and grade (A–F)
Deliverability	dmarc.check	Check domain DMARC/SPF/DKIM health
Deliverability	deliverability.audit

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