Model Context Protocol (MCP) server for ValidKit email validation. This allows any MCP-compatible AI assistant or tool to validate emails directly through ValidKit's API.

npm install -g @validkit/mcp-server

Or install from source:

git clone https://github.com/jesselpalmer/validkit-mcp-server.git cd validkit-mcp-server npm install npm run build npm link

Sign up for free at validkit.com to get your API key.

Add to your configuration (~/Library/Application Support/Claude/claude_desktop_config.json on Mac):

{"mcpServers":{"validkit":{"command": "npx", "args": ["-y", "@validkit/mcp-server"], "env":{"VALIDKIT_API_KEY": "your_api_key_here" } } } }

Consult your MCP client's documentation for configuration details. The server runs on stdio transport.

See config-examples.json in this repository for example configurations.

The ValidKit tools will now be available!

Validate a single email address.

Parameters:

• email (required): Email address to validate
• detailed (optional): Return detailed validation checks (default: false)

Example usage in Claude:

Can you validate the email address [email protected]? 

Validate multiple email addresses (up to 1000).

Parameters:

• emails (required): Array of email addresses
• detailed (optional): Return detailed validation checks (default: false)

Example usage in Claude:

Please validate these emails: - [email protected] - [email protected] - [email protected]

• VALIDKIT_API_KEY (required): Your ValidKit API key
• VALIDKIT_API_URL (optional): API base URL (default: https://api.validkit.com)

Create a .env file in your project:

VALIDKIT_API_KEY=vk_live_your_api_key_here

Optimized for token efficiency:

Email: [email protected] Status: valid Valid: true 

Full validation details when detailed: true:

{"email": "[email protected]", "valid": true, "status": "valid", "checks":{"syntax": true, "dns": true, "mx": true, "disposable": false, "role": false, "free": false }, "metadata":{"domain": "example.com", "provider": "Example Mail" } }

npm install npm run dev

npm run build

# Test without installing npx @validkit/mcp-server validkit-mcp-test # Or after installing globally validkit-mcp-test

npx @modelcontextprotocol/inspector npx -y @validkit/mcp-server

The server runs in demo mode when no API key is set, allowing you to test without an account.

• ValidKit Homepage
• API Documentation
• MCP Documentation
• GitHub Repository

MIT License - see LICENSE file for details.

• Email: [email protected]
• Documentation: docs.validkit.com
• Issues: GitHub Issues