MCP Setup

Prerequisites

• A MisarMail API key with at least read + write + send scopes
• One of: Claude Desktop, Claude Code CLI, or any MCP-compatible client

Get an API key from Dashboard → Settings → API Keys.

Claude Desktop

Add the server to ~/.config/claude/claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "misarmail": {
      "url": "https://api.misar.io/mail/mcp",
      "headers": {
        "Authorization": "Bearer msk_YOUR_KEY"
      }
    }
  }
}

Restart Claude Desktop. You should see MisarMail in the tools panel.

Claude Code CLI

claude mcp add misarmail \
  --transport http \
  --url "https://api.misar.io/mail/mcp" \
  --header "Authorization: Bearer msk_YOUR_KEY"

Verify it was added:

claude mcp list

npm / stdio transport

Use the npm package for local stdio transport (useful when HTTP is blocked by a firewall, or for offline testing):

# Install globally
npm install -g misarmail-mcp-server

# Or run directly
npx misarmail-mcp-server --api-key msk_YOUR_KEY

Claude Desktop config for stdio:

{
  "mcpServers": {
    "misarmail": {
      "command": "npx",
      "args": ["misarmail-mcp-server", "--api-key", "msk_YOUR_KEY"]
    }
  }
}

{
  "mcpServers": {
    "misarmail": {
      "command": "npx",
      "args": ["misarmail-mcp-server"],
      "env": { "MISARMAIL_API_KEY": "msk_YOUR_KEY" }
    }
  }
}

Other MCP clients

Any client that supports Streamable HTTP transport can connect:

URL:    https://api.misar.io/mail/mcp
Auth:   Authorization: Bearer msk_YOUR_KEY
Method: POST (JSON-RPC 2.0)

Verifying the connection

Once connected, ask your AI assistant:

"Check my MisarMail deliverability score"

The assistant will call account.score and return your current score, grade, and any issues.

Or:

"List my recent email campaigns"

The assistant calls campaign.list and summarises your campaigns.

Guided prompts

The server ships 5 system prompts you can invoke directly:

| Prompt | What it does | |--------|-------------| | compose_email | Drafts a professional email ready to send | | campaign_performance_report | Summarises analytics and suggests improvements | | contact_import_guide | Walks through importing contacts step by step | | automation_builder_guide | Builds an automation workflow interactively | | deliverability_improvement_plan | Audits your score and creates an action plan |

In Claude, type / to see available prompts, or ask: "Use the deliverability improvement plan prompt".

Scopes required per tool category

| Category | Minimum scopes | |----------|---------------| | Email read/send | send, read | | Campaigns | read, write | | Contacts | contacts | | Analytics | analytics | | Deliverability | read | | Automation | read, write | | API keys | read |

For full access use a key with all scopes enabled.