Skip to content

ValidKit/validkit-mcp-server

Repository files navigation

ValidKit MCP Server

npm downloads npm version TypeScript License: MIT

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-server

Cursor

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 user@example.com"

validate_emails_bulk

Validate up to 1,000 emails in one request. Returns individual results and summary counts.

"Validate these emails: alice@gmail.com, bob@company.co, test@fake.xyz"

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-server

Links

License

MIT

About

MCP server for ValidKit email validation. Works with Claude Code, Cursor, Windsurf, and any MCP-compatible AI assistant

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors