BillionVerify

io.github.BillionVerify由 GitHub 账号 BillionVerify 发布v1.1.1更新于 Oct 24, 2026

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

已验证Streamable HTTP可网页运行沟通与协作商业与电商

概览

AI 生成的概览

BillionVerify 让 AI 助手验证单个或批量邮箱地址、查询积分余额、查看验证历史与统计，并管理 webhook。

可以做什么
逐个或每批最多 50 个验证邮箱地址，检查语法、域名邮件服务器，并可选通过 SMTP 检查邮箱，每次检查消耗账户积分。查询账户积分余额和异步验证任务状态。查看验证历史以及 7 天、30 天、90 天和 1 年的汇总统计。获取已完成结果的签名下载链接或 CSV 内容。创建、列出并永久删除用于验证生命周期通知的 webhook 端点。检查服务器健康状态。
适用场景
适合助手需要清洗或校验邮箱列表、在触达前确认地址能否收信，或从 BillionVerify 账户查看验证用量与结果的场景。
运行要求
可使用托管远程端点并通过 OAuth 登录 BillionVerify 账户，或使用本地 npm 包 billionverify-mcp，需 Node.js 18+ 及环境变量 BILLIONVERIFY_API_KEY。可选环境变量 BILLIONVERIFY_API_URL 覆盖 API 基础地址。需要带积分的 BillionVerify 账户。
安装前请注意
验证调用会消耗所连接 BillionVerify 账户的积分，批量运行会产生费用。自托管方式需要在环境中提供 BILLIONVERIFY_API_KEY 密钥。邮箱地址会发送至 BillionVerify 的 API 进行校验。创建和删除 webhook 会更改账户配置，删除为永久操作并立即停止通知。

安装

在 SourceWeft 中

  1. 打开 控制台中的 BillionVerify，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.BillionVerify%2Fbillionverify-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "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

来源：README.md，提交 b223785

工具

11

create_webhook

Create Webhook

Create a webhook endpoint for verification lifecycle notifications.

输入参数url必填events必填

delete_webhook

Delete Webhook

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

输入参数webhook_id必填

get_account_balance

Get Credit Balance

Get the current credit balance for the authenticated account.

无需输入参数。

get_download_url

Get Verification Results Download

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

输入参数rolevalidjob_id必填invalidunknowncatchalldisposable

get_task_status

Get Verification Job Status

Get the current status of an asynchronous verification task.

输入参数task_id必填

get_verification_history

List Verification History

List verification history for the authenticated account.

输入参数pagelimit

get_verification_stats

Get Verification Statistics

Get aggregated verification statistics for the authenticated account.

输入参数period

health_check

Check Server Health

Check the health of the BillionVerify MCP server.

无需输入参数。

list_webhooks

List Webhooks

List all webhook endpoints configured for the authenticated account.

无需输入参数。

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.

输入参数emails必填check_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.

输入参数email必填check_smtpforce_refresh

版本历史

1
  1. v1.1.1最新Oct 13, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。