Quickstart

Supercharge your AI assistant with native email infrastructure capabilities. Once connected, your AI can compose emails, query sending quotas, inspect delivery logs, and manage subscriber audiences directly within your conversational flow.

Get your Mailofly API Key

Generate an API key with send or full access permissions from the Mailofly Dashboard.

mf_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Keep your API key secure. We recommend storing it as an environment variable or referencing your secrets manager in production configurations.

Add Mailofly to your AI Assistant

Mailofly runs via npx with zero local installation. Select your editor below to configure the MCP server:

Cursor
Google Antigravity
Claude Desktop
Windsurf

Or add to .cursor/mcp.json (or Cursor Settings > Features > MCP):

{
  "mcpServers": {
    "mailofly": {
      "command": "npx",
      "args": ["-y", "@mailofly/mcp"],
      "env": {
        "MAILOFLY_API_KEY": "mf_live_your_api_key_here"
      }
    }
  }
}

Install with a single CLI command:

agy mcp add mailofly -- npx -y @mailofly/mcp

Or add to your .gemini/antigravity-ide/mcp_config.json or ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "mailofly": {
      "command": "npx",
      "args": ["-y", "@mailofly/mcp"],
      "env": {
        "MAILOFLY_API_KEY": "mf_live_your_api_key_here"
      }
    }
  }
}

Open your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the mailofly entry under mcpServers:

{
  "mcpServers": {
    "mailofly": {
      "command": "npx",
      "args": ["-y", "@mailofly/mcp"],
      "env": {
        "MAILOFLY_API_KEY": "mf_live_your_api_key_here"
      }
    }
  }
}

In Windsurf, open Settings > Cascade > MCP Servers, or update ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "mailofly": {
      "command": "npx",
      "args": ["-y", "@mailofly/mcp"],
      "env": {
        "MAILOFLY_API_KEY": "mf_live_your_api_key_here"
      }
    }
  }
}

Verify the connection

Restart your editor or reload MCP servers. Ask your AI assistant to check your account status:

Check my Mailofly email sending quota and verified domains.

Your AI will call mailofly_get_usage and mailofly_list_domains, returning your plan limits, current usage, and DNS verification statuses in seconds.

What you can ask your AI

Here are a few real-world examples you can paste directly into your AI chat:

Send a transactional or test email

Send a test welcome email from alex@yourdomain.com to user@example.com
with the subject 'Welcome to our platform' and a clean HTML card welcoming them.

Inspect delivery status and logs

Look up the delivery status and error logs for the email sent to alex@example.com.

Manage audiences and subscribers

Add sarah@example.com to our 'Beta Testers' audience segment with the tag 'vip'.

Check domain DNS and authentication

Show the SPF, DKIM, and DMARC verification status for yourdomain.com.

Interactive Debugging (MCP Inspector)

If you’d like to test tools and inspect parameters in a graphical browser interface outside your editor:

MAILOFLY_API_KEY=mf_live_your_api_key npx @modelcontextprotocol/inspector npx -y @mailofly/mcp

(On Windows PowerShell):

$env:MAILOFLY_API_KEY="mf_live_your_api_key"; npx @modelcontextprotocol/inspector npx -y @mailofly/mcp

This launches the official web-based MCP Inspector, allowing you to manually trigger tools, preview resource payloads, and inspect schema responses.

Next Steps

Client Setup

Detailed configuration instructions for Cursor, Claude, Antigravity, Windsurf, Zed, and Cline.

Available Tools

Explore all 19 tools with parameter references and practical prompt examples.

MCP Resources

Understand how AI assistants use live URI resources for automatic context grounding.

Get started

Learn

MCP Server

Resources

MCP Quickstart

Quickstart

What you can ask your AI

Interactive Debugging (MCP Inspector)

Next Steps

Client Setup

Available Tools

MCP Resources

​Quickstart

​What you can ask your AI

​Interactive Debugging (MCP Inspector)

​Next Steps

Client Setup

Available Tools

MCP Resources

Quickstart

What you can ask your AI

Interactive Debugging (MCP Inspector)

Next Steps