Bounceban

@pipeworx/bounceban

BounceBan のウォーターフォール向けに調整されたエンドポイント（bounceban.com）を使用して、キャッチオール検出を含め、1 件のメールアドレスを検証します。enrich-waterfall の enrich_verify_email 順序付き検証ツールの一部です（フリート #2860）。

Pipeworx の一部です。AI エージェントを 1875 以上の稼働中データソースに接続する MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携関係になく、承認も受けておらず、公開もされていません。

ツール

• bounceban_verify(email, _apiKey) — ステータス／結果、明示的な catch_all、使い捨て・ロール・無料の各フラグを返します。

認証

BYO のみです。BounceBan API キーを _apiKey として渡してください（ヘッダーは Authorization、Bearer プレフィックスは不要です）。キーは https://bounceban.com/app/api/settings で確認できます。プラットフォームキーはありません（D4）。

データソース

• https://api-waterfall.bounceban.com/v1/verify/single — BounceBan のウォーターフォール専用ホストです。タスクを返してポーリングさせるのではなく、確定結果を返すため、同期的に（最大 80 秒）処理するよう構築されています。BounceBan は同じ操作を行う標準の api.bounceban.com ホストも公開しています。このパックでは、enrich_verify_email が必要とする形式に合うため、意図的にウォーターフォール用ホストを使用しています。

検証に関する注記（フリート #2860、2026-10-08、ベンダーキー未保有）

• このパックが呼び出すホスト／パスを正確にエッジプローブしました。 Authorization ヘッダーがない場合、HTTP 401 {"error":"Authorization header is required"} が返されました。無効なキーの場合は、HTTP 401 {"msg":"Authorization information is missing or invalid."} が返されました。異なる 2 つの失敗で異なる本文が返ることから、一律の 401 ではなく、ヘッダーが読み取られていることが確認できます。このパックのコードは、理由を提示する際に error フィールドと msg フィールドの両方を確認します。
• BounceBan は、タイムアウトした検証に対して 408 を返すと説明しています（独自のウォーターフォール統合ガイド）。このパックでは、そのエラーを一般的な HTTP エラー処理に流さず、「サーバー側で検証がタイムアウトしました」という名前付きの独立したエラーとして提示します。再試行するか次の検証ツールに進むかを判断する呼び出し側が、メールアドレスやキーの誤りではなくタイムアウトだったと把握する必要があるためです。
• レスポンスフィールド名（status／result、is_catch_all）は推定です。 BounceBan の一般公開されているノーコード統合ドキュメントと、GitHub の skill-email-verification の説明に基づいており、実際に成功したレスポンスで確認されたものではありません。BounceBan のキーは保有していません。パーサーは is_catch_all／catch_all のいずれかをブール値として受け入れます。どちらのフィールドもない場合は、ステータス文字列に「catch」が含まれているかどうかを確認します。
• 未検証（キー未保有）： BounceBan が主な判定に使用する正確なフィールド名（status と result のどちらか）、および「catch-all」と明白な有効／無効以外のステータス値の全列挙。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "bounceban": {
      "url": "https://gateway.pipeworx.io/bounceban/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/bounceban/mcp の tools/list は、上の表にあるツールに加えて、共有の Pipeworx メタツールである ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツールも返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールに加えて、共有ツールが約 30 個一覧表示されます。接続の initialize 応答には正確なスコープが記載されており、その日の状況を確認するための確実な情報源です。

これは意図的なもので、偶然の多重化ではありません。メタツールを使えば、このパックの対象外の質問にも、カタログ全体から振り分ける ask_pipeworx を通じて回答できます。そのため、2 つ目の MCP サーバーを追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費が、振り分け機能の価値を上回る場合は、複数のパックのエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールを直接一覧表示できます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1875 以上のデータソースに接続します。違いは、どのパックのツールを直接一覧表示するかだけです。どちらからでも ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントをお持ちでない場合：HTTP 経由で呼び出す

このパックでは、ご自身の API キー（_apiKey）が必要です。こちらでは API キーを用意していないため、キーなしで実行できる curl コマンドはありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/bounceban_verify を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も必要ありません。

{
  "mcpServers": {
    "bounceban": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-bounceban"]
    }
  }
}

または、起動を確認するために直接実行します。

npx -y @pipeworx/mcp-bounceban

stdin／stdout 経由で MCP と通信し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールはありません。同じソース、同じツールで、ask_pipeworx による振り分けはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。この機能は、上記のパックのエンドポイントでもフルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Bounceban data" })

ゲートウェイが適切なツールを選び、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT