Findymail MCP Server

This is a Model Context Protocol (MCP) server that integrates with the Findymail API to provide email validation and finding capabilities.

Features

Validate email addresses to check if they are valid and deliverable
Find work emails for individuals using name and company information
Find work emails for individuals using their profile URLs (LinkedIn, etc.)

Setup

Local Setup

Clone this repository
Install dependencies:
```
npm install
```
Create a .env file based on .env.example and add your Findymail API key:
```
FINDYMAIL_API_KEY=your_api_key_here
```
Build the server:
```
npm run build
```
Start the server:
```
npm start
```

Docker Setup

Clone this repository
Create a .env file with your Findymail API key
Build and run using Docker Compose:
```
docker-compose up -d
```

MCP Configuration

To use this server with an MCP client, add the following configuration to your MCP settings file:

{
  "mcpServers": {
    "findymail": {
      "command": "node",
      "args": ["path/to/findymail/dist/index.js"],
      "env": {
        "FINDYMAIL_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Available Tools

findymail_validate_email: Validate an email address to check if it's valid and deliverable
findymail_find_work_email: Find a work email for an individual using name and company information
findymail_find_work_email_from_profile: Find a work email for an individual using their profile URL

License

ISC