mcp-email-verifier

Email Verifier MCP 服务

这是一个 MCP 服务，用于调用 Mamba Labs 在 Apify 上的 Email List Verifier, Bring Your Own Key Actor。提供一组电子邮件地址后，它会使用你已付费订阅的验证服务逐一检查：ZeroBounce、NeverBounce、MillionVerifier、BounceBan 或 Reoon Email Verifier。你需要提供服务密钥。

内容

• 功能
• 快速开始
• 前提条件
• 提示词示例
• 工具
• 输入
• 定价
• 你的密钥
• Actor 完整文档
• 许可证

功能

• 每个地址一行，格式统一：包含 verdict（valid、invalid、catch_all、risky 或 unknown）、服务自身的 provider_status 和 provider_sub_status、is_role、is_free_email、is_disposable，以及用于提供拼写修正建议的 did_you_mean。
• 所有服务采用统一格式：五种服务的结果表述各不相同；每行都会使用相同的五种判定结果和相同的列。
• 保护额度：语法错误的地址不会发送出去，重复地址只检查一次，而密钥被拒绝或服务余额不足时，会停止发送更多请求。

无效输入会返回一条免费的记录，其 error_reason 以 input_invalid: 开头。如果没有设置密钥，工具会在运行开始前拒绝请求，因此不会产生费用。

所有工作都在 Apify 上运行。此软件包是一个轻量客户端，负责启动 Actor 运行、等待运行完成，并返回数据集中的行。

快速开始

你需要 Node.js 18 或更高版本、一个带有 API 令牌的 Apify 账户，以及五种服务之一的 API 密钥。

将以下内容添加到 Claude Desktop 配置文件（claude_desktop_config.json）、Cursor 或任何 MCP 客户端中：

{
  "mcpServers": {
    "mamba-email-verifier": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-email-verifier"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token",
        "EMAIL_VERIFIER_API_KEY": "your-verification-service-key"
      }
    }
  }
}

重启客户端。随后会显示 verify_emails 工具。

前提条件

• Node.js 18 或更高版本。
• 从 console.apify.com/account/integrations 获取 Apify API 令牌，并将其设置为 APIFY_TOKEN。不提供令牌时，服务仍会列出工具；调用工具则需要令牌。
• 你自己的 ZeroBounce、NeverBounce、MillionVerifier、BounceBan 或 Reoon Email Verifier API 密钥，并将其设置为 EMAIL_VERIFIER_API_KEY。

提示词示例

• “用我的 NeverBounce 密钥验证这 40 个地址，并列出无效的地址。”
• “这些潜在客户中，哪些是 catch all 地址或角色地址？”
• “检查 [email protected]，并告诉我这个域名看起来是否有拼写错误。”

工具

verify_emails。一个工具。示例参数：

{
  "emails": [
    "[email protected]",
    "[email protected]"
  ],
  "provider": "neverbounce"
}

输入

该 Actor 面向购买者的所有输入，但 api_key 除外。api_key 来自服务器环境中的 EMAIL_VERIFIER_API_KEY，因此不会经过对话。省略的输入将使用 Actor 自带的默认值。数字以字符串形式发送。

输入	类型	描述
emails	array	必填。要验证的地址，每次运行 1 到 5,000 个
email	string	另一个地址，将添加到 emails
provider	string	zerobounce（默认）、neverbounce、millionverifier、bounceban 或 reoon。你的密钥所属的服务
concurrency	string	同时检查的地址数，1 到 20。默认值为 5
max_charge_usd	string	可选。如果 Actor 的收费将超过此金额，则在收费前停止运行

定价

两笔独立费用。你的验证服务会按照你的套餐价格，向你的账户收取每次检查的费用。Actor 在 Apify 上按事件收费，费用计入你的 Apify 账户。价格以 USD 计。

事件	免费套餐	Bronze	Silver	Gold
email-verified，你的服务判定为有效、无效、接受所有邮件或有风险的单个地址	$0.0016	$0.00152	$0.00144	$0.00136
apify-actor-start，每次运行启动	$0.0006	$0.0006	$0.0006	$0.0006

未知结果、错误行、语法错误的地址、同一次运行中的重复地址以及被拒绝的输入均免费。Mamba Labs 承担此次运行的 Apify 平台费用。

你的密钥

密钥从此服务器的环境中读取，并作为机密字段传入运行输入。Actor 只会将密钥发送给你选择的服务，不会记录、存储或返回密钥。Apify 会封锁外发邮件端口，因此每次邮箱检查都由你的服务执行。

Actor 完整文档

apify.com/mambalabs/email-verifier

许可证

MIT。请参阅 LICENSE。