# MailProbe

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: mailprobe
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mailprobe/mcp
- Updated: 2026-11-03
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/mailprobe

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mailprobe.dev/mcp`
- Environment variables: `MAILPROBE_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add mailprobe -e MAILPROBE_API_KEY=<MAILPROBE_API_KEY> -- npx -y mailprobe-mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http mailprobe https://mailprobe.dev/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add mailprobe --url https://mailprobe.dev/mcp
```

2. **Platform CLI**
```bash
codex mcp add mailprobe --env MAILPROBE_API_KEY=<MAILPROBE_API_KEY> -- npx -y mailprobe-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mailprobe": {
            "url": "https://mailprobe.dev/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mailprobe": {
            "command": "npx",
            "args": [
                "-y",
                "mailprobe-mcp"
            ],
            "env": {
                "MAILPROBE_API_KEY": "<MAILPROBE_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mailprobe": {
            "type": "http",
            "url": "https://mailprobe.dev/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mailprobe": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mailprobe-mcp"
            ],
            "env": {
                "MAILPROBE_API_KEY": "<MAILPROBE_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http mailprobe https://mailprobe.dev/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e MAILPROBE_API_KEY=<MAILPROBE_API_KEY> mailprobe npx -y mailprobe-mcp
```
Replace <…> with your own values

## When to use it
- 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
- Check the addresses in `contacts.csv` before the campaign.
- Find disposable addresses in this list.
- Does `jane@example.com` have a mailbox?

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
