MCP Server

MCP Server for email checker. Integrate email verification with Claude, Cursor, and AI assistants.

模型上下文協定（MCP）是 Anthropic 推出的開放協定，使 AI 模型能夠安全地與外部工具和資料來源互動。BillionVerify 透過 HTTP Streamable Transport 為 AI 代理提供企業級郵箱驗證功能，整合極為簡便。


MCP Server 版本	2.1.0
服務端點	`https://mcp.billionverify.com/mcp`
可用工具	9
協定	MCP 2024-11-05

為什麼 AI 代理需要郵箱驗證

現代 AI 代理的應用場景包括：

Claude Code 在處理使用者資料時需要驗證郵箱地址
OpenCode 在自動化工作流程中需要郵箱驗證
Gemini CLI 代理在處理註冊資料時需要品質保證
Codex 生成的程式碼需要內建郵箱驗證邏輯
自訂 AI 代理 在與人類互動時需要確認聯絡方式的真實性

BillionVerify MCP 讓任何 AI 代理都能透過 HTTP Streamable Transport 標準直接呼叫企業級郵箱驗證服務——無需複雜配置。

核心功能

1. 單個郵箱即時驗證

驗證郵箱格式、網域和 MX 記錄
可選的 SMTP 連線檢查
一次性郵箱偵測
企業與免費郵箱識別
角色郵箱偵測（support@、noreply@ 等）
平均回應時間 < 2 秒

2. 批次郵箱驗證

一次最多驗證 50 個郵箱
並行處理以提高效率
詳細結果和統計資料

3. 智慧快取系統

有效郵箱快取 7 天
無效郵箱快取 7 天
未知狀態快取 10 分鐘
減少不必要的重複驗證

4. 精確積分計費

有效郵箱：1 積分
無效郵箱：0 積分（防止浪費）
未知狀態：0 積分（自動重試）
即時餘額查詢

支援的 AI 客戶端

客戶端	類型	狀態	描述
Claude Desktop	桌面應用	支援	Mac/Windows 桌面應用程式
Claude Code	CLI	支援	Anthropic 的 CLI 程式設計助手
OpenCode	CLI	支援	開源 AI 程式設計助手
Gemini CLI	CLI	支援	Google 的命令列 AI 代理
Codex	CLI	支援	OpenAI 的程式碼生成代理
Cursor	IDE	支援	AI 驅動的程式碼編輯器
Zed	IDE	支援	高效能程式碼編輯器
Cline (VS Code)	擴充	支援	VS Code AI 擴充
Continue	擴充	支援	開源 AI 助手
Windsurf	IDE	支援	AI 原生程式碼編輯器
Droid	CLI	支援	Android 開發 AI 助手

快速設定（HTTP Transport - 推薦）

最簡單的整合方式——無需安裝 npm 套件！

步驟 1：取得 API Key

造訪 BillionVerify 控制面板建立您的 API 金鑰。

步驟 2：設定 Claude Desktop

編輯設定檔：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "billionverify": {
      "command": "curl",
      "args": ["--stdio", "https://mcp.billionverify.com/mcp?api_key=YOUR_API_KEY"]
    }
  }
}

將 YOUR_API_KEY 替換為您的實際 API 金鑰，然後重新啟動 Claude Desktop。

完成！無需 npm install，無需依賴。curl 已預裝在所有系統上。Claude 現在具備郵箱驗證功能了。

步驟 3：開始驗證

在對話中，直接詢問：

請驗證這個郵箱：user@example.com

Claude 會自動呼叫 BillionVerify 並返回詳細結果。

Claude Code 設定

對於 Claude Code CLI，新增 MCP 伺服器：

claude mcp add billionverify -- curl --stdio "https://mcp.billionverify.com/mcp?api_key=YOUR_API_KEY"

或新增到您的 ~/.claude.json：

{
  "mcpServers": {
    "billionverify": {
      "command": "curl",
      "args": ["--stdio", "https://mcp.billionverify.com/mcp?api_key=YOUR_API_KEY"]
    }
  }
}

OpenCode 設定

對於 OpenCode，在 ~/.opencode/config.json 中設定：

{
  "mcpServers": {
    "billionverify": {
      "command": "curl",
      "args": ["--stdio", "https://mcp.billionverify.com/mcp?api_key=YOUR_API_KEY"]
    }
  }
}

Gemini CLI 設定

對於 Gemini CLI，新增到您的設定中：

{
  "mcpServers": {
    "billionverify": {
      "command": "curl",
      "args": ["--stdio", "https://mcp.billionverify.com/mcp?api_key=YOUR_API_KEY"]
    }
  }
}

Cursor 設定

