FindLeadEmails

FindLeadEmails MCP 服务

通过 AI 助手查找并验证 B2B 工作邮箱：支持单次查询或批量列表，并检查邮件送达能力。

此仓库包含托管版 FindLeadEmails MCP 服务的设置文档和配置。无需安装代码：该服务是远程服务。

• URL： https://www.findleademails.com/api/mcp（Streamable HTTP）
• 身份验证： 在支持 OAuth 2.1 的客户端（Claude、ChatGPT、Codex、VS Code、Cursor、Claude Code、Gemini CLI 等）中登录：添加 URL，不带请求头，然后在浏览器中批准。或者发送 Authorization: Bearer YOUR_API_KEY。列出工具（initialize、tools/list）无需身份验证。
• API 密钥（仅在不使用 OAuth 时需要）：登录并在 https://www.findleademails.com/developers?utm_source=github 创建密钥。密钥只会显示一次；如果丢失，请在那里轮换密钥。切勿将密钥提交到仓库。

请使用 www 主机名。https://findleademails.com 会重定向，而部分客户端在跟随该重定向时会丢弃 Authorization 请求头。

两个按钮都只会添加服务 URL。首次运行工具时，请在浏览器中批准 OAuth 登录。

工具

工具	功能	积分
find_email	根据 first_name、last_name、company_domain（或 LinkedIn 公司主页 URL）查找并验证一人的工作邮箱。	仅在邮箱通过验证时扣 1 积分
verify_email	检查一个你已有的 email。	仅在确认有效时扣 1 积分
find_emails_bulk	通过一次同步调用批量查找并验证邮箱（有上限；超过上限时返回 batch_too_large）。	每个通过验证的结果扣 1 积分
create_job	将大型列表加入队列以进行后台处理；返回一个 job id。	每行预扣 1 积分，退还未使用的积分
get_job_status	查看 job 的进度和各结果计数。	免费
get_job_results	获取一页逐行结果（使用 cursor 翻页，直到 next_cursor 为 null）。运行期间也可使用。	免费

定价：未找到、全收件箱、预测结果和重复查询均免费；仅对通过验证的邮箱收费。积分永不过期。请参阅 https://www.findleademails.com/docs/mcp?utm_source=github#credits。

使用 OAuth 登录

此服务支持 OAuth 2.1、PKCE（S256）、Client ID Metadata Documents 和 Dynamic Client Registration。在支持 OAuth 的客户端中，添加 URL（不带 Authorization 请求头），然后在浏览器中批准访问。无需 API 密钥。

• Claude（claude.ai 和 Claude Desktop）：Settings → Connectors → Add custom connector。粘贴 https://www.findleademails.com/api/mcp，选择“Sign in when needed”，并保留“Use Claude's published identity”。

• **ChatGPT 和 Codex：**使用上方的 URL 添加服务，并选择 OAuth 作为身份验证方式。

• Claude Code：

  claude mcp add --transport http findleademails https://www.findleademails.com/api/mcp
  

  然后在 Claude Code 中运行 /mcp，选择 findleademails，并选择 Authenticate。

• **VS Code 和 Cursor：**只添加 URL，不要添加 headers（或使用上方的安装按钮）。客户端会在需要时打开登录页面。

• **Gemini CLI：**安装扩展后，运行 /mcp auth findleademails。

更喜欢使用 API 密钥？请使用下方的代码片段。

使用 API 密钥进行设置

在每个代码片段中，将 YOUR_API_KEY 替换为你的密钥。

Cursor

如需使用 OAuth，请点击上方的 Add to Cursor 按钮。如需使用 API 密钥，请手动将其添加到 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）。此仓库中也包含相同文件： .mcp.json。

{
  "mcpServers": {
    "findleademails": {
      "url": "https://www.findleademails.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

如需避免将密钥保存在文件中，请使用 "Bearer ${env:FINDLEADEMAILS_API_KEY}"。

Claude Code

claude mcp add --transport http findleademails https://www.findleademails.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop

Claude Desktop 需要 mcp-remote 桥接程序（Node.js 18+）。在 claude_desktop_config.json 中：

{
  "mcpServers": {
    "findleademails": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.findleademails.com/api/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code

.vscode/mcp.json。VS Code 会提示你输入密钥，并安全地保存：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "findleademails-api-key",
      "description": "Paste your FindLeadEmails API key.",
      "password": true
    }
  ],
  "servers": {
    "findleademails": {
      "type": "http",
      "url": "https://www.findleademails.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:findleademails-api-key}"
      }
    }
  }
}

Windsurf

mcp_config.json（从 Cascade 面板的操作菜单中打开；在 macOS/Linux 上为 ~/.config/devin/mcp_config.json，在 Windows 上为 %APPDATA%\devin\mcp_config.json）：

{
  "mcpServers": {
    "findleademails": {
      "serverUrl": "https://www.findleademails.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cline

让 Cline 从此仓库安装此服务（它会遵循 llms-install.md），或将配置添加到 cline_mcp_settings.json：

{
  "mcpServers": {
    "findleademails": {
      "type": "streamableHttp",
      "url": "https://www.findleademails.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Gemini CLI

gemini extensions install https://github.com/findleademails/findleademails-mcp

CLI 会在安装过程中询问你的 API 密钥，并将其保存在系统密钥链中。之后可使用 gemini extensions config findleademails 更改密钥。

Perplexity

Pro、Max 或 Enterprise：进入 Connectors → 添加自定义远程连接器，并选择你的套餐提供的身份验证选项。使用 API 密钥时：

URL: https://www.findleademails.com/api/mcp
Header: Authorization: Bearer YOUR_API_KEY

Grok

在 grok.com 上：进入 Connectors → New Connector → Custom，输入服务 URL，并在系统询问身份验证方式时粘贴 API 密钥。Business 和 Enterprise 工作区需要管理员先配置自定义连接器。

Grok CLI：

grok mcp add --transport http findleademails https://www.findleademails.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

xAI API（密钥应填入 authorization，不要加上 Bearer 一词）：

{
  "type": "mcp",
  "server_url": "https://www.findleademails.com/api/mcp",
  "server_label": "findleademails",
  "authorization": "YOUR_API_KEY"
}

其他客户端

仅支持 OAuth 的客户端只需填写 URL。任何支持远程 URL 和请求头的客户端：使用上方的 Cursor JSON，并根据该客户端的键名进行调整。

试用

curl https://www.findleademails.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

不带密钥或 OAuth 令牌的工具调用会返回 HTTP 401 invalid_token（并附带 WWW-Authenticate 请求头，指引 OAuth 客户端登录），且不会产生任何费用。未包含 Accept: application/json, text/event-stream 的 POST 请求会返回 406。

链接

• 文档：https://www.findleademails.com/docs/mcp?utm_source=github
• REST API 文档：https://www.findleademails.com/docs?utm_source=github
• API 密钥：https://www.findleademails.com/developers?utm_source=github
• 定价：https://www.findleademails.com/pricing?utm_source=github
• 联系方式：[email protected]

许可证

MIT。请参阅 LICENSE。

— FindLeadEmails 团队