# MailProbe MCP server

> Verifies email address deliverability, disposable status, and typos in real time without sending actual emails.

- Repository: https://github.com/mailprobe/mcp
- Page: https://hostedmcp.org/servers/mailprobe/mcp
- Transport: stdio, remote
- Stars: 0
- License: MIT
- Latest version: 1.1.2

## Install

### Claude Code

```sh
claude mcp add --env 'MAILPROBE_API_KEY=<YOUR_MAILPROBE_API_KEY>' mcp -- npx -y mailprobe-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mailprobe-mcp"
      ],
      "env": {
        "MAILPROBE_API_KEY": "<YOUR_MAILPROBE_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mailprobe-mcp"
      ],
      "env": {
        "MAILPROBE_API_KEY": "<YOUR_MAILPROBE_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","mailprobe-mcp"],"env":{"MAILPROBE_API_KEY":"<YOUR_MAILPROBE_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mailprobe-mcp"
      ],
      "env": {
        "MAILPROBE_API_KEY": "<YOUR_MAILPROBE_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add mcp --env 'MAILPROBE_API_KEY=<YOUR_MAILPROBE_API_KEY>' -- npx -y mailprobe-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp]
command = "npx"
args = ["-y", "mailprobe-mcp"]

[mcp_servers.mcp.env]
MAILPROBE_API_KEY = "<YOUR_MAILPROBE_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'MAILPROBE_API_KEY=<YOUR_MAILPROBE_API_KEY>' mcp npx -- -y mailprobe-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mailprobe-mcp"
      ],
      "env": {
        "MAILPROBE_API_KEY": "<YOUR_MAILPROBE_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `MAILPROBE_API_KEY` | yes | yes | MailProbe API key, which starts with mp_live_, created under Developer in your account |

## Tools (2)

- `verify_emails`: Checks whether email addresses exist and can receive mail, in real time and without sending anything. Returns one result per address, in input order. Act on `status`: `valid` is safe to send, `invalid` must not be used, `risky` is accepted but uncertain (catch-all domain, role or disposable address, provider that blocks probing) and `unknown` could not be determined. `score` is a 0-100 confidence value, `reason` explains a verdict that is not plainly deliverable and `did_you_mean` suggests a fix for a likely typo. One credit per address actually probed: duplicates and malformed addresses are free. At most 20 addresses per call: split a longer list into several calls. (read-only)
- `get_credits`: Returns the number of verification credits left on the MailProbe account that owns the API key. Reading the balance uses no credit. (read-only)

## FAQ

### Does MailProbe send an email to verify the address?

No, it checks syntax and mail servers to see if the mailbox exists without sending anything.

### How much does verification cost?

It costs one credit per address actually probed, and checking your remaining credits is free.

### What happens if I try to verify a very long list of emails?

The tool handles up to 20 addresses per call; for very large lists, you should use the batch screen on the MailProbe website.
