@validkit/mcp-server
v1.1.2
Published
Model Context Protocol (MCP) server for ValidKit email validation - works with Claude Code, Cursor, Windsurf, and any MCP-compatible AI assistant
Maintainers
Readme
ValidKit MCP Server
Model Context Protocol (MCP) server for ValidKit email validation. Validate emails directly from Claude Code, Cursor, Windsurf, and any MCP-compatible AI assistant -- syntax checks, MX record verification, disposable detection, and typo suggestions, all without leaving your editor.
Setup
Claude Code
claude mcp add validkit -e VALIDKIT_API_KEY=vk_your_api_key -- npx -y @validkit/mcp-serverCursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"validkit": {
"command": "npx",
"args": ["-y", "@validkit/mcp-server"],
"env": {
"VALIDKIT_API_KEY": "your_key"
}
}
}
}Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"validkit": {
"command": "npx",
"args": ["-y", "@validkit/mcp-server"],
"env": {
"VALIDKIT_API_KEY": "your_key"
}
}
}
}Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"validkit": {
"command": "npx",
"args": ["-y", "@validkit/mcp-server"],
"env": {
"VALIDKIT_API_KEY": "your_key"
}
}
}
}Get Your API Key
Sign up for free at validkit.com/get-started -- 1,000 validations/month included.
Tools
validate_email
Validate a single email address. Returns deliverability status, syntax/DNS/MX checks, disposable/role/free detection, and typo suggestions.
"Validate the email [email protected]"validate_emails_bulk
Validate up to 1,000 emails in one request. Returns individual results and summary counts.
"Validate these emails: [email protected], [email protected], [email protected]"check_usage
Check your API usage stats — total requests, valid/invalid counts, average response time, and rate limit.
"Show my ValidKit usage stats"Environment Variables
| Variable | Required | Description |
|----------|----------|-------------|
| VALIDKIT_API_KEY | Yes | Your ValidKit API key |
| VALIDKIT_API_URL | No | Custom API URL (default: https://api.validkit.com) |
Testing with MCP Inspector
VALIDKIT_API_KEY=vk_test_... npx @modelcontextprotocol/inspector npx -y @validkit/mcp-serverLinks
License
MIT