在 Cursor 中，前往 Settings > MCP 並新增：

{
  "billionverify": {
    "command": "curl",
    "args": ["--stdio", "https://mcp.billionverify.com/mcp?api_key=YOUR_API_KEY"]
  }
}

NPX 方式（替代方案）

如果您偏好使用 npm 套件方式：

{
  "mcpServers": {
    "billionverify": {
      "command": "npx",
      "args": ["-y", "@billionverify/mcp-server"],
      "env": {
        "BV_API_KEY": "your-api-key-here"
      }
    }
  }
}

可用工具

verify_single_email

驗證單個郵箱地址，提供全面驗證。

參數：

參數	類型	必需	描述
email	string	是	要驗證的郵箱地址
check_smtp	boolean	否	啟用 SMTP 驗證（預設：false）
force_refresh	boolean	否	繞過快取取得最新結果（預設：false）

返回：

{
  "email": "user@example.com",
  "status": "valid",
  "score": 1,
  "is_deliverable": true,
  "is_disposable": false,
  "is_catchall": false,
  "is_role": false,
  "is_free": true,
  "domain": "example.com",
  "mx_records": ["has_mx_records"],
  "smtp_check": true,
  "response_time": 2,
  "credits_used": 1
}

在 Claude 中的使用範例：

「檢查 test@example.com 是否是有效郵箱」

verify_batch_emails

一次驗證多個郵箱地址（最多 50 個）。

參數：

參數	類型	必需	描述
emails	string[]	是	郵箱地址陣列（最多 50 個）
check_smtp	boolean	否	啟用 SMTP 驗證

返回：

{
  "total_emails": 2,
  "valid_emails": 2,
  "invalid_emails": 0,
  "results": [...],
  "credits_used": 2,
  "process_time": 4
}

在 Claude 中的使用範例：

「驗證這些郵箱：user1@example.com, user2@test.com, info@company.com」

get_account_balance

查詢帳戶積分和使用統計。

參數： 無

返回：

{
  "account_id": "acc_xxx",
  "credits_balance": 842740,
  "credits_consumed": 157260,
  "credits_added": 1000000,
  "last_updated": "2026-02-05T04:51:35Z"
}

在 Claude 中的使用範例：

「我還有多少驗證積分？」

health_check

檢查 MCP 伺服器健康狀態。

參數： 無

返回：

{
  "status": "healthy",
  "version": "2.1.0",
  "service": "billionverify-mcp",
  "mode": "api-proxy"
}

get_task_status

查詢檔案驗證任務進度。

參數：

參數	類型	必需	描述
task_id	string	是	檔案上傳的任務 ID

返回：

{
  "job_id": "job-uuid-xxxxx",
  "status": "completed",
  "progress": 100,
  "total_emails": 1000,
  "processed_emails": 1000,
  "valid_count": 850,
  "invalid_count": 100
}

在 Claude 中的使用範例：

「我的檔案驗證任務 job-123 狀態如何？」

get_download_url

取得驗證結果下載連結，可選狀態篩選。

參數：

參數	類型	必需	描述
job_id	string	是	任務 ID
valid	boolean	否	篩選有效郵箱
invalid	boolean	否	篩選無效郵箱
catchall	boolean	否	篩選全捕獲郵箱
role	boolean	否	篩選角色郵箱
disposable	boolean	否	篩選一次性郵箱
unknown	boolean	否	篩選未知狀態

在 Claude 中的使用範例：

「取得 job-123 中僅有效郵箱的下載連結」

create_webhook

建立 Webhook 以接收驗證完成通知。

參數：

參數	類型	必需	描述
url	string	是	Webhook 回呼 URL（HTTPS）
events	string[]	是	事件：file.completed, file.failed

返回：

{
  "id": "webhook-uuid",
  "url": "https://your-server.com/webhook",
  "events": ["file.completed"],
  "secret": "hmac-secret-for-signature",
  "is_active": true
}

注意： secret 僅在建立時返回一次。請妥善保存以用於簽名驗證。

在 Claude 中的使用範例：

「建立一個 Webhook，在檔案驗證完成時通知我」

list_webhooks

列出目前帳戶的所有 Webhook。

參數： 無

返回：

{
  "total": 1,
  "webhooks": [
    {
      "id": "webhook-uuid",
      "url": "https://your-server.com/webhook",
      "events": ["file.completed"],
      "is_active": true
    }
  ]
}

在 Claude 中的使用範例：

「顯示我所有已設定的 Webhook」

delete_webhook

刪除指定的 Webhook。

參數：

參數	類型	必需	描述
webhook_id	string	是	要刪除的 Webhook ID

在 Claude 中的使用範例：

