FairValid

FairValid for AI assistants

FairValid 1.1.0: FairMatch API/MCP passed controlled production sandbox

acceptance on November 6, 2026. Provider listings and native-client acceptance

are tracked separately. Discover the connected server capabilities before use;

acquisition requires an explicit numerical credit limit and confirmation.

Verify email addresses and use FairMatch by FairValid to find business leads, quote selected contacts, and unlock verified work emails with a confirmed credit ceiling. This package connects to FairValid's hosted Model Context Protocol (MCP) server and includes separate verification and FairMatch workflow skills.

Server: https://mcp.fairvalid.com/mcp Transport: Streamable HTTP Publisher and support: FairValid · nayeem@fairvalid.com Documentation: fairvalid.com/help/mcp

Connect your workspace

Use OAuth in a supported client. Sign in and approve access on FairValid, then select an existing Live API key covering the requested permissions. Its workspace, scopes, and lifetime spending cap apply to the connection. A workspace Owner or Manager can manage keys on the API keys page. Revoking the selected key ends its connections.

FairMatch adds opt-in leads:read and leads:acquire permissions. Existing keys and grants keep their existing permissions; a package update cannot expand them. To enable FairMatch, deliberately reconnect through native OAuth and select an appropriately scoped key. Review the new permissions and cap before consent. OpenAI 1.1.0 requests both lead scopes during fresh authorization. OpenClaw and Hermes include all six FairMatch tools alongside the three verification reads. Their filters do not grant OAuth permissions or authorize spending: unlock still requires leads:acquire, a quote and explicit approval of a numerical maximum.

No client secret is bundled or required for automatic public client registration. Never paste a key, password, OAuth code, or token into chat. For a client that uses bearer headers, configure an existing key through its protected credential settings. A direct Test key can be used for sandbox fixtures; OAuth currently selects Live keys.

Supported package formats

Package configuration does not establish a marketplace listing or prove a successful connection in every client. Provider account access, permissions, review, and native client acceptance are separate steps.

For Claude Code 2.1.275 or later, install inside a session with /plugin install fairvalid --marketplace moonlitnayeem/fairvalid-ai. For older versions, use /plugin marketplace add moonlitnayeem/fairvalid-ai followed by /plugin install fairvalid@fairvalid. These forms follow the official installation reference. The marketplace installs the dedicated claude/ package. A maintainer can validate that folder with claude plugin validate /path/to/fairvalid-ai/claude --strict --profile directory. Users can review and load a local public checkout with claude --plugin-dir /path/to/fairvalid-ai/claude. For Gemini CLI, the public repository can be installed with gemini extensions install https://github.com/moonlitnayeem/fairvalid-ai. These commands require that the referenced checkout or published repository exists. Review client trust prompts and complete OAuth before using the tools.

OpenClaw marketplace installation

FairValid 1.1.0 is published on ClawHub. Install and enable the FairValid plugin, then open Plugins → FairValid → Accounts in your OpenClaw Gateway. Choose Connect beside fairvalid and complete the FairValid browser consent. Select your workspace and a Live API key covering the requested permissions and an appropriate lifetime spending cap.

Start a new agent session and ask “Show my FairValid credit balance.” For FairMatch, ask to search and quote leads before approving an exact selection and numerical credit ceiling. The published bundle exposes all six FairMatch tools and three verification read tools. Existing connections need deliberate consent for the lead permissions.

On November 6, 2026, all six FairMatch tools passed a live end-to-end test through the installed ClawHub 1.1.0 bundle on OpenClaw 2026.11.1, using its native Claude CLI runtime with Claude Code 2.1.312. The test retrieved an existing owned contact through a confirmed zero-credit batch, with no additional acquisition charge.

VS Code marketplace installation

Open Chat → Open Customizations → Browse, search for FairValid, and choose Install on the MCP Gallery listing published by moonlitnayeem. The listing includes email verification and FairMatch and links to the public GitHub MCP Registry entry.

After installation, open MCP Servers to find FairValid. Start the server and complete the client's FairValid connection and consent flow before using tools. Choose a key with the lead permissions if you want to use FairMatch.

Native marketplace search and installation of version 1.1.0 were verified in VS Code 1.145.2 on November 6, 2026. That check did not require signing in to Copilot. OAuth and FairMatch tool execution in VS Code have not yet been qualified by this acceptance test.

Devin personal installation

FairValid is submitted to the official Devin marketplace and awaits provider review and merge. Public marketplace search and installation have not yet been established.

To install personally, open Customize → Plugins, choose Myself, then Add plugin → From repository. Enter https://github.com/moonlitnayeem/fairvalid-ai and subdirectory devin. The package includes the FairValid MCP connection and three skills: fairmatch-setup, fairmatch-leads, and verification-results.

Personal installation and /fairvalid:fairmatch-setup execution were verified in Devin Desktop 3.11.238 on November 6, 2026, using SWE-2 Flash Medium in Ask mode. The installed package matched the reviewed source, and the native session loaded the complete packaged setup skill before producing its response. This help skill uses public information and makes no MCP calls. The connection remained unconnected; OAuth and FairMatch business-tool execution in Devin have not yet been qualified. Package details.

What you can do

Examples of requests:

• “Show my FairValid credit balance.”
• “Show the current status and results for this FairValid job.”
• “Verify these email addresses with FairValid.”
• “Find FairMatch leads matching my criteria, then show a quote before unlocking.”
• “Show my saved FairMatch leads without acquiring any new contacts.”

The verification request starts live work when connected through OAuth or a Live key. Only submit addresses you intend to verify and are authorized to process.

Credits and result interpretation

Live submissions can reserve credits and return an asynchronous job. Completed Valid and Invalid checks use one credit each. Genuine Unknown, unresolved catch-all, technical failures, and unprocessed items have no net verification charge. Cancellation does not reverse charges for completed checks; in-flight work may still finish. A spending cap does not add credits to a workspace.

An accepted job is not a completed result. Poll with backoff, honor retry hints, and follow the results cursor to read all pages. Keep pending and unprocessed items distinct from final results. Unknown or unresolved catch-all is not proof of validity; Valid is not a guarantee of inbox delivery.

Both submission tools require a stable idempotency_key. On an uncertain response, keep the same selected API-key identity, same key, and unchanged input. Reconnecting to a different API key can create another run even if the idempotency key is unchanged. Do not rotate keys or resubmit with a new key just to make an uncertain request appear successful.

FairMatch selection, credits and confirmation

FairMatch follows search → quote → explicit maximum-credit confirmation → unlock → poll batch → retrieve owned leads. Four credits are charged for each newly acquired verified work email; already-owned and unavailable contacts cost zero. A quote reserves no credits and does not guarantee a deliverable contact. Unlock accepts 1–50 distinct selection IDs, maximumCredits from 0–200, confirm: true, and a stable idempotency_key. Only set confirmation after the user approves that exact selection and numerical ceiling. Do not split work to bypass the ceiling, workspace balance or key's shared lifetime cap.

Live selections expire after 30 minutes. If admission is uncertain, reuse the original IDs, ceiling, idempotency key and API-key identity; do not refresh the selection or make another paid batch to hide uncertainty. Accepted batches can remain working; follow batch_id and report observed charged_credits after processing. Lead ownership does not authorize outreach.

See the FairMatch API/MCP guide for exact argument fields, permission upgrades, synthetic test cases and release limits, and the FairMatch skill for the complete workflow.

Connection and acceptance tests

A connection or installation request does not authorize customer verification or job cancellation or lead acquisition. For an authorized OAuth connection check, discover the cur