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

# Client Integration Guides

> One-click install buttons and step-by-step setup guides for Cursor, Google Antigravity, Claude Desktop, Windsurf, VS Code, and Zed.

# Client Integration Guides

Connect the Mailofly MCP server to your AI editor with a single click or a quick configuration snippet.

Mailofly MCP supports **two transports**:

| Transport | Best for | Requires |
| :- | :- | :- |
| **Hosted URL (SSE)** | Claude.ai, Smithery, web-based clients | Nothing — just a URL |
| **Stdio (npx)** | Cursor, Claude Desktop, Windsurf, Zed, VS Code | Node.js 18+ |

***

## One-Click & Quick Add

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

[Add to Antigravity](#google-antigravity)

[Add to Claude](#claude-desktop)

***

## Hosted URL (SSE) — Zero Install

For clients that accept an MCP server URL instead of a command, use the Mailofly hosted endpoint:

```
https://mcp.mailofly.com/sse
```

Pass your API key as a query parameter:

```
https://mcp.mailofly.com/sse?key=mf_live_your_api_key_here
```

> [!TIP]
>
> The hosted server auto-suspends when idle and wakes instantly on connection. It runs across **Singapore** and **London** via Fly.io for low-latency access worldwide.

### Claude.ai

1. Open [claude.ai](https://claude.ai) and go to **Settings** → **Integrations**.
2. Click **Add Integration** → **Add custom integration**.
3. Set the **MCP Server URL** to:
   ```
   https://mcp.mailofly.com/sse?key=mf_live_your_api_key_here
   ```
4. Click **Add**. Mailofly tools appear automatically in your Claude.ai chats.

### Smithery

Search for **Mailofly** on [smithery.ai](https://smithery.ai) or configure directly with:

```
https://mcp.mailofly.com/sse?key=mf_live_your_api_key_here
```

### Any SSE-Compatible Client

Any client that supports the MCP SSE transport can connect using the URL above. If your client requires separate SSE and POST endpoints:

| Endpoint | URL |
| :- | :- |
| **SSE (handshake)** | `https://mcp.mailofly.com/sse?key=YOUR_KEY` |
| **Messages (POST)** | `https://mcp.mailofly.com/messages` |

Include the `Authorization: Bearer YOUR_API_KEY` header on `POST /messages` requests.

***

## Stdio (npx) — Local Editors

Select your environment below to view tailored installation options and configuration snippets:

> [tab] Cursor
>
> ### Method A: One-Click Deep Link
>
> Click the button below to trigger Cursor's automated MCP installation dialog:
>
> [![Install in Cursor](https://img.shields.io/badge/Install%20in%20Cursor-000000?style=for-the-badge\&logo=cursor\&logoColor=white)](cursor://anysphere.cursor-deeplink/mcp/install?name=mailofly\&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtYWlsb2ZseS9tY3AiXSwiZW52Ijp7Ik1BSUxPRkxZX0FQSV9LRVkiOiJZT1VSX0FQSV9LRVkifX0=)
>
> ***
>
> ### Method B: Project Configuration (Recommended)
>
> Create or edit `.cursor/mcp.json` in your repository root:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "mailofly": {
>       "command": "npx",
>       "args": ["-y", "@mailofly/mcp"],
>       "env": {
>         "MAILOFLY_API_KEY": "mf_live_your_api_key_here"
>       }
>     }
>   }
> }
> ```
>
> ***
>
> ### Method C: Global GUI Setup
>
> 1. Open **Cursor Settings** (`Cmd + ,` on macOS or `Ctrl + ,` on Windows).
> 2. Navigate to **Features** > **MCP**.
> 3. Click **+ Add New MCP Server**.
> 4. Fill in:
>    * **Name**: `mailofly`
>    * **Type**: `command`
>    * **Command**: `npx -y @mailofly/mcp`
> 5. Add environment variable `MAILOFLY_API_KEY`.
> 6. Click **Save**.

> [tab] Google Antigravity
>
> ### Method A: Configuration File (Recommended)
>
> Add the `mailofly` server to your global user configuration (`~/.gemini/config/mcp_config.json` on macOS/Linux, or `%USERPROFILE%\.gemini\config\mcp_config.json` on Windows):
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "mailofly": {
>       "command": "npx",
>       "args": ["-y", "@mailofly/mcp"],
>       "env": {
>         "MAILOFLY_API_KEY": "mf_live_your_api_key_here"
>       }
>     }
>   }
> }
> ```
>
> You can also define it at the project level in `.gemini/antigravity-ide/mcp_config.json`.
>
> ***
>
> ### Method B: Antigravity CLI
>
> If you have the Antigravity CLI (`agy`) installed in your PATH:
>
> ```bash theme={null}
> agy mcp add mailofly -- npx -y @mailofly/mcp
> ```
>
> > [!TIP]
> >
> > Antigravity autonomous agents automatically detect Mailofly tools during execution loops, allowing agents to check sending quotas, review delivery logs, or trigger test emails autonomously.

> [tab] Claude Desktop
>
> ### Method A: Claude Code (CLI)
>
> If you use Claude Code in your terminal, add Mailofly with a single command:
>
> ```bash theme={null}
> claude mcp add mailofly -- npx -y @mailofly/mcp
> ```
>
> ***
>
> ### Method B: Claude Desktop Configuration
>
> Locate your `claude_desktop_config.json`:
>
> * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
> * **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
> * **Linux**: `~/.config/Claude/claude_desktop_config.json`
>
> Add `mailofly` to the `mcpServers` object:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "mailofly": {
>       "command": "npx",
>       "args": ["-y", "@mailofly/mcp"],
>       "env": {
>         "MAILOFLY_API_KEY": "mf_live_your_api_key_here"
>       }
>     }
>   }
> }
> ```
>
> > [!TIP]
> >
> > Restart Claude Desktop after saving. You will see a hammer icon 🔨 in the chat box showing that Mailofly tools are active.

> [tab] Windsurf
>
> ### Cascade MCP Configuration
>
> 1. Open Windsurf Settings (`Cmd + ,` or `Ctrl + ,`).
> 2. Navigate to **Advanced Settings** > **Cascade** > **Model Context Protocol (MCP)**, or edit `~/.codeium/windsurf/mcp_config.json`:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "mailofly": {
>       "command": "npx",
>       "args": ["-y", "@mailofly/mcp"],
>       "env": {
>         "MAILOFLY_API_KEY": "mf_live_your_api_key_here"
>       }
>     }
>   }
> }
> ```

> [tab] VS Code (Cline / Roo)
>
> ### Extension Configuration
>
> In VS Code with **Cline** or **Roo Code** installed:
>
> Open `cline_mcp_settings.json` (accessible by clicking the MCP icon in the extension sidebar) and add:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "mailofly": {
>       "command": "npx",
>       "args": ["-y", "@mailofly/mcp"],
>       "env": {
>         "MAILOFLY_API_KEY": "mf_live_your_api_key_here"
>       }
>     }
>   }
> }
> ```

> [tab] Zed
>
> ### Zed Assistant Configuration
>
> Open your Zed settings (`~/.config/zed/settings.json`) and configure the experimental MCP transport:
>
> ```json theme={null}
> {
>   "experimental": {
>     "model_context_protocol": {
>       "servers": {
>         "mailofly": {
>           "command": "npx",
>           "args": ["-y", "@mailofly/mcp"],
>           "env": {
>             "MAILOFLY_API_KEY": "mf_live_your_api_key_here"
>           }
>         }
>       }
>     }
>   }
> }
> ```

***

## Verifying Your Connection

Once configured in any client, start a new chat with your AI assistant and enter:

```markdown theme={null}
"Check my Mailofly email sending quota and list verified domains."
```

Your assistant will immediately invoke `mailofly_get_usage` and `mailofly_list_domains`, returning live status data from your account!


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