ContactLint

ContactLint MCP 服务（contactlint-mcp）

ContactLint 会在 AI Agent 保存或使用电子邮件地址和电话号码前对其进行检查。你可以将其作为本地 stdio MCP 服务（contactlint-mcp，从环境变量读取 CONTACTLINT_API_KEY）运行，也可以直接连接到托管的 Streamable HTTP 端点（https://contactlint.com/mcp）。

• 本地 stdio 二进制文件：contactlint-mcp（./bin/contactlint-mcp.mjs）
• 托管端点：https://contactlint.com/mcp（Streamable HTTP，通过 POST 发送 JSON-RPC）
• 网站：https://contactlint.com/
• MCP 指南：https://contactlint.com/email-validation-mcp-server
• OpenAPI（REST API）：https://contactlint.com/openapi.json
• MCP Registry：com.contactlint/contactlint

工具

工具	输入	功能
validate_email	email	检查语法、通过 DNS-over-HTTPS 查询 MX 和 A 记录、已知的一次性域名、角色地址（admin@、no-reply@）和免费服务提供商；如果域名看起来像某个主要服务提供商的拼写错误（gmial.com），则会建议修正。
validate_emails	emails（1 至 50 个地址）	对最多 50 个地址执行与 validate_email 相同的检查。按相同顺序返回每个地址的结果，并附上判定结果摘要。
validate_phone	phone，可选的 country（ISO 3166-1 alpha-2 默认区域，例如 US）	解析并验证电话号码：有效和可能的标记、线路类型、区域、E.164 格式、国家格式和国际格式。

ContactLint 不会连接邮件服务器（不进行 SMTP 探测），因此无法确认邮箱是否存在，也无法检测全收域名。

initialize 和 tools/list 无需密钥即可使用，因此客户端和目录扫描器可以读取工具列表。tools/call 需要 ContactLint API 密钥（每月 100 次免费检查，无需信用卡）。

选项 1：本地 stdio MCP 服务（推荐用于注册表和桌面客户端）

本地 stdio 服务（bin/contactlint-mcp.mjs）会从 CONTACTLINT_API_KEY 密钥环境变量读取 API 密钥，并将经过身份验证的工具调用转发到 https://contactlint.com/mcp。

环境变量

变量	必需	密钥	说明
CONTACTLINT_API_KEY	是	是	你的 ContactLint API 密钥，以 Authorization: Bearer <key> 形式发送。在 https://contactlint.com/signup 获取免费密钥（每月 100 次检查，无需信用卡）
CONTACTLINT_MCP_URL	否	否	可选的端点覆盖值（默认为 https://contactlint.com/mcp）

客户端配置（通过 npx 使用 stdio）

{
  "mcpServers": {
    "contactlint": {
      "command": "npx",
      "args": ["-y", "github:zksyncer/contactlint"],
      "env": {
        "CONTACTLINT_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

或者，在本地安装后使用（npm install -g github:zksyncer/contactlint 或 pnpm add contactlint-mcp）：

{
  "mcpServers": {
    "contactlint": {
      "command": "contactlint-mcp",
      "env": {
        "CONTACTLINT_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

选项 2：托管的 Streamable HTTP MCP 服务

如果你的 MCP 客户端支持在远程 streamable-http 服务上使用自定义 HTTP 标头，你可以直接连接，无需安装任何内容：

{
  "mcpServers": {
    "contactlint": {
      "type": "http",
      "url": "https://contactlint.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

计费

• 每检查一个地址或号码计为一次检查。包含 20 个地址的 validate_emails 调用会使用 20 次检查。
• DNS 查询失败的地址会返回 unknown（dns_error），且不计费。
• 如果密钥的剩余检查次数不足以处理整个 validate_emails 列表，则不会检查任何地址，也不会计费。
• 每月可免费检查 100 次，无需信用卡。
• 点数包：5,000 次检查售价 $9，25,000 次售价 $35，100,000 次售价 $99。

免费工具

免费的浏览器工具（一次性电子邮件检查器、电话号码验证器、一次性域名列表）位于 https://contactlint.com/tools

许可证

MIT，详见 LICENSE。