BillionVerify

BillionVerify MCP Server — TypeScript

Model Context Protocol を通じて、あらゆる AI アシスタントを BillionVerify のメール検証に接続します。公式 MCP TypeScript SDK を使用して構築されています。

---

オプション 1 — ホスト型サーバー（インストール不要）

BillionVerify のホスト型 MCP サーバーを使用します。インストールも API キーの貼り付けも不要です。BillionVerify アカウントで OAuth を使用してサインインすると、そのアカウントに接続が紐付けられます。

サーバー URL	https://mcp.billionverify.com/mcp
トランスポート	ストリーミング可能な 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 がオンになっていることを確認します。

Team / Enterprise：Owner が 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	1 回のリクエストで最大 50 件のメールアドレスを検証します
get_account_balance	クレジット残高を確認します
get_verification_history	検証履歴を一覧表示します（ページネーション対応）
get_verification_stats	7 日／30 日／90 日／1 年の集計統計を取得します
get_task_status	非同期ファイル検証ジョブのステータスを確認します
get_download_url	ステータスフィルターを指定して、結果のダウンロード URL を取得します
create_webhook	ファイル完了イベントを受信するよう登録します
list_webhooks	設定済みのすべての Webhook を一覧表示します
delete_webhook	Webhook を削除します
health_check	サーバーのヘルス状態を確認します

---

ライセンス

MIT