Email Checker MCP Server

For your cold outbound email, this tool will help you validate email addresses.

Features

Email address validation
Simple JSON response format
No API key required

Prerequisites

Python 3.x

Installation

Clone the repository:

git clone https://github.com/ravinahp/email-checker-mcp.git
cd email-checker-mcp

Install dependencies using uv:

uv sync

Note: We use uv instead of pip since the project uses pyproject.toml for dependency management.

Configure as MCP Server

To add this tool as an MCP server, you'll need to modify your Claude desktop configuration file.

The configuration file location depends on your operating system:

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

Add the following configuration to your JSON file:

{
    "email-checker-mcp": {
        "command": "uv",
        "args": [
            "--directory",
            "/Users/YOUR_USERNAME/Code/email-checker-mcp",
            "run",
            "email-checker-mcp"
        ]
    }
}

⚠️ IMPORTANT:

Replace YOUR_USERNAME with your actual system username
Make sure the directory path matches your local installation

Usage

The service provides a FastMCP tool for validating email addresses:

@mcp.tool()
async def validate_email(email: str) -> bool:
    """Validate if an email address exists."""

Example Use:

Prompt: Does this email exist? <img width="769" alt="Screenshot 2025-01-08 at 10 14 43 AM" src="https://github.com/user-attachments/assets/1bee703b-3a8a-4ed0-ab0d-27b0dfdd06de" />

Parameters:

email: String containing the email address to validate

Example Response:

{
    "exist": true
}

API Usage Limits

The service uses 2IP's Email API which provides:

No API key required

Error Handling

The service includes error handling for:

Invalid email format
API request failures
Network timeouts
Rate limiting