# mailfloss

> mailfloss is a paid MCP server for marketing and seo. Verify email addresses and lists, check credits and manage integrations from an agent. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, Web
- **Website:** https://developers.mailfloss.com/mcp
- **MCP Registry name:** com.mailfloss/mailfloss
- **Categories:** marketing and SEO, communication
- **Listing updated:** 2026-11-16

## About

mailfloss exposes its v1 REST API as MCP tools so an agent can verify an address or a whole list in the middle of a task. Each tool call is the same REST call with your credentials, with the same org scoping, credits, rate limits and error format.

Verifying one email costs one credit, and a batch costs one credit per email. Batch tools start a job, read its status and results, and cancel it with a refund for unprocessed credits. Account tools return the organization, account, usage report and jobs, and integration tools list, test, resync, update and disconnect email-platform connections. The page's example asks whether a Klaviyo integration is still connected.

Sign in uses OAuth with a browser approval, or an API key sent as a Bearer header; a key in the URL fails with 401. No tool takes email-platform credentials, and keyword rules, webhooks and some account functions are not yet available. Tools that spend credits or change the account are annotated so clients can ask for confirmation.

## Features

- **Single verification:** verify_email checks one address for one credit.
- **Batch verification:** Start, monitor and cancel list verification jobs.
- **Credit and usage views:** Check account, organization and usage reports.
- **Integration management:** List, test, resync, update and disconnect connections.
- **Tool annotations:** Read-only and destructive hints guide client confirmations.
- **OAuth or API key:** Sign in with a browser or send a Bearer API key.

## Good for

- Verify an address before adding it to a newsletter
- Check a list of 40 addresses for undeliverable ones
- See how many credits remain this month
- Confirm an email-platform integration still works

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mailfloss https://api.mailfloss.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.mailfloss.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mailfloss": {
      "url": "https://api.mailfloss.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mailfloss": {
      "type": "http",
      "url": "https://api.mailfloss.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mailfloss": {
      "serverUrl": "https://api.mailfloss.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mailfloss": {
      "type": "http",
      "url": "https://api.mailfloss.com/mcp"
    }
  }
}
```

## Tools

- `verify_email`: Verifies one email address.
- `start_batch_verification`: Starts a batch verification job.
- `get_batch_status`: Returns a batch job's status.
- `get_batch_results`: Returns a batch job's results.
- `cancel_batch`: Cancels a batch and refunds unprocessed credits.
- `get_organization`: Returns the organization.
- `get_account`: Returns the account.
- `list_integrations`: Lists integrations.
- `get_integration`: Returns one integration type.
- `get_connection`: Returns one connection.
- `update_settings`: Updates a connection's settings.
- `disconnect_integration`: Disconnects a connection.
- `resync_integration`: Refreshes stored audiences.
- `test_integration`: Tests a connection.
- `get_usage_report`: Returns a usage report.
- `list_jobs`: Lists jobs.

## FAQ

### What does a verification cost?

One credit per single call and one credit per email in a batch.

### Can I get credits back on a cancelled batch?

Yes, cancel_batch refunds unprocessed credits.

### How do I authenticate?

OAuth sign-in or an API key as a Bearer header.

### What is not supported yet?

Keyword rules, webhooks, users, erasures, account updates, the activity timeline and single-job details.

### Is mailfloss free?

No. mailfloss is a paid product.

### How do I add mailfloss to Claude Code?

Run this command in your terminal: claude mcp add --transport http mailfloss https://api.mailfloss.com/mcp

### What are the best alternatives to mailfloss?

The closest alternatives to mailfloss are Google Ads + Meta Ads + SEO/GEO MCP, Calven, MCP, BoardAgent and Callout.

## Alternatives

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.

---
Source: https://ai-powered.com/mcp/mailfloss
