BillionVerify

io.github.BillionVerifyPublished by GitHub account BillionVerifyv1.1.1Updated Oct 24, 2026

Email verification for AI agents: verify single or bulk emails, check credits and history.

VerifiedStreamable HTTPWeb executableCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

BillionVerify lets an AI assistant verify single or bulk email addresses, check credit balance, review verification history and stats, and manage webhooks.

What you can do
Verify email addresses one at a time or in batches of up to 50, with syntax, domain mail server and optional SMTP mailbox checks, using account credits per check. Check the account credit balance and the status of asynchronous verification tasks. Review verification history and aggregated statistics over 7-day, 30-day, 90-day and 1-year windows. Get signed download URLs for completed results or CSV output. Create, list and permanently delete webhook endpoints for verification lifecycle notifications. Check server health.
When to use it
Useful when an assistant needs to clean or validate email lists, confirm that an address can receive mail before outreach, or monitor verification usage and results from a BillionVerify account.
Requirements
Either the hosted remote endpoint with OAuth sign-in to a BillionVerify account, or the local npm package billionverify-mcp run with Node.js 18+ and the BILLIONVERIFY_API_KEY environment variable. An optional BILLIONVERIFY_API_URL overrides the API base URL. A BillionVerify account with credits is needed.
Before you install
Verification calls consume credits from the connected BillionVerify account, so bulk runs cost money. The self-hosted option requires the BILLIONVERIFY_API_KEY secret in the environment. Email addresses are sent to BillionVerify's API for checking. Webhook creation and deletion change account configuration, and deletion is permanent and stops notifications immediately.

Installation

In SourceWeft

  1. Open BillionVerify in the dashboard and add it to a workspace.
  2. 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.BillionVerify%2Fbillionverify-mcp/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.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "billionverify": {
      "type": "http",
      "url": "https://mcp.billionverify.com/mcp"
    }
  }
}

README

BillionVerify MCP Server — TypeScript

Connect any AI assistant to BillionVerify email verification via the Model Context Protocol. Built with the official MCP TypeScript SDK.

Option 1 — Hosted Server (No Installation)

Use BillionVerify's hosted MCP server. There is nothing to install and no API key to paste: you sign in with your BillionVerify account over OAuth, and the connection is tied to that account.

Server URLhttps://mcp.billionverify.com/mcp
TransportStreamable HTTP
AuthenticationOAuth 2.1 (sign in with your BillionVerify account)

The hosted server does not accept API keys (?api_key=, BV-API-KEY or Authorization: Bearer <api key> are all rejected). If you want to use an API key, use Option 2.

Detailed step-by-step guide: docs/connect-chatgpt-claude.md.

ChatGPT (web)

  1. Settings → Apps & Connectors → Advanced settings → turn on Developer mode.
  2. Settings → Apps & Connectors → Create.
  3. Name BillionVerify, MCP server URL https://mcp.billionverify.com/mcp, authentication OAuth → create.
  4. Sign in to BillionVerify in the window that opens and approve access.
  5. In a new chat, click + → Developer mode → enable BillionVerify.

Claude (claude.ai / Claude Desktop)

  1. Customize → Connectors → + → Add custom connector.
  2. Name BillionVerify, URL https://mcp.billionverify.com/mcp → Add (leave Advanced settings empty).
  3. Click Connect, sign in to BillionVerify and approve access.
  4. In a chat, click + → Connectors and make sure BillionVerify is on.

Team / Enterprise: an Owner adds the connector under Organization settings → Connectors, then each member clicks Connect.

Claude Code

bash
claude mcp add --transport http billionverify https://mcp.billionverify.com/mcp

Then run /mcp inside Claude Code, select billionverify and finish the sign-in in your browser.

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project), then click Connect next to the server in Settings → MCP:

json
{  "mcpServers": {    "billionverify": {      "url": "https://mcp.billionverify.com/mcp"    }  }}

Option 2 — Self-Hosted (TypeScript / Node.js)

Run your own MCP server using this TypeScript implementation.

Prerequisites

  • Node.js 18+

Run via npx (no install)

bash
BILLIONVERIFY_API_KEY=your_api_key npx billionverify-mcp

Claude Desktop config (self-hosted)

json
{  "mcpServers": {    "billionverify": {      "command": "npx",      "args": ["-y", "billionverify-mcp"],      "env": {        "BILLIONVERIFY_API_KEY": "your_api_key_here"      }    }  }}

Install globally

bash
npm install -g billionverify-mcpbillionverify-mcp

Install from source

bash
git clone https://github.com/BillionVerify/billionverify-mcp.gitcd billionverify-mcpnpm installnpm run buildnpm start

Environment Variables

VariableDescriptionDefault
BILLIONVERIFY_API_KEYYour BillionVerify API key—
BILLIONVERIFY_API_URLAPI base URL overridehttps://api.billionverify.com

Available Tools

ToolDescription
verify_single_emailVerify a single email address in real-time
verify_batch_emailsVerify up to 50 emails in one request
get_account_balanceCheck your credit balance
get_verification_historyList verification history (paginated)
get_verification_statsAggregated statistics for 7d / 30d / 90d / 1y
get_task_statusPoll the status of an async file verification job
get_download_urlGet download URL for results with status filters
create_webhookSubscribe to file completion events
list_webhooksList all configured webhooks
delete_webhookRemove a webhook
health_checkCheck server health

License

MIT

Source: README.md at commit b223785

Tools

11

create_webhook

Create Webhook

Create a webhook endpoint for verification lifecycle notifications.

Parametersurlrequiredeventsrequired

delete_webhook

Delete Webhook

Permanently delete a webhook endpoint by identifier. The endpoint stops receiving notifications immediately.

Parameterswebhook_idrequired

get_account_balance

Get Credit Balance

Get the current credit balance for the authenticated account.

Takes no parameters.

get_download_url

Get Verification Results Download

Get a signed download URL for completed results, or CSV content when filtered or rebuilt from history.

Parametersrolevalidjob_idrequiredinvalidunknowncatchalldisposable

get_task_status

Get Verification Job Status

Get the current status of an asynchronous verification task.

Parameterstask_idrequired

get_verification_history

List Verification History

List verification history for the authenticated account.

Parameterspagelimit

get_verification_stats

Get Verification Statistics

Get aggregated verification statistics for the authenticated account.

Parametersperiod

health_check

Check Server Health

Check the health of the BillionVerify MCP server.

Takes no parameters.

list_webhooks

List Webhooks

List all webhook endpoints configured for the authenticated account.

Takes no parameters.

verify_batch_emails

Verify Email Addresses in Batch

Verify 1 to 50 email addresses in one request and return a verdict for each. Split longer lists into chunks of 50. Uses credits from the connected BillionVerify account.

Parametersemailsrequiredcheck_smtp

verify_single_email

Verify Email Address

Verify whether a single email address can receive mail. Checks syntax and the domain's mail servers, and optionally the mailbox over SMTP. Uses credits from the connected BillionVerify account.

Parametersemailrequiredcheck_smtpforce_refresh

Version history

1
  1. v1.1.1LatestOct 13, 2026

Score

90% 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 listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.