FindLeadEmails

[FindLeadEmails logo]

FindLeadEmails MCP server

Find and verify B2B work emails from your AI assistant: single lookups or bulk lists, with deliverability checks.

This repository holds setup docs and config for the hosted FindLeadEmails MCP server. There is no code to install: the server is remote.

• URL: https://www.findleademails.com/api/mcp (Streamable HTTP)
• Auth: sign in with OAuth 2.1 in clients that support it (Claude, ChatGPT, Codex, VS Code, Cursor, Claude Code, Gemini CLI, and others): add the URL with no header and approve in the browser. Or send Authorization: Bearer YOUR_API_KEY. Listing tools (initialize, tools/list) needs neither.
• API key (only if you don't use OAuth): sign in and create one at https://www.findleademails.com/developers?utm_source=github. It is shown once; rotate it there if lost. Never commit it.

Use the www host. https://findleademails.com redirects, and some clients drop the Authorization header when following that redirect.

[Add to Cursor] [Install in VS Code]

Both buttons add the server URL only. Approve the OAuth sign-in in your browser the first time a tool runs.

Tools

Pricing: misses, catch-alls, predicted results and repeat lookups are free; you pay only for verified emails. Credits never expire. See https://www.findleademails.com/docs/mcp?utm_source=github#credits.

Sign in with OAuth

The server supports OAuth 2.1 with PKCE (S256), Client ID Metadata Documents, and Dynamic Client Registration. In a client that supports OAuth, add the URL with no Authorization header and approve access in your browser. No API key needed.

• Claude (claude.ai and Claude Desktop): Settings → Connectors → Add custom connector. Paste https://www.findleademails.com/api/mcp, choose "Sign in when needed", and keep "Use Claude's published identity".

• ChatGPT and Codex: add the server with the URL above and choose OAuth as the authentication method.

• Claude Code:

  bash

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

  Then run /mcp in Claude Code, select findleademails, and choose Authenticate.

• VS Code and Cursor: add the URL only, with no headers (or use the install buttons above). The client opens the sign-in page when needed.

• Gemini CLI: after installing the extension, run /mcp auth findleademails.

Prefer an API key? Use the snippets below.

Setup with an API key

Replace YOUR_API_KEY with your key in every snippet.

Cursor

For OAuth, use the Add to Cursor button above. For an API key, add this by hand to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global). The same file is in this repo as .mcp.json.

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

To keep the key out of the file, use "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 needs the mcp-remote bridge (Node.js 18+). In 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 prompts for the key and stores it securely:

{  "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 (open it from the Cascade panel's actions menu; on macOS/Linux ~/.config/devin/mcp_config.json, on Windows %APPDATA%\devin\mcp_config.json):

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

Cline

Ask Cline to install this server from this repo (it follows llms-install.md), or add to 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

The CLI asks for your API key during install and stores it in the system keychain. Change it later with gemini extensions config findleademails.

Perplexity

Pro, Max or Enterprise: Connectors → add a custom remote connector and choose the authentication option your plan offers. With an API key:

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

Grok

On grok.com: Connectors → New Connector → Custom, enter the server URL, and paste the API key when asked for authentication. Business and Enterprise workspaces need an admin to provision custom connectors first.

Grok CLI:

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

xAI API (the key goes in authorization without the word Bearer):

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

Other clients

A client that supports OAuth only needs the URL. Any client that takes a remote URL plus headers: use the Cursor JSON above, adjusted to that client's key names.

Try it

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":{}}'

A tool call without a key or OAuth token returns HTTP 401 invalid_token (with a WWW-Authenticate header pointing OAuth clients to sign-in) and nothing is charged. A POST without Accept: application/json, text/event-stream returns 406.

Links

• Docs: https://www.findleademails.com/docs/mcp?utm_source=github
• REST API docs: https://www.findleademails.com/docs?utm_source=github
• API keys: https://www.findleademails.com/developers?utm_source=github
• Pricing: https://www.findleademails.com/pricing?utm_source=github
• Contact: [email protected]

License

MIT. See LICENSE.

— The FindLeadEmails team