Email Checker MCP Server

View original on GitHub 

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

1. Clone the repository:

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

2. 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:

1. Replace YOUR_USERNAME with your actual system username
2. 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?

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