FairValid
io.github.moonlitnayeemPublished by GitHub account moonlitnayeemv1.1.0Updated Nov 7, 2026
Verify emails and use FairMatch to search, quote and unlock verified work-email leads.
The publisher's own server: Chat With Your Ads
Overview
FairValid verifies email addresses and, through FairMatch, lets an assistant search, quote and unlock verified business leads using workspace credits.
- What you can do
- Verify a single email address or submit a batch of up to 5,000 addresses, then read job status, paged results and cancel remaining work
- Check the workspace's live credit balance
- Discover FairMatch filter keys and limits, preview up to 50 matching people, and quote a selection without reserving credits
- Unlock a confirmed selection of 1-50 contacts under a numerical credit ceiling, then poll the batch and read owned verified contacts
- When to use it
- Useful when you need to clean or validate email lists, or when a sales or recruiting workflow needs to find business contacts and buy verified work emails with a controlled, pre-approved spend.
- Requirements
- Remote Streamable HTTP endpoint with OAuth sign-in; no local package. You approve access on FairValid and select an existing Live API key whose workspace, scopes and lifetime spending cap apply. FairMatch needs the opt-in leads:read and leads:acquire permissions, which require a deliberate reconnect.
Installation
In SourceWeft
- Open FairValid in the dashboard and add it to a workspace.
- Connect the required credentials. They are stored privately and never shown on public pages.
- Enable the server for the chats that should use its tools.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Use with an agent
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.moonlitnayeem%2Ffairvalid/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Other MCP clients
Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.
{
"mcpServers": {
"fairvalid": {
"type": "http",
"url": "https://mcp.fairvalid.com/mcp"
}
}
}README
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 · [email protected]
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 currently available tools and call fairvalid_get_balance; that read spends no verification credits.
Default submission tests use a separate direct Test-key connection and the
documented example.com fixtures. Sandbox work makes no live provider call and
spends no verification credits; Test keys cannot read the live balance.
A controlled live acceptance test requires the workspace owner's explicit authorization. Stay within the authorized test addresses, workspace, selected Live key, and credit limit; live charges and idempotency safeguards still apply. Do not run live tests automatically, use customer lists as installation fixtures, or cancel customer jobs as part of installation tests.
The packages contain manifests, the workflow skill, examples, and brand assets. The optional Zed extension also downloads and runs a pinned local transport bridge and stores OAuth credentials in its extension work directory. No credentials are bundled. Client validation, live protocol checks, and native client tests must each be recorded according to what was actually performed; none implies a provider's approval or publication. See the static validation record.
Privacy policy
When you invoke a tool, the connected AI provider sends the supplied addresses, job and lead identifiers, search criteria, and other tool arguments to FairValid. FairMatch can return owned business-contact data to the connected assistant. FairValid processes them under its Privacy Policy and Terms. The AI provider also processes conversation and tool data under its own terms. Review those policies before connecting. The packages add no analytics. The Zed extension's local OAuth storage is described in its connection instructions. For support or data-handling questions, contact [email protected].
License and brand
The distribution code, manifests, and documentation are available under the MIT License. FairValid names and logos identify the publisher and do not grant trademark rights or permission to imply endorsement of another service. See brand guidance.
Source: README.md at commit 9d3e10c
Tools
0Version history
2- v1.1.0LatestNov 7, 2026
- v1.0.0Oct 30, 2026
Score
75% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 daysRequired25 pts
- Auth declaredRequired10 pts
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts
Declare a license in the repository or the registry entry.
Other Valid integrations
Chat With Your Ads
co.validOfficial publisher
Gives an assistant conversational access to advertising performance data, creative analysis, and campaign insights.
Valid
co.validOfficial publisher
A remote MCP server that gives an assistant conversational access to advertising performance data, creative analysis and campaign insights.
ValidKit
Published by GitHub account OlsOls4
Remote MCP server that lets an assistant validate IBAN, EU VAT, card, ISBN, BIC, EAN and postcode values through a RapidAPI-hosted API.
FabTally Valid
Published by GitHub account zvmzaretsky
A hosted validation suite that lets an assistant check EU VAT numbers, IBANs, email addresses, place names and VINs, with each call paid per use.