Email Validator

Enter a real, deliverable email address. We validate it before issuing a key — no account, password, or credit card required.

REST API

Base URL: https://email-validator.YOUR_ACCOUNT.workers.dev

Authentication: pass your API key via the X-Api-Key header or ?api_key= query parameter.

POST/register — Get an API key

No authentication required. Validates the email before issuing a key.

curl -X POST https://email-validator.YOUR_ACCOUNT.workers.dev/register \
  -H "Content-Type: application/json" \
  -d '{"email":"you@yourcompany.com"}'

{
  "email": "you@yourcompany.com",
  "api_key": "550e8400-e29b-41d4-a716-446655440000",
  "created": true
}

GET/validate — Single email

curl "https://email-validator.YOUR_ACCOUNT.workers.dev/validate?email=test@gmail.com" \
  -H "X-Api-Key: YOUR_KEY"

{
  "email": "test@gmail.com",
  "status": "valid",
  "result": "Okay to Send",
  "checks": {
    "syntax": true,
    "mx": true,
    "disposable": false,
    "role": false,
    "free_provider": true,
    "typo": false
  },
  "reason": "Accepted"
}

POST/validate — Batch (up to 50)

curl -X POST https://email-validator.YOUR_ACCOUNT.workers.dev/validate \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_KEY" \
  -d '{"emails":["valid@company.com","admin@gmail.com","foo@gamil.com"]}'

MCP — AI Tool Integration

The /mcp endpoint implements the Model Context Protocol (streamable HTTP transport). Add it to Claude Desktop, Claude Code, or any MCP-compatible client.

Claude Desktop (`claude_desktop_config.json`)

{
  "mcpServers": {
    "email-validator": {
      "type": "http",
      "url": "https://email-validator.YOUR_ACCOUNT.workers.dev/mcp",
      "headers": { "X-Api-Key": "YOUR_KEY" }
    }
  }
}

Claude Code

claude mcp add email-validator \
  --transport http \
  --url https://email-validator.YOUR_ACCOUNT.workers.dev/mcp \
  --header "X-Api-Key: YOUR_KEY"

MCP Tools

validate_email(email) — validate a single email address.

validate_emails(emails[]) — validate up to 20 emails in one call.

CLI

# Install
npm install -g @jesbin/email-validator-cli

# Validate emails
email-validator check foo@bar.com
email-validator check --file emails.csv
email-validator check --json foo@bar.com

# Get an API key
email-validator register --email you@yourcompany.com

# Run as MCP stdio server (for Claude Code, etc.)
EMAIL_VALIDATOR_API_KEY=YOUR_KEY email-validator mcp

Claude Code via stdio (CLI)

{
  "email-validator": {
    "type": "stdio",
    "command": "email-validator",
    "args": ["mcp"],
    "env": { "EMAIL_VALIDATOR_API_KEY": "YOUR_KEY" }
  }
}