Mail7 Email Validation

Mail7 MCP 服务

为 AI 助手提供电子邮件验证。这是一个 MCP 服务，为 Claude、Cursor、Windsurf、Cline 和其他任何 MCP 客户端提供四种工具：验证单个地址、清理列表、检查域名的 SPF 记录，以及审计域名的完整邮件配置。

设计诚实：Mail7 会返回 Valid、Not Valid 或 Unknown，工具描述也会用通俗的语言告诉模型，Unknown 表示“无法验证”，而不是“无效”。使用此服务的助手不会悄悄删除无法检查的地址。

安装

需要 Node 18+。无需安装步骤——此服务通过 npx 运行。

Claude Code

claude mcp add mail7 --env MAIL7_API_KEY=your_key -- npx -y mail7-mcp

Claude Desktop（claude_desktop_config.json）、Cursor（~/.cursor/mcp.json）和大多数其他客户端使用相同的配置格式：

{
  "mcpServers": {
    "mail7": {
      "command": "npx",
      "args": ["-y", "mail7-mcp"],
      "env": { "MAIL7_API_KEY": "your_key" }
    }
  }
}

前往 mail7.net/account 获取 API 密钥。此服务也可在没有密钥的情况下运行，但匿名调用者每分钟最多只能进行 5 次检查，且免费批量样本仅限 25 个地址——不足以用于实际工作。

变量	默认值	用途
MAIL7_API_KEY	-	提高速率限制，解锁完整的批量验证
MAIL7_BASE_URL	https://mail7.net/api	覆盖 API 端点

工具

工具	功能
validate_email	单个地址：语法、MX、一次性邮箱域名检查、实时 SMTP 邮箱探测
validate_emails	每次调用最多 50 个地址，并提供 Valid / Not Valid / Unknown 汇总
check_domain	全面的邮件配置审计，评级为 A-F：MX、SPF、DKIM、DMARC、MTA-STS、TLS-RPT、DNSSEC、BIMI
check_spf	SPF 记录、机制、查询次数和配置错误

可以向助手提出如下请求：

• “[email protected] 是真实邮箱吗？”
• “清理这份注册列表，并告诉我哪些地址会退信。”
• “为什么我们发给客户的邮件会进入垃圾邮件？检查一下 ourdomain.com。”

结果格式

validate_email 和 validate_emails 除文本外还会返回结构化内容，因此支持结构化工具输出的客户端可以获取类型化字段：

{
  "email": "[email protected]",
  "status": "Unknown",        // "Valid" | "Not Valid" | "Unknown"
  "valid": null,              // true | false | null (null = Unknown)
  "formatValid": true,
  "mxValid": true,
  "smtpValid": false,
  "is_disposable": false,
  "details": "Server accepts all addresses (catch-all) - status unknown"
}

check_domain 会返回简洁的评级摘要，并为每个问题提供修复方法。如需查看某一部分的原始记录，可再次调用此工具，并将 section 设为 mx、spf、dkim、dmarc、mta_sts、tls_rpt、dnssec、bimi 或 domain。

大型列表注意事项

每个地址都会进行实时 SMTP 会话，因此一次检查需要几秒钟，而不是几毫秒。validate_emails 每次调用最多处理 50 个地址，这是有意设置的限制——请分批重复调用，而不是一次性提交整个文件；也不要并行运行两个调用（API 每个客户端一次只会串行处理一个批量任务）。

开发

npm install
npm run build      # -> dist/
node dist/index.js # speaks MCP over stdio

许可证

MIT。属于 Mail7 integrations。