Findymail MCP Server

MCP (Model Context Protocol) server for Findymail - enabling AI assistants to find verified B2B emails, phone numbers, and company data.

Features

This MCP server exposes the following tools:

| Tool | Description | |------|-------------| | find_email | Find verified B2B email from name + domain or LinkedIn URL | | find_phone | Find phone number(s) from LinkedIn URL | | verify_email | Verify if an email is deliverable | | enrich_company | Get company data from domain, LinkedIn URL, or name | | reverse_email_lookup | Find person info from an email | | generate_lead_list | AI-powered lead list generation with natural language |

Prerequisites

• Node.js 18+
• A Findymail API key (get one here)

Installation

npm install -g findymail-mcp

Or use directly with npx:

npx findymail-mcp

Configuration

Stdio mode (local)

Each user provides their API key via environment variable.

Claude Code

claude mcp add findymail -e FINDYMAIL_API_KEY=your-api-key -- npx findymail-mcp

Or manually edit ~/.claude.json:

{
  "mcpServers": {
    "findymail": {
      "command": "npx",
      "args": ["findymail-mcp"],
      "env": {
        "FINDYMAIL_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop

Edit your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "findymail": {
      "command": "npx",
      "args": ["findymail-mcp"],
      "env": {
        "FINDYMAIL_API_KEY": "your-api-key"
      }
    }
  }
}

HTTP mode (remote server)

In HTTP mode, each client passes their Findymail API key via the Authorization header. No environment variable is needed on the server.

Claude Code

claude mcp add findymail https://your-server.com/mcp -t http -H "Authorization: Bearer your-api-key"
claude mcp add findymail https://mcp.findylabs.com/mcp -t http -H "Authorization: Bearer your-api-key"

Running the HTTP server

npm install express
PORT=3456 node src/http.js

Requests to /mcp without a valid Authorization: Bearer <token> header will be rejected with a 401 error.

Usage Examples

Once configured, you can ask your AI assistant:

• "Find the email for John Smith at Acme Corp"
• "What's the phone number for the CEO of findymail.com?"
• "Verify if [email protected] is a valid email"
• "Get company information for stripe.com"
• "Find me 10 marketing managers at SaaS companies in San Francisco"

API Key

Get your API key from Findymail Settings.

Each API call consumes credits from your Findymail account.

Development

# Clone the repo
git clone https://github.com/Findymail/findymail-mcp.git
cd findymail-mcp

# Install dependencies
npm install

# Run locally
FINDYMAIL_API_KEY=your-key npm start

License

MIT