FairValid

面向 AI 助手的 FairValid

通过 AI 助手验证电子邮件地址、跟踪验证任务，并在 FairValid 工作区中查看 结果。此软件包连接到 FairValid 托管的模型上下文协议（MCP）服务，并附带一项技能，用于处理验证、 额度、重试和结果解读。

服务： https://mcp.fairvalid.com/mcp
传输方式： Streamable HTTP
发布者和支持： FairValid · [email protected]
文档： fairvalid.com/help/mcp

连接工作区

在受支持的客户端中使用 OAuth。登录并在 FairValid 上批准访问，然后选择一个现有的 Live API 密钥，该密钥需涵盖 所请求的权限。该密钥的工作区、范围和有效期内支出上限将应用于此连接。工作区 Owner 或 Manager 可以在 API keys 页面管理密钥。撤销所选 密钥将终止其连接。

自动注册公开客户端时，无需捆绑或提供客户端密钥。 切勿在聊天中粘贴密钥、密码、OAuth 授权码或令牌。对于使用 Bearer 标头的客户端， 请通过其受保护的凭据设置配置现有密钥。沙盒测试数据可使用直接 Test 密钥；OAuth 目前 会选择 Live 密钥。

支持的软件包格式

客户端	包含的配置
Claude / Claude Code	claude 中的专用插件包
ChatGPT / Codex	openai 中的独立可移植插件包
Grok Build	兼容 Claude 的插件和 MCP 文件，以及共享技能
Cursor	.cursor-plugin/plugin.json、mcp.json 和共享技能
Gemini CLI	根目录下的 gemini-extension.json 和共享技能
Hermes Agent（Nous Research）	examples 中的原生 HTTP OAuth 设置和共享技能
OpenClaw	openclaw 中的独立 Claude 格式包
其他 MCP 客户端	examples 中的特定提供方配置

软件包配置并不意味着已在应用市场上架，也不代表已在每个客户端中成功连接。提供方帐户访问权限、权限设置、 审核和客户端原生接受流程都是独立步骤。

对于 Claude Code 2.1.275 或更高版本，请在会话中使用 /plugin install fairvalid --marketplace moonlitnayeem/fairvalid-ai 进行安装。 对于较早版本，请先运行 /plugin marketplace add moonlitnayeem/fairvalid-ai， 再运行 /plugin install fairvalid@fairvalid。 这些命令形式遵循官方安装参考。 此应用市场会安装专用的 claude/ 软件包。维护者可以使用以下命令 验证该目录： claude plugin validate /path/to/fairvalid-ai/claude --strict --profile directory。 用户可以使用 claude --plugin-dir /path/to/fairvalid-ai/claude 查看并加载本地公开检出版本。 对于 Gemini CLI，可以使用 gemini extensions install https://github.com/moonlitnayeem/fairvalid-ai 安装公开仓库。 这些命令要求所引用的检出版本或已发布仓库确实存在。 使用工具前，请查看客户端信任提示并完成 OAuth 授权。

你可以做什么

工具	用途	权限
fairvalid_verify_email	提交一个地址进行验证	submit
fairvalid_submit_job	批量提交 1 到 5,000 个地址	submit
fairvalid_get_job	读取任务的状态和摘要	read
fairvalid_get_results	每页最多读取 50 条结果	read
fairvalid_cancel_job	取消任务中剩余的工作	submit
fairvalid_get_balance	读取工作区的实时额度	balance

请求示例：

• “显示我的 FairValid 额度余额。”
• “显示此 FairValid 任务的当前状态和结果。”
• “使用 FairValid 验证这些电子邮件地址。”

通过 OAuth 或 Live 密钥连接时，最后一个请求会启动实时验证。 仅提交你打算验证且获准处理的地址。

额度与结果解读

实时提交可能会预留额度，并返回异步任务。已完成的 Valid 和 Invalid 检查各消耗一个额度。真正的 Unknown、未解决的 catch-all、技术故障以及未处理项目不会产生净验证费用。取消任务不会退还已完成检查的费用；正在处理的工作仍可能完成。支出上限不会为工作区增加额度。

任务已接受并不代表结果已完成。请使用退避策略轮询、遵循重试提示，并按照结果游标读取所有页面。请将待处理和未处理项目与最终结果区分开。Unknown 或未解决的 catch-all 不能证明地址有效；Valid 也不保证邮件能送达收件箱。

两个提交工具都需要稳定的 idempotency_key。响应状态不确定时，请保持所选 API 密钥身份不变、密钥不变且输入不变。即使 idempotency_key 未变，改用另一个 API 密钥重新连接也可能创建另一次运行。不要轮换密钥，也不要仅为让不确定的请求看起来成功而使用新密钥重新提交。

连接与验收测试

连接或安装请求不代表已获准验证客户信息或取消任务。对于已授权的 OAuth 连接检查，请发现这六个工具并调用 fairvalid_get_balance；此读取操作不会消耗验证额度。

默认提交测试使用单独的直连 Test 密钥连接和文档中所述的 example.com 测试数据。沙盒操作不会调用实时服务商，也不会消耗验证额度；Test 密钥无法读取实时余额。

受控实时验收测试需要获得工作区所有者的明确授权。请将测试限制在已授权的测试地址、工作区、所选 Live 密钥和额度上限内；实时费用和幂等性保护措施仍然适用。不要自动运行实时测试，不要将客户名单用作安装测试数据，也不要在安装测试中取消客户任务。

此软件包不会安装主机设置、运行本地可执行文件、定义钩子或捆绑凭据。它包含清单、工作流技能、示例和品牌素材。客户端验证、实时协议检查和原生客户端测试必须分别根据实际执行情况记录；这些记录都不代表服务商已批准或发布。请参阅静态验证记录。

隐私政策

调用工具时，已连接的 AI 提供商会将提供的地址、任务 ID 和其他工具参数发送给 FairValid。FairValid 会依据其隐私政策和条款处理这些信息。AI 提供商也会依据其自身条款处理对话和工具数据。连接前请先查阅这些政策。此软件包本身不会添加分析功能、本地数据库或额外的数据目的地。如有支持或数据处理方面的问题，请联系 [email protected]。

许可证与品牌

分发代码、清单和文档均根据 MIT License 提供。FairValid 名称和徽标用于标识发布方，不授予商标权，也不允许暗示获得其他服务的认可。 请参阅品牌指南。