MailProbe

mailprobe-mcp

MailProbe API の公式 Model Context Protocol サーバーです。AI アシスタントを使って、メールアドレスが存在し、メールを受信できるかどうかを、何も送信せずリアルタイムで確認できます。1 件でも、キャンペーン前にリストをまとめて確認することもできます。検証はフランスの OVHcloud サーバーで実行され、API はアドレスを保存しません。

インストール · ツール · 動作について · 開発

同じ 2 つのツールを利用する方法は 2 つあります。

• MailProbe が https://mailprobe.dev/mcp で運用するリモートサーバー。リモートサーバーに接続し、ヘッダーを送信できるクライアント向けです。インストールは不要です。
• このパッケージのローカルサーバー npx -y mailprobe-mcp。コンピューター上でサーバーを起動するクライアント向けです。

このリポジトリには、Claude Code プラグインと、結果の読み方やリストの確認方法をアシスタントに教えるスキルも含まれています。

インストール

1. mailprobe.dev でアカウントを作成します。無料クレジットが 100 付与されます。追加分については料金をご覧ください。
2. アカウントの Developer から、mp_live_ で始まる API キーを作成します。MailProbe が API キーを表示するのは作成時の 1 回だけです。
3. 2 つのサーバーのうち 1 つを MCP クライアントに追加します。

リモートサーバー

キーは Authorization ヘッダーに設定します。Claude Code の場合：

claude mcp add --transport http mailprobe https://mailprobe.dev/mcp --header "Authorization: Bearer mp_live_..."

Cursor の場合は .cursor/mcp.json に設定します。

{
  "mcpServers": {
    "mailprobe": {
      "url": "https://mailprobe.dev/mcp",
      "headers": { "Authorization": "Bearer mp_live_..." }
    }
  }
}

リモート MCP サーバーに接続し、ヘッダーを送信できるクライアントであれば、ほかのクライアントでも同じように使えます。

ローカルサーバー

キーは MAILPROBE_API_KEY 環境変数に設定します。サーバーを実行するには、Node.js 22 以降が必要です。Claude Desktop や、JSON ファイルで設定するほかのクライアントの場合：

{
  "mcpServers": {
    "mailprobe": {
      "command": "npx",
      "args": ["-y", "mailprobe-mcp"],
      "env": { "MAILPROBE_API_KEY": "mp_live_..." }
    }
  }
}

Claude アプリと ChatGPT アプリがリモートサーバーに接続できるのは、OAuth サインインを介する場合のみですが、MailProbe はまだ対応していません。Claude Desktop では上記のローカルサーバーを使います。それ以外の場合は、Zapier MCP から MailProbe を利用できます。

Claude Code プラグイン

このプラグインは Claude Code をリモートサーバーに接続し、結果の読み方、呼び出しにかかる費用、リストの確認方法をアシスタントに教えるスキルを追加します。

/plugin marketplace add jamalofski/mailprobe-mcp
/plugin install mailprobe@mailprobe

プラグインを有効にすると、Claude Code が API キーを尋ねます。キーは設定ファイルではなく、システムの認証情報ストアに保存されます。後から設定するには、/plugin configure mailprobe@mailprobe を実行するか、/plugin を開き、Installed タブで mailprobe を選択して、Configure options を選びます。同じアドレスで手動追加したリモートサーバーが、プラグインのサーバーより優先されます。

SKILL.md スキルを読み込む別のエージェントでは、上記のサーバーのいずれかを追加し、スキルだけを取得してください。このリポジトリの plugin/skills/mailprobe/SKILL.md にあるほか、Agensi にも掲載されています。

必要なことをそのまま尋ねてください。「[email protected] は存在しますか？」「ニュースレターを送る前に contacts.csv の連絡先アドレスを確認して」「この登録者のうち、使い捨てアドレスなのはどれですか？」などです。

ツール

ツール	機能
verify_emails	1～20 件のアドレスを検証し、指定した順にアドレスごとの結果を返します。結果には status（valid、invalid、risky、unknown のいずれか）、0～100 の score、明確に配信可能ではない判定の reason、disposable、role_based、free_provider、catch_all の各フラグ、入力ミスの可能性が高い場合の did_you_mean が含まれます。
get_credits	API キーのアカウントに残っているクレジットを返します。

結果の各フィールドは API のものと同じです。詳しくはAPI ドキュメントをご覧ください。

動作