「刪除 ID 為 webhook-123 的 Webhook」

使用範例

基礎驗證

使用者：

驗證 john@google.com

Claude：

我會為您驗證這個郵箱地址。

郵箱驗證結果

欄位值
郵箱 john@google.com
狀態有效
可送達是
一次性否
分數 0.95

這個郵箱看起來是有效且可送達的。

欄位	值
郵箱	john@google.com
狀態	有效
可送達	是
一次性	否
分數	0.95

多個郵箱驗證

使用者：

檢查這些郵箱：john@google.com, test@mailinator.com, support@microsoft.com

Claude：

我會驗證所有三個郵箱地址。

郵箱狀態備註
john@google.com 有效可送達，企業郵箱
test@mailinator.com 無效一次性郵箱，建議拒絕
support@microsoft.com 有效角色郵箱，可能是共享的

建議：

john@google.com - 安全使用

test@mailinator.com - 臨時郵箱，不推薦

support@microsoft.com - 有效但可能是團隊收件匣

郵箱	狀態	備註
john@google.com	有效	可送達，企業郵箱
test@mailinator.com	無效	一次性郵箱，建議拒絕
support@microsoft.com	有效	角色郵箱，可能是共享的

開發者工作流

使用者（在 Claude Code 中）：

驗證我的 .env.example 檔案中的測試郵箱

Claude：

我會讀取檔案並驗證找到的任何郵箱地址。

在 .env.example 中找到 3 個郵箱地址：

TEST_EMAIL=user@example.com

ADMIN_EMAIL=admin@company.com

SUPPORT_EMAIL=help@temp-mail.org

驗證結果：

郵箱狀態
user@example.com 未知（範例網域）
admin@company.com 有效
help@temp-mail.org 無效（一次性）

考慮使用真實郵箱地址進行測試。

郵箱	狀態
user@example.com	未知（範例網域）
admin@company.com	有效
help@temp-mail.org	無效（一次性）

輸出格式

MCP 伺服器返回格式良好的結果：

## 郵箱驗證結果

**郵箱：** test@example.com
**狀態：** VALID
**置信度分數：** 95.0%

### 詳情
| 檢查項 | 結果 |
|-------|--------|
| 可送達 | 是 |
| 格式有效 | 是 |
| 網域有效 | 是 |
| MX 記錄有效 | 是 |
| 一次性 | 否 |
| 角色地址 | 否 |
| 全捕獲 | 否 |
| 免費提供商 | 否 |

**使用積分：** 1

最佳實踐

1. 安全儲存 API Key

永遠不要硬編碼您的 API 金鑰。使用環境變數：

{
  "env": {
    "BV_API_KEY": "${BV_API_KEY}"
  }
}

2. 使用自然語言

MCP 伺服器理解各種表述：

「驗證 user@example.com」
「test@company.com 是有效郵箱嗎？」
「檢查這個郵箱是否可送達：john@test.com」
「你能幫我驗證這些郵箱地址嗎？」

3. 儘可能批次處理

對於多個郵箱，請 Claude 一起驗證以提高效率：

「一次性驗證所有這些郵箱：email1@test.com, email2@test.com, email3@test.com」

故障排除

找不到 MCP 伺服器

如果 Claude 說找不到 BillionVerify 工具：

檢查您的設定檔路徑
確保 JSON 格式有效
完全重新啟動 Claude Desktop
驗證您的 API 金鑰正確

速率限制錯誤

如果您看到速率限制錯誤：

用「我還有多少積分？」檢查剩餘積分
稍等片刻再試
考慮升級您的套餐以取得更高限制

連線問題

如果驗證失敗：

檢查您的網路連線
驗證您的 API 金鑰有效
先嘗試簡單的驗證

常見問題

我的 API 金鑰安全嗎？

是的。API 金鑰儲存在您的本地設定檔中，僅由執行在您機器上的 MCP 伺服器使用。它永遠不會傳送給第三方。

哪些 AI 客戶端支援 MCP？

任何相容 MCP 的客戶端都可以工作，包括 Claude Desktop、Claude Code、Cursor、Zed、Cline 和 Continue。

離線時會發生什麼？

如果無法存取 BillionVerify API，工具會返回錯誤訊息。這不會影響 Claude 的其他功能。

積分如何計算？

每次郵箱驗證使用 1 個積分。批次驗證每個郵箱使用 1 個積分。使用 check_credits 工具檢查您的餘額。

下一步

AI SDK 整合

建構帶有郵箱驗證的自訂 AI 應用

CLI 工具

在終端中使用郵箱驗證

API 參考

完整 API 文件

MCP Server

AI SDK 整合

CLI 工具

API 參考

On this page