isitdisposable-mcp

isitdisposable-mcp

isitdisposable.com のアプリケーションプログラミングインターフェース（API）を使用して、メールアドレスまたはドメインが使い捨てかどうかを AI エージェントが確認できるようにする Model Context Protocol（MCP）サーバーです。

インストール

このサーバーは npm レジストリで公開されており、通常は npx で実行するため、手動でインストールする必要はありません。以下の例では、Model Context Protocol（MCP）ホストに組み込む方法を示します。

Claude Desktop

以下を Claude Desktop の設定に追加します。

{
  "mcpServers": {
    "isitdisposable": {
      "command": "npx",
      "args": ["-y", "isitdisposable-mcp"],
      "env": { "ISITDISPOSABLE_API_KEY": "your_secret_key" }
    }
  }
}

Claude Code

claude mcp add isitdisposable --env ISITDISPOSABLE_API_KEY=your_secret_key -- npx -y isitdisposable-mcp

API キーの取得

isitdisposable.com のキーが必要です。https://isitdisposable.com で無料のキーを取得し（無料プランを利用できます）、上記の設定で ISITDISPOSABLE_API_KEY として設定します。

ツール

ツール	機能
check_email	1 つのメールアドレスを確認し、使い捨てかどうかを判定します。
check_domain	ローカル部分を含まない 1 つのドメインを確認し、使い捨てかどうかを判定します。
check_batch	1 回の呼び出しで最大 100 件のメールアドレスまたはドメインを確認します。items リストには完全なメールアドレスとドメインを自由に混在させることができます。@ 記号を含む項目はメールアドレスとして送信され、それ以外はすべてドメインとして扱われます。

すべてのツールは同じ形式の判定結果を返します。disposable は、使い捨てかどうかを示す基本的な真偽値です。使い捨てアドレスとは、通常の登録要件を回避するために、1 回の登録メッセージを受信する目的で使われる、一時的または使い捨ての受信箱であり、実際に継続して使われるメールボックスではありません。action は、allow、warn、block のいずれかで推奨される処理を示します。さらに、いくつかの任意のシグナルが含まれる場合があります。mx_valid（ドメインのメールサーバーがメールを受け入れるかどうか）、relay（転送型またはキャッチオール形式のアドレスかどうか）、public_domain（Gmail など、広く知られている無料プロバイダーかどうか）、did_you_mean（入力されたドメインが誤字と思われる場合に、意図された可能性の高いドメイン）などです。

フェイルオープン動作

このサーバーは常にフェイルオープンで動作します。ネットワークの問題、タイムアウト、レート制限、またはサーバーエラーによって実際の確認を完了できない場合でも、ツールの呼び出しは成功します（例外が発生したり、接続がクラッシュしたりすることはありません）。短い待機時間の後に 1 回再試行し、それでも失敗した場合は、checked: false、disposable: null、action: "allow" を含む結果を返し、確認を完了できなかった理由を説明する note を添えます。このツールを使うエージェントは、この結果を判断不能として扱うべきであり、アドレスが安全であることを示すシグナルとして扱ってはいけません。

API キーが設定されていない場合でも、サーバーは通常どおり起動し、Model Context Protocol（MCP）のハンドシェイクに応答します。その後、各ツールの呼び出しは、無料のキーを取得するための https://isitdisposable.com を示すエラー結果を返します。