Email Validator

by abhi5h3k

1 stars
344 downloads
Not rated
GitHub

About

Validates email addresses through Abstract API, checking format, deliverability, and identifying disposable or role-based addresses to reduce bounces and prevent fake signups.

Details

Author
abhi5h3k
Repository
Abhi5h3k/MCP-Email-Verify
GitHub stars
1
Downloads
344
Categories
Design, Developer Tools, AI, Infrastructure, API, Frontend, Communication, Productivity, Automation, Other

- Email Verification: Verify email addresses in real-time.
- MCP Integration: Seamlessly connect with MCP-compatible LLMs.
- Easy Setup: Built with Python and the MCP SDK for quick deployment.

---

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Email Validator
    Command (node, npx, python, etc.) uv
    Arguments
    • Argument 1 --directory
    • Argument 2 C:\ABSOLUTE\PATH\TO\MCP-Email-Verify
    • Argument 3 run
    • Argument 4 server.py
    Environment
    • ABSTRACT_API_KEY your_api_key_here

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

1. Register the Server with Claude Desktop
Update the claude_desktop_config.json file to include your MCP server:

  {
"mcpServers": {
"verify_mail": {
"command": "uv",
"args": [
"--directory",
"C:\\ABSOLUTE\\PATH\\TO\\MCP-Email-Verify",
"run",
"server.py"
]
}
}
}

image

2. Restart Claude Desktop
Restart Claude Desktop to detect the new tool.

3. Verify Emails
Use prompts like:

"I was trying to email Thanos at thanos@snap.io to ask him to bring back my favorite TV show, but I’m not sure if it’s a valid email. Can you check if it’s real or just a snap in the dark?"

1. Set Up Environment Variables
Create a .env file in the root directory and add your AbstractAPI key:

ABSTRACT_API_KEY=your_api_key_here

2. Run the Server
Start the MCP server:
uv run server.py

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "email validator": {
            "env": {
                "ABSTRACT_API_KEY": "your_api_key_here"
            },
            "args": [
                "--directory",
                "C:\\ABSOLUTE\\PATH\\TO\\MCP-Email-Verify",
                "run",
                "server.py"
            ],
            "command": "uv"
        }
    }
}

Linux

{
    "env": {
        "ABSTRACT_API_KEY": "your_api_key_here"
    },
    "args": [
        "--directory",
        "C:\\ABSOLUTE\\PATH\\TO\\MCP-Email-Verify",
        "run",
        "server.py"
    ],
    "command": "uv"
}

Macos

{
    "env": {
        "ABSTRACT_API_KEY": "your_api_key_here"
    },
    "args": [
        "--directory",
        "C:\\ABSOLUTE\\PATH\\TO\\MCP-Email-Verify",
        "run",
        "server.py"
    ],
    "command": "uv"
}

Windows

{
    "env": {
        "ABSTRACT_API_KEY": "your_api_key_here"
    },
    "args": [
        "--directory",
        "C:\\ABSOLUTE\\PATH\\TO\\MCP-Email-Verify",
        "run",
        "server.py"
    ],
    "command": "uv"
}

MCP Email Verify

A lightweight Model Context Protocol (MCP) server that enables your LLM to validate email addresses. This tool checks email format, domain validity, and deliverability using the AbstractAPI Email Validation API. Perfect for integrating email validation into AI applications like Claude Desktop.

---

What is Model Context Protocol (MCP)?

At its core, MCP is a standardized protocol designed to streamline communication between AI models and external systems. Think of it as a universal language that allows different AI agents, tools, and services to interact seamlessly.

MCP drawio (1)

---

Features

- Email Verification: Verify email addresses in real-time. - MCP Integration: Seamlessly connect with MCP-compatible LLMs. - Easy Setup: Built with Python and the MCP SDK for quick deployment.

---

MCP follows a client-server architecture:

client server drawio

---

Watch the Demo

Click the image below to watch a video demo of the MCP Email Verify tool in action:

Screenshot 2025-03-23 115525

---

Requirements

- Python: Python 3.11.0 or higher. - UV: 0.6.9 or higher.

---

Setup

1. Clone the Repository

git clone https://github.com/Abhi5h3k/MCP-Email-Verify.git
cd MCP-Email-Verify

2. Install UV

If you don’t have UV installed, you can install it using the following commands:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Verify the installation:
uv --version

3. Set Up the Virtual Environment

Create a virtual environment using UV:

uv venv

Activate the virtual environment:
On Windows:
.venv\Scripts\activate

4. Install Dependencies
Install the required dependencies from pyproject.toml using UV:
uv install

Running the Server

1. Set Up Environment Variables Create a .env file in the root directory and add your AbstractAPI key:
ABSTRACT_API_KEY=your_api_key_here
2. Run the Server Start the MCP server:
uv run server.py

Usage

1. Register the Server with Claude Desktop
Update the claude_desktop_config.json file to include your MCP server:

  {
"mcpServers": {
"verify_mail": {
"command": "uv",
"args": [
"--directory",
"C:\\ABSOLUTE\\PATH\\TO\\MCP-Email-Verify",
"run",
"server.py"
]
}
}
}

image

2. Restart Claude Desktop
Restart Claude Desktop to detect the new tool.

3. Verify Emails
Use prompts like:

"I was trying to email Thanos at thanos@snap.io to ask him to bring back my favorite TV show, but I’m not sure if it’s a valid email. Can you check if it’s real or just a snap in the dark?"

Development

Formatting and Linting This project uses black and isort for code formatting and import sorting.

1. Install development dependencies:

    uv add black isort --dev

2. Format the code:
   black .

3. Sort imports:
    isort .

Set up pre-commit

pre-commit install
pre-commit run --all-files

Available On
Smithery.ai Server: MCP Email Verify

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.