email-verifier

Verifox MCP Server

MCP（Model Context Protocol）服务，为 Claude 和其他 AI 助手提供 Verifox API，可验证电子邮件的可送达性并查找商务电子邮件，支持单封和批量操作。

快速开始（已发布的软件包）

将以下内容添加到 Claude Desktop 配置（~/Library/Application Support/Claude/claude_desktop_config.json）或 Claude Code MCP 配置中——无需安装，npx 会自动获取：

{
  "mcpServers": {
    "verifox": {
      "command": "npx",
      "args": ["-y", "verifox-mcp"],
      "env": {
        "VERIFOX_API_KEY": "foxkey_your_key_here"
      }
    }
  }
}

在 https://verifox.ai/dashboard/api 获取免费 API 密钥（1,000 个积分）。重启 Claude Desktop，然后让它“验证这些电子邮件”。

工具

工具	功能	积分
verify_email	验证一封电子邮件——SMTP 可送达性、catch-all、一次性邮箱、角色、是否免费，以及 0-100 分的评分	1 / 封邮件
verify_emails	批量验证邮件列表——提交任务、等待，并返回每封邮件的结果	1 / 封邮件
find_email	根据姓名和公司域名查找一封商务电子邮件（最佳匹配或 not_found）	10 / 次查找
find_emails	批量查找联系人列表中的电子邮件（每位联系人提供姓名和域名）	10 / 位联系人
get_credits	查看账户剩余的 Fox Credit 余额	免费
get_job	查询长时间运行的 verify_emails / find_email / find_emails 任务并获取结果	—

对于较大的列表，验证和查找会异步执行：批量工具会在当前请求中等待约 55 秒；如果任务耗时更长，则会返回 jobId，之后可通过 get_job 获取结果。缓存的验证不消耗积分。

本地开发

使用 Bun 直接从源码运行（无需构建）：

cd mcp
bun install

{
  "mcpServers": {
    "verifox": {
      "command": "bun",
      "args": ["run", "/FULL/PATH/TO/Verifox-api/mcp/src/index.ts"],
      "env": {
        "VERIFOX_API_URL": "https://api.verifox.ai",
        "VERIFOX_API_KEY": "foxkey_your_key_here"

```json
{
  "mcpServers": {
    "verifox": {
      "command": "bun",
      "args": ["run", "/FULL/PATH/TO/Verifox-api/mcp/src/index.ts"],
      "env": {
        "VERIFOX_API_URL": "https://api.verifox.ai",
        "VERIFOX_API_KEY": "foxkey_your_key_here"
      }
    }
  }
}

如果未设置，VERIFOX_API_URL 默认为 https://api.verifox.ai。若要在本地对端口 8001 上的 API 进行开发，请将其设为 http://localhost:8001。

3. 重启 Claude Desktop

这些工具会显示在 Claude 的工具列表中。

远程（HTTP）模式

同一服务也可以作为 streamable-HTTP MCP 端点运行（适用于 Smithery、claude.ai 连接器及其他远程 MCP 客户端）。设置 MCP_TRANSPORT=http（或设置 PORT）后，服务会监听 POST /mcp，并提供 GET /health 健康检查：

MCP_TRANSPORT=http PORT=8080 node dist/index.js
# or: docker build -t verifox-mcp . && docker run -p 8080:8080 verifox-mcp

在 HTTP 模式下，每个请求都会通过 Authorization: Bearer <foxkey> 标头读取 Verifox API 密钥（也接受 x-api-key 或 ?api_key=），因此一个托管端点可服务多位用户，每位用户使用自己的积分。

使用示例

在 Claude Desktop 中直接提问：

• “扫描 stripe.com 是否存在安全问题”
• “检查 [email protected] 是否为有效电子邮件”
• “为这些电子邮件评分：[email protected]、[email protected]、[email protected]”
• “查找 Patrick Collison 在 stripe.com 的电子邮件”
• “对 tesla.com 进行 OSINT——查找子域名和电子邮件”
• “测试 turnix.co 的电子邮件服务器”
• “检查 google.com 的 DMARC 策略”

环境变量

变量	默认值	说明
VERIFOX_API_URL	https://api.verifox.ai	Verifox API 基础 URL
VERIFOX_API_KEY	（空）	每位用户的 API 密钥（foxkey_*），通过 x-api-key 发送

在 Verifox 控制面板（API Keys）中生成 foxkey_* 密钥。该密钥用于验证每次工具调用，并从对应账户扣除 Fox Credits（验证和查找每次各消耗 1 个积分；评分和 DNS 扫描免费）。