MCP Server

Cleanmails includes a built-in Model Context Protocol (MCP) server that lets you control your outreach platform directly from AI coding assistants like Claude Desktop, Cursor, or any MCP-compatible client.

What is MCP?

MCP (Model Context Protocol) is an open standard that allows AI assistants to interact with external tools. The Cleanmails MCP server exposes your campaigns, senders, domains, and lists as tools that an AI can read and control.

Available Tools

Setup for Claude Desktop

{
  "mcpServers": {
    "cleanmails": {
      "command": "/path/to/cleanmails-mcp",
      "args": [
        "--api-url", "https://your-cleanmails-domain.com",
        "--api-key", "YOUR_AUTH_TOKEN"
      ]
    }
  }
}

Setup for Cursor

The same binary works with Cursor. Add it to your .cursor/mcp.json:

{
  "mcpServers": {
    "cleanmails": {
      "command": "/path/to/cleanmails-mcp",
      "args": ["--api-url", "https://your-domain.com", "--api-key", "YOUR_TOKEN"]
    }
  }
}

Environment Variables

Instead of CLI flags, you can use environment variables:

Example Usage

Once connected, you can ask your AI assistant things like:

• "Show me my campaign stats for this week"
• "Pause the Q2 Outreach campaign"
• "Verify the email john@example.com"
• "Which senders have low health scores?"
• "Trigger validation on my Enterprise Leads list"
• "What's my reply rate over the last 14 days?"

Troubleshooting