• アドレスには何も送信されません。 MailProbe は構文とドメインのメールサーバーを確認した後、メールサーバーにメールボックスが存在するかどうかを問い合わせ、そこで処理を終了します。
• 何も保存されません。 API 経由で検証されたアドレスはメモリ上で処理され、応答が送信されると消去されます。後続のリクエストで結果が再利用されることはありません。
• どちらのサーバーでも同じツールを使えます。 ローカルサーバーには、リモートサーバーの指示とツール定義が一字一句そのまま含まれており、拒否応答も同じように返します。アシスタントと API の間に何も追加せず、アドレスを https://mailprobe.dev/api/v1 に送信して、回答を返します。
• クレジット。 実際に検証したアドレスごとに 1 クレジットを、API と同様にアカウントから差し引きます。同じ呼び出し内で重複したアドレス、正しい形式ではない項目、呼び出しへの応答時点でまだ判定が出ていないアドレス、サーバーが接続を拒否したアドレスは課金されません。get_credits は無料です。
• レート制限。 API キーごとに 1 分あたり 60 回の呼び出しが可能で、20 件のアドレスを含む呼び出しも 1 回として数えます。呼び出しが拒否されると、待機する秒数が返されます。待機時間が 30 秒以下で、かつ呼び出しが時間内に応答できる場合に限り、ローカルサーバーは自動的に待機して最大 2 回再試行します。それ以外の場合は、待機時間がアシスタントに返されます。
• 応答時間。 MCP クライアントは 1 分後にツール呼び出しを打ち切るため、どちらのサーバーでも呼び出しは約 55 秒以内に応答します。その時点でまだ判定が出ていないアドレスは、理由 timeout を付けて unknown として返され、課金されません。再度送信してください。
• 長いリスト。 1 回の呼び出しで扱えるアドレスは 20 件のため、アシスタントはリストを複数回に分けて送信します。数百件を超える場合は、アカウントの一括処理画面が適しています。最大 500 件のアドレスを貼り付けるか、最大 250,000 件を含む CSV または TXT ファイルをアップロードすると、バックグラウンドで検証されます。
• エラー。 拒否応答は、設定するキー、購入するクレジット、待機する時間など、アシスタントが対応できる文として返されます。
• キーがない場合。 ローカルサーバーは起動してツールを一覧表示します。呼び出しを行うと、MAILPROBE_API_KEY の設定方法が説明されます。

ローカルサーバーのすべてのリクエストには User-Agent: mailprobe-mcp/<version> が付与されます。サポートに問い合わせる際は、そのことを伝えてください。API のログで呼び出しを識別するのに役立ちます。

開発

ローカルサーバーに依存関係はありません。Node.js がソースをそのまま実行します。クライアントとは標準入出力で通信し、同じプロセスからプロトコルの両方の世代に対応します。各リクエストにプロトコルバージョンが含まれるリビジョン 2026-07-28 と、initialize ハンドシェイクで始まる以前のリビジョン（2025-11-25 から 2024-11-05 まで）です。

npm test

ローカルポート上の偽 MailProbe API に対してテストを実行します。キーもネットワークも必要ありません。また、パッケージ、プラグイン、スキル、README の内容が一致していることも確認します。

npm run check-tools

このパッケージの指示とツール定義を、キーなしで取得できるリモートサーバーのものと比較します。

プラグイン

plugin/ には Claude Code プラグインが含まれています。マニフェスト、リモートサーバーを参照する .mcp.json、およびスキル plugin/skills/mailprobe/SKILL.md です。.claude-plugin/marketplace.json は、Claude Code がこのリポジトリからプラグインをインストールできるようにするカタログです。どちらも npm パッケージには含まれません。

claude plugin validate . --strict
claude --plugin-dir ./plugin

マニフェストを確認し、インストールせずにフォルダーからプラグインを読み込んでセッションを開始します。プラグインまたはスキルを変更すると、ユーザーがその変更を受け取れるのはバージョンが変わったときです。変更はリリースに含まれます。

リリース

1. package.json と plugin/.claude-plugin/plugin.json のバージョンを設定し、CHANGELOG.md の該当セクションに日付を記入します。
2. npm test と npm run check-tools を実行します。
3. コミットしてから、バージョン名のタグをプッシュします。Publish ワークフローによって、プロベナンスステートメントとともに Trusted Publishing を通じてパッケージが npm に公開されます。
4. スキルを変更した場合は、新しいバージョンとしてAgensi の掲載ページに再度アップロードします。SKILL.md を含む mailprobe/ フォルダーの ZIP をアップロードしてください。このリポジトリから掲載内容が更新されることはありません。

リソース

• MailProbe API ドキュメント
• mailprobe.dev の MCP セットアップ
• Agensi の MailProbe スキル
• Model Context Protocol 仕様

サポート

issueを作成するか、[email protected] までご連絡ください。

ライセンス

MIT です。詳細はLICENSEをご覧ください。