Metadata-Version: 2.4
Name: email-verifier-mcp
Version: 0.1.1
Summary: MCP server for verifying email addresses via the RightEmails API
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# email-verifier-mcp

An MCP (Model Context Protocol) server for verifying email addresses using the [RightEmails API](https://emailverifier.reachstream.com). Connect it to Claude and verify emails using natural language.

## Installation

```bash
pip install email-verifier-mcp
```

## Prerequisites

You need a [RightEmails](https://emailverifier.reachstream.com) account to get:
- `RIGHTEMAILS_API_KEY` — your API key
- `RIGHTEMAILS_REQUEST_ORIGIN` — the email address registered with your API key

## Setup with Claude Code

Run this command to add the MCP server:

```bash
claude mcp add email-verifier email-verifier-mcp \
  -e RIGHTEMAILS_API_KEY=your-api-key \
  -e RIGHTEMAILS_REQUEST_ORIGIN=your@email.com
```

## Setup with Claude Desktop

Add this to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "email-verifier": {
      "command": "email-verifier-mcp",
      "env": {
        "RIGHTEMAILS_API_KEY": "your-api-key",
        "RIGHTEMAILS_REQUEST_ORIGIN": "your@email.com"
      }
    }
  }
}
```

## Usage

Once connected, just ask Claude naturally:

> *"Verify this email: john@example.com"*

> *"Check if these emails are valid: alice@company.com, bob@gmail.com, carol@domain.org"*

Claude will handle the verification and return results for each email.

## Available Tools

| Tool | Description |
|------|-------------|
| `verify_emails_and_wait` | Submit emails and wait for results (recommended) |
| `submit_email_verification` | Submit emails and get a job ID immediately |
| `check_email_verification_status` | Check status of a submitted job by ID |
| `check_multiple_verification_statuses` | Check status of multiple jobs at once |

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `RIGHTEMAILS_API_KEY` | Yes | Your RightEmails API key |
| `RIGHTEMAILS_REQUEST_ORIGIN` | Yes | Email address registered with your API key |
| `RIGHTEMAILS_BASE_URL` | No | Override the API base URL (default: `https://emailverifier.reachstream.com`) |

## License

MIT
