BillionVerify

BillionVerify MCP Server — TypeScript

通过模型上下文协议，将任意 AI 助手连接到 BillionVerify 邮箱验证服务。本项目使用官方 MCP TypeScript SDK构建。

---

选项 1 — 托管服务（无需安装）

使用 BillionVerify 托管的 MCP 服务。无需安装任何内容，也无需粘贴 API 密钥：使用 BillionVerify 账号通过 OAuth 登录，连接将关联到该账号。

服务 URL	https://mcp.billionverify.com/mcp
传输方式	Streamable HTTP
身份验证	OAuth 2.1（使用 BillionVerify 账号登录）

托管服务不接受 API 密钥（?api_key=、BV-API-KEY 或 Authorization: Bearer <api key> 均会被拒绝）。如果要使用 API 密钥，请选择选项 2。

详细分步指南：docs/connect-chatgpt-claude.md。

ChatGPT（网页版）

1. Settings → Apps & Connectors → Advanced settings → 开启 Developer mode。
2. Settings → Apps & Connectors → Create。
3. 名称填写 BillionVerify，MCP 服务 URL 填写 https://mcp.billionverify.com/mcp，身份验证选择 OAuth → 创建。
4. 在打开的窗口中登录 BillionVerify 并批准访问。
5. 在新聊天中，点击 + → Developer mode → 启用 BillionVerify。

Claude（claude.ai / Claude Desktop）

1. Customize → Connectors → + → Add custom connector。
2. 名称填写 BillionVerify，URL 填写 https://mcp.billionverify.com/mcp → Add（保留 Advanced settings 为空）。
3. 点击 Connect，登录 BillionVerify 并批准访问。
4. 在聊天中，点击 + → Connectors，并确认已启用 BillionVerify。

团队版 / 企业版：由所有者在 Organization settings → Connectors 下添加连接器，然后每位成员点击 Connect。

Claude Code

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

然后在 Claude Code 中运行 /mcp，选择 billionverify 并在浏览器中完成登录。

Cursor

添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目），然后点击 Settings → MCP 中服务旁边的 Connect：

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

---

选项 2 — 自托管（TypeScript / Node.js）

使用此 TypeScript 实现运行自己的 MCP 服务。

前提条件

• Node.js 18+

通过 npx 运行（无需安装）

BILLIONVERIFY_API_KEY=your_api_key npx billionverify-mcp

Claude Desktop 配置（自托管）

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

全局安装

npm install -g billionverify-mcp
billionverify-mcp

从源代码安装

git clone https://github.com/BillionVerify/billionverify-mcp.git
cd billionverify-mcp
npm install
npm run build
npm start

环境变量

变量	描述	默认值
BILLIONVERIFY_API_KEY	你的 BillionVerify API 密钥	—
BILLIONVERIFY_API_URL	API 基础 URL 覆盖值	https://api.billionverify.com

---

可用工具

工具	描述
verify_single_email	实时验证单个邮箱地址
verify_batch_emails	在一次请求中验证最多 50 个邮箱
get_account_balance	查看你的余额
get_verification_history	列出验证历史记录（分页）
get_verification_stats	7d / 30d / 90d / 1y 的汇总统计数据
get_task_status	查询异步文件验证任务的状态
get_download_url	获取带状态筛选的结果下载 URL
create_webhook	订阅文件完成事件
list_webhooks	列出所有已配置的 Webhook
delete_webhook	移除 Webhook
health_check	检查服务运行状况

---

许可证

MIT