email-verifier

Verifox MCP サーバー

Claude やその他の AI アシスタントから Verifox API を利用できる MCP（Model Context Protocol）サーバーです。メールの配信可能性の検証とビジネスメールアドレスの検索を、単件でも一括でも行えます。

クイックスタート（公開済みパッケージ）

Claude Desktop の設定（~/Library/Application Support/Claude/claude_desktop_config.json）または Claude Code の MCP 設定に追加します。インストールは不要です。npx が取得します。

{
  "mcpServers": {
    "verifox": {
      "command": "npx",
      "args": ["-y", "verifox-mcp"],
      "env": {
        "VERIFOX_API_KEY": "foxkey_your_key_here"
      }
    }
  }
}

https://verifox.ai/dashboard/api で無料の API キー（1,000 クレジット）を取得します。Claude Desktop を再起動して、「これらのメールアドレスを検証して」と依頼してください。

ツール

ツール	内容	クレジット
verify_email	メールアドレスを1件検証 — SMTP 配信可能性、キャッチオール、使い捨て、役割、無料、有効性スコア（0～100）	1 / メール
verify_emails	メールアドレスのリストを一括検証 — 送信し、完了を待って、メールアドレスごとに結果を返します	1 / メール
find_email	氏名と会社のドメインからビジネスメールアドレスを1件検索（最適な一致、または not_found）	10 / 検索
find_emails	連絡先のリストからメールアドレスを一括検索（各連絡先の氏名とドメインを指定）	10 / 連絡先
get_credits	アカウントに残っている Fox Credit 残高を確認	無料
get_job	実行時間の長い verify_emails / find_email / find_emails ジョブの結果をポーリング	—

大量のリストの検証と検索は非同期で行われます。一括ツールは約55秒間インラインで待機し、ジョブがそれより長くかかる場合は、get_job で完了まで処理を続けるための jobId を返します。キャッシュ済みの検証にはクレジットがかかりません。

ローカル開発

Bun を使ってソースから直接実行します（ビルド不要）。

cd mcp
bun install

{
  "mcpServers": {
    "verifox": {
      "command": "bun",
      "args": ["run", "/FULL/PATH/TO/Verifox-api/mcp/src/index.ts"],
      "env": {
        "VERIFOX_API_URL": "https://api.verifox.ai",
        "VERIFOX_API_KEY": "foxkey_your_key_here"

```json
{
  "mcpServers": {
    "verifox": {
      "command": "bun",
      "args": ["run", "/FULL/PATH/TO/Verifox-api/mcp/src/index.ts"],
      "env": {
        "VERIFOX_API_URL": "https://api.verifox.ai",
        "VERIFOX_API_KEY": "foxkey_your_key_here"
      }
    }
  }
}

未設定の場合、VERIFOX_API_URL のデフォルト値は https://api.verifox.ai です。ポート8001で動作する API に対してローカル開発する場合は、http://localhost:8001 を設定します。

3. Claude Desktop を再起動する

ツールが Claude のツール一覧に表示されます。

リモート（HTTP）モード

同じサーバーは、ストリーミング可能な HTTP MCP エンドポイントとしても動作します（Smithery、claude.ai コネクター、その他のリモート MCP クライアント向け）。MCP_TRANSPORT=http（または PORT）を設定すると、POST /mcp でリクエストを受け付け、GET /health でヘルスチェックを行います。

MCP_TRANSPORT=http PORT=8080 node dist/index.js
# or: docker build -t verifox-mcp . && docker run -p 8080:8080 verifox-mcp

HTTP モードでは、Verifox API キーはリクエストごとに Authorization: Bearer <foxkey> ヘッダーから読み取られます（x-api-key または ?api_key= も使用できます）。そのため、1つのホストされたエンドポイントを複数のユーザーが利用でき、それぞれのクレジットが使われます。

使用例

Claude Desktop で、次のように依頼してください。

• 「stripe.com のセキュリティ上の問題をスキャンして」
• 「[email protected] が有効なメールアドレスか確認して」
• 「次のメールアドレスをスコアリングして：[email protected]、[email protected]、[email protected]」
• 「stripe.com の Patrick Collison のメールアドレスを検索して」
• 「tesla.com の OSINT を実行して、サブドメインとメールアドレスを見つけて」
• 「turnix.co のメールサーバーをテストして」
• 「google.com の DMARC ポリシーを確認して」

環境変数

変数	デフォルト	説明
VERIFOX_API_URL	https://api.verifox.ai	Verifox API のベース URL
VERIFOX_API_KEY	（空）	ユーザーごとの API キー（foxkey_*）。x-api-key として送信

Verifox ダッシュボード（API Keys）から foxkey_* キーを生成します。このキーで各ツール呼び出しが認証され、Fox Credits が請求されるアカウントが決まります（検証と検索は各1クレジット、スコアリングと DNS スキャンは無料です）。