{
  "markdown": "# MailboxValidator MCP server\r\n\r\nThis is a simple Model Context Protocol (MCP) server implementation for MailboxValidator API. It will return validation result for an email address.\r\n\r\n[![mcp-mailboxvalidator MCP server](https://glama.ai/mcp/servers/MailboxValidator/mcp-mailboxvalidator/badges/card.svg)](https://glama.ai/mcp/servers/MailboxValidator/mcp-mailboxvalidator)\r\n\r\n# Features\r\n\r\n- **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.\r\n- **Disposable Email**: Checking an email address to see if it's from a temporary/disposable email provider.\r\n- **Free Email**: Checking an email address to see if it's from a free email provider.\r\n\r\n# Requirement\r\n\r\nThis MCP server requires an API key. You can also [sign up](https://www.mailboxvalidator.com/plans) for a free API key and enjoy up to 300 queries per month.\r\n\r\nThe setup also uses `Node.js` and `npm`, which can be downloaded at [Node.js website](https://nodejs.org/en/download).\r\n\r\n# Setup\r\n\r\nFollow the steps to use this MCP server with Claude Desktop:\r\n1. Download the repository to your local.\r\n2. Run the following commands while inside the project folder to install dependencies and build the server.\r\n\r\n```bash\r\nnpm install\r\nnpm run build\r\n```\r\n3. Make sure you have installed Claude Desktop. If you haven't, kindly download from [here](https://claude.ai/download) for Windows and macOS users, or follow [this guide](https://modelcontextprotocol.io/quickstart/client) for Linux users.\r\n4. Open `claude_desktop_config.json`. If you don't have that file yet, follow [this guide](https://modelcontextprotocol.io/quickstart/server#testing-your-server-with-claude-for-desktop) to create one.\r\n5. Add the following to your `claude_desktop_config.json`:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"mailboxvalidator\": {\r\n      \"command\": \"node\",\r\n      \"args\": [\r\n        \"C:\\\\path\\\\to\\\\mcp-mailboxvalidator\\\\build\\\\index.js\"\r\n      ],\r\n      \"env\": {\r\n        \"MAILBOXVALIDATOR_API_KEY\": \"<YOUR_API_KEY>\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n 6. Remember to replace the path for the `index.js` with your actual path to your MailboxValidator MCP server on your local machine.\r\n 7. To get your API key, just [login](https://www.mailboxvalidator.com/login) to your dashboard and get it from there. Replace the `<YOUR_API_KEY>` in the above with your actual API key.\r\n 8. Restart the Claude Desktop after saving the changes, and you should see it appear in the `Search and tools` menu.\r\n\r\n# Usage\r\n\r\nJust enter your query about the email address in a chat in Claude Desktop. Some of example queries are:\r\n\r\n- Is (email) a valid email address?\r\n- Is (email) a fake email?\r\n- Is (email) a free email?\r\n\r\nIn Claude Desktop, the model will automatically generate the output based on the result returned by MailboxValidator MCP server.\r\n\r\n# Environment Variable\r\n\r\n`MAILBOXVALIDATOR_API_KEY`\r\n\r\nThe free MailboxValidator API key allows you to query up to 300 emails per month. If you require more, you can [sign up](https://www.mailboxvalidator.com/plans) for a paid API plan.\r\n\r\n# Tool\r\n\r\n`validate_email`\r\n\r\n**Description**\r\nValidates 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.\r\n\r\n**Arguments**\r\nemail (str): The email address to validate.\r\n\r\n**Returns**\r\nA JSON string containing the validation data. The result includes the following fields:\r\n\r\n- Syntax: Checks that the email address conforms to how an email address should look like.\r\n- DNS & MX Server: Checks that the domain DNS has an MX server specified.\r\n- Network & Connectivity: Attempts connection to the MX server to make sure it's operational.\r\n- Greylisting: Checks if MX server is using greylisting that could cause email sent to that address to bounce.\r\n- Disposable List: Checks if the email domain is from a temporary or disposable email provider.\r\n- High Risk & Suppressed List: Checks if email username looks high-risk or if the email address is found in a suppression list.\r\n- Others: Checks the reputation score for the email and more..\r\n\r\nIf the request fails, the tool will return an error message as a string.\r\n\r\n`check_disposable_email`\r\n\r\n**Description**\r\nChecks if the email address given is from a disposable email provider.\r\n\r\n**Arguments**\r\nemail (str): The email address to check.\r\n\r\n**Returns**\r\nA JSON string containing the disposable email data. The result includes the following fields:\r\n\r\n- Disposable List: Checks if the email domain is from a temporary or disposable email provider.\r\n\r\nIf the request fails, the tool will return an error message as a string.\r\n\r\n`check_free_email`\r\n\r\n**Description**\r\nChecks if the email address given is from a free email provider.\r\n\r\n**Arguments**\r\nemail (str): The email address to check.\r\n\r\n**Returns**\r\nA JSON string containing the free email data. The result includes the following fields:\r\n\r\n- Free Email List: Checks if the email domain is from a free email provider.\r\n\r\nIf the request fails, the tool will return an error message as a string.\r\n\r\n# License\r\n\r\nSee the LICENSE file.\r\n",
  "bytes": 5199,
  "sha": "8d34b64570ac79d01051f1221167e24cb406b42732f9c599eeedc7b111401fa0",
  "repo_slug": "mailboxvalidator/mcp-mailboxvalidator",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mailboxvalidator_mcp_mailboxva_ccda745c/readme"
}