Validates email addresses by checking syntax, DNS, MX servers, and identifying disposable or free email providers.
Also known as MailboxValidator/mcp-mailboxvalidator, mcp-mailboxvalidator
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Oct 26, 2026
- License
- MIT
What is MailboxValidator MCP?
MailboxValidator validates email addresses by checking syntax, DNS, MX servers, and identifying disposable or free email providers.
Summary generated from the project's README
About MailboxValidator MCP server
MailboxValidator provides a way for developers to verify the quality and reachability of email addresses through an MCP server. It works by examining syntax, DNS records, and MX server status to ensure an address is functional. The server also identifies if an address belongs to a free provider or a temporary, disposable service.
Users can deploy this as a cloud-hosted server via HTTP or run it locally using Node.js and npm. Connecting to the remote version requires an API key passed through headers, while the local setup uses an environment variable. A free tier is available that allows for up to 300 queries per month.
The implementation includes specific tools like validate_email, check_disposable_email, and check_free_email. These allow an AI client to determine if an email is high risk, suppressed, or if the domain uses greylisting which might cause delivery issues.
What you can do with it
- 1Verify email reachabilityCheck if a specific email address is valid by analyzing its syntax and MX server connectivity.
- 2Detect temporary accountsIdentify if a user is signing up with a temporary or disposable email address.
- 3Filter free email providersDetermine if an email address is hosted on a free service provider.
- 4Assess email riskEvaluate if an email address is on a suppression list or carries a high risk profile.
Written from the project's README. Every use case is checked against a quote from it.
How to install MailboxValidator MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall MailboxValidator MCP in Claude Code
$ claude mcp add --env 'MAILBOXVALIDATOR_API_KEY=<YOUR_MAILBOXVALIDATOR_API_KEY>' mcp-mailboxvalidator -- npx -y mcp-mailboxvalidatorInstall MailboxValidator MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-mailboxvalidator": {
"command": "npx",
"args": [
"-y",
"mcp-mailboxvalidator"
],
"env": {
"MAILBOXVALIDATOR_API_KEY": "<YOUR_MAILBOXVALIDATOR_API_KEY>"
}
}
}
}Install MailboxValidator MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-mailboxvalidator": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-mailboxvalidator"
],
"env": {
"MAILBOXVALIDATOR_API_KEY": "<YOUR_MAILBOXVALIDATOR_API_KEY>"
}
}
}
}Install MailboxValidator MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-mailboxvalidator","type":"stdio","command":"npx","args":["-y","mcp-mailboxvalidator"],"env":{"MAILBOXVALIDATOR_API_KEY":"<YOUR_MAILBOXVALIDATOR_API_KEY>"}}'Install MailboxValidator MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-mailboxvalidator": {
"command": "npx",
"args": [
"-y",
"mcp-mailboxvalidator"
],
"env": {
"MAILBOXVALIDATOR_API_KEY": "<YOUR_MAILBOXVALIDATOR_API_KEY>"
}
}
}
}Install MailboxValidator MCP in Codex
$ codex mcp add mcp-mailboxvalidator --env 'MAILBOXVALIDATOR_API_KEY=<YOUR_MAILBOXVALIDATOR_API_KEY>' -- npx -y mcp-mailboxvalidatorInstall MailboxValidator MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-mailboxvalidator] command = "npx" args = ["-y", "mcp-mailboxvalidator"] [mcp_servers.mcp-mailboxvalidator.env] MAILBOXVALIDATOR_API_KEY = "<YOUR_MAILBOXVALIDATOR_API_KEY>"
Install MailboxValidator MCP in Gemini CLI
$ gemini mcp add -s user -e 'MAILBOXVALIDATOR_API_KEY=<YOUR_MAILBOXVALIDATOR_API_KEY>' mcp-mailboxvalidator npx -- -y mcp-mailboxvalidatorInstall MailboxValidator MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-mailboxvalidator": {
"command": "npx",
"args": [
"-y",
"mcp-mailboxvalidator"
],
"env": {
"MAILBOXVALIDATOR_API_KEY": "<YOUR_MAILBOXVALIDATOR_API_KEY>"
}
}
}
}Needs a key before it starts
Started on 16 Nov 2026 with no keys, it stopped and asked for one, so a client sees no tools until you set the variables above.
Configuration
MAILBOXVALIDATOR_API_KEYRequiredSecretYour MailboxValidator API key.
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablemailboxvalidator/mcp-mailboxvalidator is public and reachablegithub.com/mailboxvalidator/mcp-mailboxvalidator ↗Pass
- Package names this repository as its sourcemcp-mailboxvalidator names mailboxvalidator/mcp-mailboxvalidator as sourcenpmjs.com/package/mcp-mailboxvalidator ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-26github.com/mailboxvalidator/mcp-mailboxvalidator ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from mcp-mailboxvalidatorPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubMailboxValidator 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 local MCP server setup also uses Node.js and npm, which can be downloaded at Node.js website.
Setup
There are two ways to use this MCP server:
- Cloud-hosted MCP server: Connect directly to the hosted MailboxValidator MCP server. Nothing needs to be installed locally.
- Local MCP server: Download and run the server on your own machine.
Option 1: Cloud-hosted MCP server
Use this if you want to connect directly to the hosted server.
Method A: Direct HTTP connection
Use this if your MCP client supports remote servers over HTTP. No Node.js, npm, or npx is needed.
{
"mcpServers": {
"mailboxvalidator": {
"type": "http",
"url": "https://mcp.mailboxvalidator.com/mcp",
"headers": {
"X-API-Key": "<YOUR_API_KEY>"
}
}
}
}
If your client is configured from the command line, such as Claude Code, you can add the server with:
claude mcp add --transport http mailboxvalidator https://mcp.mailboxvalidator.com/mcp --header "X-API-Key: <YOUR_API_KEY>"
Method B: Connection through npx
Use this if your MCP client only supports local (stdio) servers. The mcp-remote package runs locally and forwards requests to the hosted server. Node.js is required.
{
"mcpServers": {
"mailboxvalidator": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://mcp.mailboxvalidator.com/mcp",
"--header",
"X-API-Key:<YOUR_API_KEY>"
]
}
}
}
To get your API key, just login to your dashboard and get it from there, then replace <YOUR_API_KEY> in the example above with your actual API key.
Restart the Claude Desktop after saving the changes, and you should see it appear in the Search and tools menu.
Option 2: Local MCP server
Follow the steps to run the MCP server on your own machine:
- Download the repository to your local.
- Run the following commands while inside the project folder to install dependencies and build the server.
npm install
npm run build
- 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.
- Open
claude_desktop_config.json. If you don't have that file yet, follow this guide to create one. - Add the following to your
claude_desktop_config.json:
{
"mcpServers": {
"mailboxvalidator": {
"command": "node",
"args": [
"C:\\path\\to\\mcp-mailboxvalidator\\build\\index.js"
],
"env": {
"MAILBOXVALIDATOR_API_KEY": "<YOUR_API_KEY>"
}
}
}
}
- Remember to replace the path for the
index.jswith your actual path to your MailboxValidator MCP server on your local machine. - To get your API key, just login to your dashboard and get it from there. Replace the
<YOUR_API_KEY>in the above with your actual API key. - Restart the Claude Desktop after saving the changes, and you should see it appear in the
Search and toolsmenu.
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
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.
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:
- 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.
License
See the LICENSE file.
MailboxValidator MCP questions
How do I add MailboxValidator MCP to Claude Code?
Run claude mcp add --env 'MAILBOXVALIDATOR_API_KEY=<YOUR_MAILBOXVALIDATOR_API_KEY>' mcp-mailboxvalidator -- npx -y mcp-mailboxvalidator in your terminal. Add --scope user to make it available in every project.
How do I add MailboxValidator MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What specific checks does the email validation tool perform?
The tool checks syntax, DNS, MX server, network connectivity, greylisting, disposable email lists, and high-risk or suppressed lists.