MailProbe — Claude Code MCP server: features and installation
This MCP server for Claude Code checks email addresses through the MailProbe API. Run it before a campaign to spot invalid, disposable, or role-based addresses.
MIT updated 2026-11-03
claude mcp add mailprobe -e MAILPROBE_API_KEY=<MAILPROBE_API_KEY> -- npx -y mailprobe-mcpWhat MailProbe does
MailProbe checks whether a mailbox exists and can receive mail without sending a message to it. The verify_emails tool accepts 1 to 20 addresses and returns a status, score, address flags, and a likely typo correction. Use get_credits to see the account balance.
The service requires a MailProbe API key. Its local server also needs Node.js 22 or later; it runs with npx -y mailprobe-mcp, while the remote option connects over HTTP. Each address actually checked costs one credit, and a request containing 20 addresses counts as one API call. Each key can make 60 calls per minute.
What it helps with
- check addresses before sending a campaign
- identify disposable or role-based mailboxes
- find likely typos in email addresses
- check the remaining API credit balance
Example prompts for the agent
- Check the addresses in
contacts.csvbefore the campaign. - Find disposable addresses in this list.
- Does
[email protected]have a mailbox?
How to install MailProbe
1Platform CLI
claude mcp add mailprobe -e MAILPROBE_API_KEY=<MAILPROBE_API_KEY> -- npx -y mailprobe-mcpReplace <…> with your own values
2Platform CLI: remote server
claude mcp add --transport http mailprobe https://mailprobe.dev/mcp1Platform CLI: remote server
codex mcp add mailprobe --url https://mailprobe.dev/mcp2Platform CLI
codex mcp add mailprobe --env MAILPROBE_API_KEY=<MAILPROBE_API_KEY> -- npx -y mailprobe-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"mailprobe": {
"url": "https://mailprobe.dev/mcp"
}
}
}{
"mcpServers": {
"mailprobe": {
"command": "npx",
"args": [
"-y",
"mailprobe-mcp"
],
"env": {
"MAILPROBE_API_KEY": "<MAILPROBE_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mailprobe": {
"type": "http",
"url": "https://mailprobe.dev/mcp"
}
}
}{
"servers": {
"mailprobe": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mailprobe-mcp"
],
"env": {
"MAILPROBE_API_KEY": "<MAILPROBE_API_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http mailprobe https://mailprobe.dev/mcp2Platform CLI
gemini mcp add -e MAILPROBE_API_KEY=<MAILPROBE_API_KEY> mailprobe npx -y mailprobe-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about MailProbe
How do I install MailProbe in Claude Code?
For the local server, run claude mcp add mailprobe -e MAILPROBE_API_KEY=<MAILPROBE_API_KEY> -- npx -y mailprobe-mcp. You need a MailProbe API key and Node.js 22 or later.
What does MailProbe do?
It checks whether an email address has an existing mailbox that can receive mail, without sending a message. The get_credits tool reports the API key’s remaining balance.
What does MailProbe require?
A MailProbe API key is required. The local server also needs Node.js 22 or later; the remote server connects over HTTP.