MailboxValidator MCP server

MailboxValidator MCP server

This is a simple Model Context Protocol (MCP) server implementation for MailboxValidator API. It will return validation result for an email address.

Features

• Comprehensive Email Validation: Checking an email address to see if an email is reachable by checking the syntax, DNS, MX server, high risk, suppressed list, and more.
• Disposable Email: Checking an email address to see if it's from a temporary/disposable email provider.
• Free Email: Checking an email address to see if it's from a free email provider.

Requirement

This MCP server requires an API key. You can also sign up for a free API key and enjoy up to 300 queries per month.

The setup also uses Node.js and npm, which can be downloaded at Node.js website.

Setup

Follow the steps to use this MCP server with Claude Desktop:

1. Download the repository to your local.
2. Run the following commands while inside the project folder to install dependencies and build the server.

npm install
npm run build

1. Make sure you have installed Claude Desktop. If you haven't, kindly download from here for Windows and macOS users, or follow this guide for Linux users.
2. Open claudedesktopconfig.json. If you don't have that file yet, follow this guide to create one.
3. Add the following to your claudedesktopconfig.json:

{
  "mcpServers": {
    "mailboxvalidator": {
      "command": "node",
      "args": [
        "C:\\path\\to\\mcp-mailboxvalidator\\build\\index.js"
      ],
      "env": {
        "MAILBOXVALIDATOR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

1. Remember to replace the path for the index.js with your actual path to your MailboxValidator MCP server on your local machine.
2. To get your API key, just login to your dashboard and get it from there. Replace the in the above with your actual API key.
3. Restart the Claude Desktop after saving the changes, and you should see it appear in the Search and tools menu.

Usage

Just enter your query about the email address in a chat in Claude Desktop. Some of example queries are:

• Is (email) a valid email address?
• Is (email) a fake email?
• Is (email) a free email?

In Claude Desktop, the model will automatically generate the output based on the result returned by MailboxValidator MCP server.

Environment Variable

MAILBOXVALIDATORAPIKEY

The free MailboxValidator API key allows you to query up to 300 emails per month. If you require more, you can sign up for a paid API plan.

Tool

validate_email

Description Validates the email address given. It helps users to determine if an email address is potentially reachable by checking the syntax, DNS, MX server, disposable list and more.

Arguments email (str): The email address to validate.

Returns A JSON string containing the validation data. The result includes the following fields:

Shortened. The full README is on GitHub.