MCP Server

Model Context Protocol（MCP）はAnthropicによるオープンプロトコルで、AIモデルが外部ツールやデータソースと安全にやり取りできるようにします。BillionVerifyはHTTP Streamable Transportを通じてAIエージェントにエンタープライズグレードのメール検証機能を提供し、統合が非常に簡単です。

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クレジット（自動再試行）
• リアルタイム残高照会

対応クライアント

クイックセットアップ（HTTP Transport - 推奨）

最もシンプルな統合方法 - npmパッケージのインストール不要！

ステップ1: APIキーの取得

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": "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件）。

パラメータ：

戻り値：

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

ファイル検証タスクの進捗を照会します。

パラメータ：

戻り値：

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

オプションのステータスフィルター付きで検証結果のダウンロードリンクを取得します。

パラメータ：

Claudeでの使用例：

"job-123から有効なメールのみのダウンロードリンクを取得して"

create_webhook

検証完了通知を受信するためのWebhookを作成します。

パラメータ：

戻り値：

{
  "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を削除します。

パラメータ：

Claudeでの使用例：

"ID webhook-123 のWebhookを削除して"

使用例

基本検証

ユーザー：

john@google.comを検証して

Claude：

そのメールアドレスを検証します。

メール検証結果

フィールド	値
メール	john@google.com
ステータス	有効
配信可能	はい
使い捨て	いいえ
スコア	0.95

このメールは有効で配信可能なようです。

複数メール検証

ユーザー：

これらのメールをチェックして: john@google.com, test@mailinator.com, support@microsoft.com

Claude：

3つすべてのメールアドレスを検証します。

メール	ステータス	備考
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	不明（exampleドメイン）
admin@company.com	有効
help@temp-mail.org	無効（使い捨て）

テスト用に実際のメールアドレスの使用を検討してください。

出力形式

MCPサーバーは整形された結果を返します：

## メール検証結果

**メール:** test@example.com
**ステータス:** 有効
**信頼度スコア:** 95.0%

### 詳細
| チェック | 結果 |
|---------|------|
| 配信可能 | はい |
| 有効な形式 | はい |
| 有効なドメイン | はい |
| 有効なMX | はい |
| 使い捨て | いいえ |
| ロールアドレス | いいえ |
| キャッチオール | いいえ |
| 無料プロバイダー | いいえ |

**使用クレジット:** 1

ベストプラクティス

1. APIキーを安全に保存

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ツールを見つけられないと言う場合：

1. 設定ファイルのパスを確認
2. JSONが有効であることを確認
3. Claude Desktopを完全に再起動
4. APIキーが正しいことを確認

レート制限エラー

レート制限エラーが表示される場合：

1. "クレジットは何件残ってる？"で残りクレジットを確認
2. 少し待ってから再試行
3. より高い制限のためのプランアップグレードを検討

接続の問題

検証が失敗する場合：

1. インターネット接続を確認
2. APIキーが有効であることを確認
3. まずシンプルな検証を試す

FAQ

APIキーは安全ですか？

はい。APIキーはローカル設定ファイルに保存され、マシンで実行されるMCPサーバーのみが使用します。第三者に送信されることはありません。

どのAIクライアントがMCPに対応していますか？

Claude Desktop、Claude Code、Cursor、Zed、Cline、Continueなど、MCP対応クライアントならどれでも動作します。

オフライン時はどうなりますか？

BillionVerify APIに到達できない場合、ツールはエラーメッセージを返します。これはClaudeの他の機能には影響しません。

クレジットはどう機能しますか？

各メール検証で1クレジットを使用します。一括検証はメールあたり1クレジットです。check_creditsツールで残高を確認できます。

次のステップ