> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Equip your AI assistants and autonomous agents with native email sending, contact management, and delivery intelligence.

# Mailofly MCP Server

Connect your favorite AI coding assistants and autonomous agents directly to your Mailofly workspace using the **[Model Context Protocol (MCP)](https://modelcontextprotocol.io/)**.

With Mailofly MCP, your AI assistant can dispatch transactional emails, manage contacts, check real-time delivery logs, inspect DNS records, and build email templates directly inside your editor.

Mailofly MCP is available in **two transport modes** — choose the one that fits your client:

> [card] Instant Email Dispatch
>
> Send single emails or bulk batches with custom HTML, attachments, and scheduling.

> [card] Audience Management
>
> Create, query, and segment contacts dynamically through natural language.

> [card] Live Deliverability Data
>
> Monitor sent volumes, bounce rates, and open tracking directly inside your chat.

> [card] Domain & DNS Verification
>
> Inspect SPF, DKIM, DMARC, and MX records without leaving your IDE.

***

## Supported AI Clients

The Mailofly MCP server is packaged as an executable via `npx` and works out-of-the-box with all major MCP-compatible environments:

> [card] [Cursor](/docs/mcp-server/clients.md#cursor)
>
> Full tool execution in Cursor Chat & Composer.

> [card] [Claude Desktop](/docs/mcp-server/clients.md#claude-desktop)
>
> Native tool call integration with Claude 3.5 Sonnet.

> [card] [Google Antigravity](/docs/mcp-server/clients.md#google-antigravity)
>
> Autonomous agent pairing with Mailofly capabilities.

> [card] [Windsurf](/docs/mcp-server/clients.md#windsurf)
>
> Native Cascade integration with Stdio MCP transport.

> [card] [Zed](/docs/mcp-server/clients.md#zed-editor)
>
> Native MCP server support in Zed's Assistant Panel.

> [card] [VS Code (Cline / Roo)](/docs/mcp-server/clients.md#vs-code-cline--roo-code)
>
> Autonomous dev agent support via VS Code extensions.

***

## One-Click Setup

Install Mailofly in your editor instantly:

[Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=mailofly\&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtYWlsb2ZseS9tY3AiXSwiZW52Ijp7Ik1BSUxPRkxZX0FQSV9LRVkiOiJZT1VSX0FQSV9LRVkifX0=)

[Add to Antigravity](/docs/mcp-server/clients.md#google-antigravity)

[Add to Claude](/docs/mcp-server/clients.md#claude-desktop)

***

## Transport Options

> [card] Stdio (npx)
>
> Runs locally via `npx`. Best for local editors like Cursor, Claude Desktop, Windsurf, and Zed. Requires Node.js.

> [card] Hosted HTTP/SSE
>
> Zero-install URL transport hosted at `mcp.mailofly.com`. Best for web-based AI clients like Claude.ai and any client that accepts an MCP URL.

***

## 30-Second Quickstart

> [tab] Stdio (npx)
>
> Add to your AI client's configuration file:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "mailofly": {
>       "command": "npx",
>       "args": ["-y", "@mailofly/mcp"],
>       "env": {
>         "MAILOFLY_API_KEY": "mf_live_your_api_key_here"
>       }
>     }
>   }
> }
> ```

> [tab] Hosted URL (SSE)
>
> For clients that accept an MCP server URL, use:
>
> ```
> https://mcp.mailofly.com/sse
> ```
>
> Pass your API key as a query parameter or as the `Authorization` header:
>
> ```
> https://mcp.mailofly.com/sse?key=mf_live_your_api_key_here
> ```
>
> > [!TIP]
> >
> > The hosted server runs on Fly.io across Singapore and London for low-latency access worldwide. No Node.js or local installation required.

> [!TIP]
>
> Grab your API key from the **[Mailofly Dashboard → Settings → API Keys](https://www.mailofly.com/user/settings/api-keys)**.

***

## What Can You Say to Your AI?

Once connected, you can interact with Mailofly using everyday natural language:

> [accordion] Sending & Scheduling Emails
>
> * *"Send a welcome email to [alex@example.com](mailto:alex@example.com) from [welcome@acme.com](mailto:welcome@acme.com) with the subject 'Welcome to Acme!'."*
> * *"Schedule a product update email to [beta-users@company.com](mailto:beta-users@company.com) to be sent in 3 hours."*
> * *"Cancel the scheduled email with ID `em_abc123`."*

> [accordion] Audience & Contact Synchronization
>
> * *"Add [sarah@acme.com](mailto:sarah@acme.com) to our contacts list with first name Sarah and company Acme."*
> * *"List the most recent 20 contacts in our audience."*
> * *"Remove the contact with ID `cnt_xyz789` from our audience."*

> [accordion] Template Design & Review
>
> * *"List all active email templates in our workspace."*
> * *"Show me the HTML body and placeholders of the 'Password Reset' template."*
> * *"Create a new reusable template named 'Order Confirmation' with an order summary table."*

> [accordion] Deliverability & Account Usage
>
> * *"What is our email sending volume and delivery rate over the last 14 days?"*
> * *"Check the DNS and DKIM verification status of sending domain acme.com."*
> * *"List all verified sender identities configured in our account."*

***

## Next Steps

> [card] [Client Integration Guides](/docs/mcp-server/clients.md)
>
> Copy-paste configurations for Cursor, Claude Desktop, Antigravity, and Windsurf.

> [card] [Tools Reference](/docs/mcp-server/tools.md)
>
> Full reference for all 19 tools across emails, contacts, campaigns, and domains.

> [card] [Live Resources](/docs/mcp-server/resources.md)
>
> Learn how agents use live workspace resources as ambient context.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.