Mailboxvalidator
About
Email validation MCP server using MailboxValidator API
Details
- License
- MIT
Explore
- 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.
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:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MailboxvalidatorCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
``bash`
npm install
npm run build
claude_desktop_config.json
3. 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.
4. Open . If you don't have that file yet, follow this guide to create one.claude_desktop_config.json
5. Add the following to your :`
json`
{
"mcpServers": {
"mailboxvalidator": {
"command": "node",
"args": [
"C:\\path\\to\\mcp-mailboxvalidator\\build\\index.js"
],
"env": {
"MAILBOXVALIDATOR_API_KEY": "<YOUR_API_KEY>"
}
}
}
}
index.js
6. Remember to replace the path for the with your actual path to your MailboxValidator MCP server on your local machine.<YOUR_API_KEY>
7. 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.Search and tools
8. Restart the Claude Desktop after saving the changes, and you should see it appear in the menu.
MAILBOXVALIDATOR_API_KEY`
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.
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:
- Syntax: Checks that the email address conforms to how an email address should look like.
- DNS & MX Server: Checks that the domain DNS has an MX server specified.
- Network & Connectivity: Attempts connection to the MX server to make sure it's operational.
- Greylisting: Checks if MX server is using greylisting that could cause email sent to that address to bounce.
- Disposable List: Checks if the email domain is from a temporary or disposable email provider.
- High Risk & Suppressed List: Checks if email username looks high-risk or if the email address is found in a suppression list.
- Others: Checks the reputation score for the email and more..
If the request fails, the tool will return an error message as a string.
check_disposable_email
Description
Checks if the email address given is from a disposable email provider.
Arguments
email (str): The email address to check.
Returns
A JSON string containing the disposable email data. The result includes the following fields:
- Disposable List: Checks if the email domain is from a temporary or disposable email provider.
If the request fails, the tool will return an error message as a string.
check_free_email
Description
Checks if the email address given is from a free email provider.
Arguments
email (str): The email address to check.
Returns
A JSON string containing the free email data. The result includes the following fields:
- Free Email List: Checks if the email domain is from a free email provider.
If the request fails, the tool will return an error message as a string.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mailboxvalidator": {
"mailboxvalidator": {
"command": "npx",
"args": [
"-y",
"mcp-mailboxvalidator"
],
"env": {
"MAILBOXVALIDATOR_API_KEY": "<YOUR_API_KEY>"
}
}
}
}
}
McpServers
{
"mailboxvalidator": {
"command": "npx",
"args": [
"-y",
"mcp-mailboxvalidator"
],
"env": {
"MAILBOXVALIDATOR_API_KEY": "<YOUR_API_KEY>"
}
}
}
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



