validkit-mcp-server

ValidKit/validkit-mcp-server

3.2

If you are the rightful owner of validkit-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The ValidKit MCP Server is a Model Context Protocol server designed for email validation, allowing integration with MCP-compatible AI assistants and tools.

Tools

  1. validate_email

    Validate a single email address with optional detailed checks.

  2. validate_emails_bulk

    Validate multiple email addresses (up to 1000) with optional detailed checks.

ValidKit MCP Server

npm version License: MIT

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.

🚀 Quick Start

1. Install the MCP Server

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

2. Get Your API Key

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

3. Configure Your MCP Client

For Claude Desktop

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"
      }
    }
  }
}
For Other MCP Clients

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.

4. Restart Your MCP Client

The ValidKit tools will now be available!

📋 Available Tools

validate_email

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 test@example.com?

validate_emails_bulk

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:
- john@gmail.com
- fake@nonexistentdomain.com
- disposable@10minutemail.com

🔧 Configuration

Environment Variables

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

Using with .env file

Create a .env file in your project:

VALIDKIT_API_KEY=vk_live_your_api_key_here

📖 Response Formats

Compact Response (Default)

Optimized for token efficiency:

Email: test@example.com
Status: valid
Valid: true

Detailed Response

Full validation details when detailed: true:

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

🛠️ Development

Running locally:

npm install
npm run dev

Building:

npm run build

Testing the MCP Server:

Interactive Test CLI:
# Test without installing
npx @validkit/mcp-server validkit-mcp-test

# Or after installing globally
validkit-mcp-test
MCP Inspector:
npx @modelcontextprotocol/inspector npx -y @validkit/mcp-server
Demo Mode:

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

🔗 Links

📄 License

MIT License - see LICENSE file for details.

🤝 Support