mcpField
M
mcp-email-waterfall-orchestrator

mcp-email-waterfall-orchestrator

本地服务
github.com/mambalabsdev商业与营销01 周前更新

关于 mcp-email-waterfall-orchestrator

这是 Mamba Labs Work Email Waterfall Apify actor 的 MCP 服务。它使用调用方提供的服务商密钥搜索并验证工作邮箱,同时报告使用了哪些服务商及其实际支出。

主要功能

  1. 01搜索联系人的工作邮箱
  2. 02验证每个返回的地址
  3. 03使用调用方自有服务商密钥
  4. 04配置服务商和验证器顺序
  5. 05报告服务商尝试及支出
  6. 06返回联系人数据行和运行汇总

适用场景

  1. 01为联系人列表查找工作邮箱
  2. 02将地址加入外联前进行验证
  3. 03比较各服务商的结果和归属成本

MCP 相关

通过 `find_work_email` 工具向 MCP 客户端提供 Apify actor。该工具接收联系人和服务商配置,并返回结果及运行汇总。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"com-mambabuilt-mcp-email-waterfall-orchestrator": {
"command": "npx",
"args": [
"-y",
"@mambalabsdev/mcp-email-waterfall-orchestrator"
],
"env": {
"APIFY_TOKEN": "<APIFY_TOKEN>"
}
}
}
}
启动命令npx -y @mambalabsdev/mcp-email-waterfall-orchestrator
需要配置的环境变量
APIFY_TOKEN密钥Apify API token from https://console.apify.com/account/integrations

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@mambalabsdev/mcp-email-waterfall-orchestrator1.2.0

工具

1

收录的工具列表 · 更新于 2 周前

参数类型必填说明
contactsarray否每人一个对象。每个对象可包含 full_name、first_name、last_name、company_domain、company_name、linkedin_url 和 email。单个联系人也要放在包含一个对象的数组中。省略此参数或传入空数组时,运行会返回一行汇总,说明未尝试任何操作且未产生费用。
maxContactsinteger否处理联系人的数量上限。留空表示不设上限。
providerKeysobject否你自己的服务商 API 密钥,按服务商名称作为键。任何付费调用前都会免费验证。没有可用密钥的服务商会被移除并报告,不会导致运行失败。
providerOrderarray否按希望调用的顺序排列的注册表条目 ID。留空则使用 actor 的默认顺序。
providerRatesobject否可选的服务商或 provider.endpoint 到你自己的单位成本的映射,例如 {"findymail.search_name": 0.0198}。提供后,运行会按你的费率报告金额;留空则只报告单位数,因为无法获知你的套餐级别。
concurrencyHintinteger否仅供参考。实际调用节奏取决于各 endpoint 文档中规定的速率限制;这些限制按 endpoint 设置且覆盖多个时间窗口,因此此参数无法突破限制。
maxProviderUnitsinteger否本次运行可从你账户中消耗的服务商点数上限。达到上限后,剩余联系人会附带原因跳过,不会继续消耗点数。强烈建议设置。
verificationOrderarray否按顺序排列的验证器条目 ID。留空则使用 actor 的默认顺序。

详细介绍

工作邮箱瀑布式 MCP 服务

npm MCP License: MIT

Email Waterfall Orchestrator MCP 服务

这是 Mamba Labs 在 Apify 上的 Work Email Waterfall Actor 对应的 MCP 服务。

提供联系人和你自己的服务商 API 密钥。它会为每位联系人查找工作邮箱、验证邮箱,并准确告知每个服务商向你收取的费用。

工具

find_work_email

每位联系人返回一行扁平结果,包括未找到邮箱的联系人;另附一行汇总,列出本次运行总计:找到的地址、找到它的服务商、该服务商在链中的位置、尝试过的所有服务商、验证结论及其来源,以及消耗的服务商用量。

自带密钥

这正是它区别于按额度计费的丰富联系人信息工具之处。Mamba Labs 不提供服务商密钥,不会看到你的额度,也不会转售额度。本次运行会按你协商的费率从你的账户扣费,因此 maxProviderUnits 才会存在,也因此你应该设置它。

这种取舍两面都很坦诚:你保留自己的定价和服务商关系,同时自行承担费用。你获得的是真实的费用归属信息,而不是额度计数,因此可以看出究竟哪个服务商真正发挥了作用。

提供 providerRates 后,本次运行会按你的费率报告费用。留空则只报告用量,因为我们无法知道你的套餐等级,猜测只会得出一个看似确定但实际错误的数字。

遇到无效密钥时会怎样

不会有什么大问题。每个密钥都会在任何付费调用前免费验证。没有可用密钥的服务商会从调用链中移除并报告,而不是导致运行失败或悄悄消耗尝试次数。即使完全没有密钥,运行也会完成,并说明哪些功能不可用,而且不会产生任何费用。

验证并非事后才做

每个查找到地址的服务商之后都会立即进行验证,而不是等到最后统一验证,因为不同服务商对“找到”的定义并不一致。某个服务商认为已命中、但验证器判定无法投递的地址,算作未命中;你肯定希望在它进入邮件序列工具之前就知道这一点。

find_work_email

输入类型说明
contactsobject[]每人一个对象。可包含 full_name、first_name、last_name、company_domain、company_name、linkedin_url、email 中的任意字段。单个联系人也要放在长度为 1 的数组中。
providerKeysobject按服务商名称列出你自己的密钥。任何付费调用前都会免费验证。
providerOrderstring[]按调用顺序排列的注册表条目 ID。留空表示使用 Actor 的默认调用链。
verificationOrderstring[]按顺序排列的验证器条目 ID。留空表示使用 Actor 的默认设置。
maxContactsinteger处理联系人的数量上限。
maxProviderUnitsinteger本次运行从你的账户消耗的服务商额度上限。强烈建议设置。
providerRatesobject服务商或 provider.endpoint 到单位费用的映射,用于以美元报告费用。
concurrencyHintinteger仅供参考。实际调用节奏由每个端点自身的多窗口速率限制决定。
max_charge_usdnumber本次运行可选的美元费用上限。若处理某个项目可能导致费用超过此金额,Actor 会在处理该项目之前停止。

提供的信息越多,命中的可能性就越高。使用 LinkedIn URL 作为查找依据时,顶级服务商的命中率为 13.7%;同一小时内对同样的 300 位联系人使用姓名加域名查找时,命中率为 9.3%。

设置

{
  "mcpServers": {
    "mamba-email-waterfall-orchestrator": {
      "command": "npx",
      "args": ["-y", "@mambalabsdev/mcp-email-waterfall-orchestrator"],
      "env": { "APIFY_TOKEN": "your-apify-token" }
    }
  }
}

在 console.apify.com/account/integrations 获取令牌。每次调用都会从你自己的服务商账户扣费,并按提交的联系人数量和找到的地址数量消耗 Apify 点数;此外,你自己的服务商密钥也会产生相应费用。

定价

根据实时定价记录,Apify FREE 计划中每个事件的价格如下;付费 Apify 计划的单个事件费用更低。

事件价格(USD)
Actor 启动(apify-actor-start)0.00005
已提交电子邮件搜索(email-search-submitted)0.003
找到电子邮件(email-found)0.02

另有提供

此工具也集成在 GTM Suite 这个集合服务中,与 Mamba Labs 的其他 GTM Actor 一同提供。如果你更愿意运行一个服务,而不是运行多个服务,可以选择它。

由 Mamba Labs 构建。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。