# email-verifier

An MCP server that wires the Verifox API into your assistant, so it can check deliverability and look up business addresses by name and domain.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: verifoxturnix1
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/verifoxturnix1/verifox-mcp
- Updated: 2026-07-22
- HTML: https://affpapa.org/en/nevibecode/mcp/email-verifier

## What it does

The server exposes Verifox tools to the assistant. `verify_email` handles a single address: SMTP deliverability, catch-all, disposable, role and free-mail flags, plus a 0-100 score. `verify_emails` runs the same checks over a list and returns one result per address.

Lookups work differently. `find_email` takes a name and a company domain and returns the best match or not_found; `find_emails` does it for a list of contacts. `get_credits` reports the remaining Fox Credit balance, and `get_job` polls long-running work — bulk calls wait about 55 seconds inline and hand back a `jobId` when they run past that. Cached verifications cost nothing.

You need a `foxkey_*` key from the Verifox dashboard. Every tool call is authenticated with it, and the account behind the key is the one charged. In HTTP mode the key is read per request from the `Authorization: Bearer <foxkey>` header, so a single hosted endpoint can serve several users, each spending their own credits.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.verifox.ai/mcp`
- Environment variables: `VERIFOX_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 email-verifier -e VERIFOX_API_KEY=<VERIFOX_API_KEY> -- npx -y verifox-mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http email-verifier https://mcp.verifox.ai/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add email-verifier --url https://mcp.verifox.ai/mcp
```

2. **Platform CLI**
```bash
codex mcp add email-verifier --env VERIFOX_API_KEY=<VERIFOX_API_KEY> -- npx -y verifox-mcp
```
Replace <…> with your own values

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http email-verifier https://mcp.verifox.ai/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e VERIFOX_API_KEY=<VERIFOX_API_KEY> email-verifier npx -y verifox-mcp
```
Replace <…> with your own values

## When to use it
- check a mailing list before sending
- find someone's work address from name and domain
- filter out disposable and role inboxes
- see how many Fox Credits are left
- poll a bulk job through `get_job`

## Example prompts
- Verify deliverability for admin@stripe.com and test@mailinator.com
- How many Fox Credits does this account have left?

## Similar
- [Emaillistchecker.io Email Verification](https://affpapa.org/en/nevibecode/mcp/emaillistcheckerio-email-verification.md) — MCP server
- [extension-email-verification](https://affpapa.org/en/nevibecode/skills/extension-email-verification.md) — skill · 28100 installs
- [recoup-platform-email-helper](https://affpapa.org/en/nevibecode/skills/recoup-platform-email-helper.md) — skill · 4900 installs
- [pinme-email](https://affpapa.org/en/nevibecode/skills/pinme-email.md) — skill · 500 installs
- [cold-email-subject-line-tester](https://affpapa.org/en/nevibecode/skills/cold-email-subject-line-tester.md) — skill · 25600 installs
- [twilio-sendgrid-email-send](https://affpapa.org/en/nevibecode/skills/twilio-sendgrid-email-send.md) — skill · ★ 7604

---
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