warmysender

AI エージェント向け WarmySender

WarmySender は、コールドメール、メールウォームアップ、LinkedIn、Instagram、WhatsApp の 5 つのチャネルに加え、リアルタイムのメール検証と 2 億件以上の B2B リードデータベースを備えたアウトリーチプラットフォームです。このスキルを使うと、エージェント（Claude、ChatGPT、Cursor、Codex、OpenClaw、Hermes Agent、または MCP に対応する任意のエージェント）が、ホスト型 WarmySender MCP サーバーを通じてサービスを操作できるようになります。

エージェントは、アウトリーチ全体を実行できます。コールドメール、LinkedIn、Instagram、WhatsApp のキャンペーンを作成、開始、管理し、メールを検証し、リードを検索して保存し、ウォームアップを調整できます。これらはすべて自然な言葉で指示できます。誰が操作していても、WarmySender のスケジューラーが各アカウントを安全な制限内に保ちます。

---

1. まず接続する

WarmySender は、次の場所にあるホスト型 MCP サーバーです（ストリーミング可能な HTTP）：

https://warmysender.com/mcp

サインインがデフォルトです。 クライアントが自身を登録し、ユーザーはブラウザーで WarmySender にサインインします。貼り付けるキーは不要です。サインインできないクライアントを使う場合、またはユーザーがキーを希望する場合に限り、API キー形式を使用してください。

エージェントに MCP 設定がまったくない場合、ユーザーは次の段落をチャットに貼り付けることができます。

WarmySender に接続してください。https://warmysender.com/mcp にある MCP サーバーで、OAuth サインインを使用します（API キーは不要です）。ストリーミング可能な HTTP MCP サーバーとして追加し、返されたサインインリンクを開いてアクセスを承認したら、https://github.com/fortuneflick/warmysender-claude-plugin（`npx skills add fortuneflick/warmysender-claude-plugin`）から WarmySender スキルをインストールしてください。自分でメッセージを送信してはいけません。WarmySender のスケジューラーが、すべてのメール、LinkedIn、Instagram、WhatsApp の操作を安全な制限内で進めます。

クライアント別の接続コマンド

Claude

サインイン（デフォルト）：

https://warmysender.com/mcp

Claude で「Customize」→「Connectors」を開き、「+」を選択してから「Add custom connector」を選び、このアドレスを貼り付けて「Add」をクリックします。Claude が WarmySender のサインイン画面を開くので、承認すると接続されます。

API キーによる代替方法 — claude_desktop_config.json：

{
  "mcpServers": {
    "warmysender": {
      "command": "npx",
      "args": [
        "-y",
        "@warmysender/mcp",
        "--api-key=ws_YOUR_API_KEY_HERE"
      ]
    }
  }
}

claude_desktop_config.json に貼り付けて、Claude Desktop を再起動します。

ChatGPT

サインイン（デフォルト）：

codex mcp add warmysender --url https://warmysender.com/mcp
codex mcp login warmysender

ChatGPT Plus と、それより上位のすべてのプランには Codex が含まれています。ターミナルで両方の行を実行します。2 行目を実行するとブラウザーが開き、WarmySender にサインインできます。

API キーによる代替方法：

export WARMYSENDER_API_KEY=ws_YOUR_API_KEY_HERE
codex mcp add warmysender --url https://warmysender.com/mcp --bearer-token-env-var WARMYSENDER_API_KEY

ChatGPT Plus と、それより上位のすべてのプランには Codex が含まれています。両方の行を実行し、設定を保持するために export をシェルのプロファイルに追加します。

Claude Code

サインイン（デフォルト）：

claude mcp add --transport http warmysender https://warmysender.com/mcp

ターミナルでこれを一度実行し、Claude Code 内で /mcp と入力する（または claude mcp login warmysender を実行する）と、ブラウザーで WarmySender にサインインできます。

API キーによる代替方法：

claude mcp add --transport http warmysender https://warmysender.com/mcp --header "Authorization: Bearer ws_YOUR_API_KEY_HERE"

ターミナルでこれを一度実行します。

Cursor

サインイン（デフォルト）— .cursor/mcp.json：

{
  "mcpServers": {
    "warmysender": {
      "url": "https://warmysender.com/mcp"
    }
  }
}

「Add to Cursor」ボタンを使うか、プロジェクトのルートにある .cursor/mcp.json に貼り付けます。Cursor から求められたらサインインしてください。

API キーによる代替方法 — .cursor/mcp.json：

{
  "mcpServers": {
    "warmysender": {
      "url": "https://warmysender.com/mcp",
      "headers": {
        "Authorization": "Bearer ws_YOUR_API_KEY_HERE"
      }
    }
  }
}

「Add to Cursor」ボタンを使うか、プロジェクトのルートにある .cursor/mcp.json に貼り付けます。

Codex

サインイン（デフォルト）：

codex mcp add warmysender --url https://warmysender.com/mcp
codex mcp login warmysender

ターミナルで両方の行を実行します。2 行目を実行するとブラウザーが開き、WarmySender にサインインできます。

API キーによる代替方法：

export WARMYSENDER_API_KEY=ws_YOUR_API_KEY_HERE
codex mcp add warmysender --url https://warmysender.com/mcp --bearer-token-env-var WARMYSENDER_API_KEY

両方の行を実行し、設定を保持するために export をシェルのプロファイルに追加します。

OpenClaw

サインイン（デフォルト）：

openclaw mcp add warmysender --url https://warmysender.com/mcp --transport streamable-http --auth oauth
openclaw mcp login warmysender

両方の行を実行します。2 行目を実行すると、ブラウザーに WarmySender のサインイン画面が開きます。サインインが有効な間、OpenClaw は静的ヘッダーを無視するため、キーが保存されることはありません。

API キーによる代替方法：

openclaw mcp set warmysender '{"url":"https://warmysender.com/mcp","headers":{"Authorization":"Bearer ws_YOUR_API_KEY_HERE"}}'

WarmySender を登録するために、これを一度実行します。その後、OpenClaw から WarmySender の 78 個のツールを呼び出せます。

Hermes Agent

サインイン（デフォルト）— ~/.hermes/config.yaml：

mcp_servers:
  warmysender:
    url: "https://warmysender.com/mcp"
    auth: oauth

これを ~/.hermes/config.yaml に追加してから、チャットで /reload-mcp を実行し、プロンプトが表示されたらサインインします。

API キーによる代替方法 — ~/.hermes/config.yaml：

mcp_servers:
  warmysender:
    url: "https://warmysender.com/mcp"
    headers:
      Authorization: "Bearer ws_YOUR_API_KEY_HERE"

これを ~/.hermes/config.yaml に追加してから、チャットで /reload-mcp を実行します。

Muse Code

このクライアントは API キーで接続します — ~/.config/muse/settings.json：

{
  "schema_version": 1,
  "mcp_servers": {
    "warmysender": {
      "transport": "streamable_http",
      "url": "https://warmysender.com/mcp",
      "headers": {
        "Authorization": "Bearer ws_YOUR_API_KEY_HERE"
      }
    }
  }
}

これを ~/.config/muse/settings.json として保存し（フォルダーがまだない場合は作成します）、Muse Code を再起動してください。schema_version の行は残してください。これがないと Muse Code はファイルを拒否します。すでに設定ファイルがある場合は、既存の mcp_servers 内に warmysender ブロックのみを追加してください。

Grok Bot

このクライアントは API キーで接続します：

{
  "name": "warmysender",
  "url": "https://warmysender.com/mcp",
  "headers": {
    "Authorization": "Bearer ws_YOUR_API_KEY_HERE"
  }
}

grok.com/connectors → New Connector → Custom を開き、サーバーアドレスを貼り付けて、キーをベアラートークンとして使用してください。チャットで @ と入力すると、WarmySender を追加できます。

Windsurf

サインイン（デフォルト） — ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "warmysender": {
      "serverUrl": "https://warmysender.com/mcp"
    }
  }
}

~/.codeium/windsurf/mcp_config.json に貼り付け、Windsurf から求められたらサインインしてください。

API キーのフォールバック — ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "warmysender": {
      "serverUrl": "https://warmysender.com/mcp",
      "headers": {
        "Authorization": "Bearer ws_YOUR_API_KEY_HERE"
      }
    }
  }
}

~/.codeium/windsurf/mcp_config.json に貼り付けてください。

Zed

このクライアントは API キーで接続します — settings.json：

{
  "context_servers": {
    "warmysender": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@warmysender/mcp",
          "--api-key=ws_YOUR_API_KEY_HERE"
        ]
      }
    }
  }
}

Zed の settings.json の context_servers の下に追加してください。

API キーのフォールバック

WarmySender アプリの Settings → API Keys からキーを作成してください（キーは ws_ で始まります）。キーには、作業に必要なスコープだけを付与してください。レポート作成には読み取り専用キーで十分です。キーをチャットメッセージ、ログ、コミットするファイルに貼り付けないでください。上記のように、クライアントの設定または環境変数に設定してください。Settings ページからいつでもローテーションできます。

---

2. エージェントの厳守事項（最初に読むこと）

1. 自分でメッセージを送信しないでください。 「送信」ツールはありません。create_* は下書きを作成し、start_*、resume_*、enroll_* は WarmySender のスケジューラーに作業を引き渡すだけです。スケジューラーは、各アカウントの安全な日次、週次、時間ごとの上限と、新しいアカウントの段階的な送信数増加に従って、メール、LinkedIn、Instagram、WhatsApp のすべてのアクションを調整します。
2. 上限を引き上げると約束しないでください。 上限を引き上げたり、段階的な送信数増加を省略したり、チェックを回避したりできるツールはありません。キャンペーンの進行が遅い場合は、送信ペース（list_skipped_actions、get_linkedin_campaign_throttle）を説明し、「もっと強引に再試行」しないでください。
3. アカウントの接続と切断はアプリで行います。 メールボックス、LinkedIn のシート、Instagram アカウント、WhatsApp 番号は、ユーザーが warmysender.com で接続します。何も接続されていない場合は、その旨を伝えて停止してください。
4. 最初に get_workspace_info を呼び出してください。 現在のワークスペース、保持しているスコープ、プランで許可されている内容がわかります。推測しないでください。
5. 書き込む前に読み取ってください。 書き込みを行う前に、list_* / get_* ツールを使って状態（既存のキャンペーン、テンプレート、メールボックス、利用可能枠）を確認してください。
6. start_*、resume_*、enroll_*、pause_*、unenroll_*、delete_*、close_*、cancel_*、remove_* の前に、必ずユーザーに確認してください。 以下のカタログで破壊的とマークされたツールには destructiveHint が付いています。ユーザーに変更内容を示し、承認を待ってください。自分の判断で開始ツールに force: true を渡さないでください。一覧にある問題を報告し、ユーザーが明示的に「それでも開始して」と言った場合にのみ渡してください。
7. コールドメールキャンペーンには、必ず送信時間帯とオプトアウト文を設定してください。 create_campaign で sending_window_start / sending_window_end / schedule_days / timezone を設定し、ワークスペースのフッターが設定済みであることを確認してください（update_workspace_settings：郵送先住所、オプトアウト方式 link または reply、オプトアウト文言）。フッターは自動で追加されるため、配信停止の文を別途手書きしないでください。
8. 支出は発生前に確認できます。 submit_verification_batch の前に get_verification_allowance を確認してください。search_leads は無料ですが、save_leads / export_leads は月次の利用可能枠またはリードクレジットを使用します。使用前に、消費される量を伝えてください。
9. 推測ではなく事実を報告してください。 ツールの結果（件数、ステータス、理由）を引用してください。ツールがエラーを返した場合は、メッセージをそのままユーザーに示して停止してください。繰り返し実行しないでください。

---

3. ツールカタログ（78 個のツール）

78 個のツールはすべてワークスペースに限定されています。ツールが参照できるのは、サインインしているユーザー（またはキー）が所属するワークスペースのみです。「読み取り専用」ツールは変更を加えません。「変更を伴う」ツールは下書き、設定、またはスケジューラーの作業を書き込みます。「破壊的」ツールは何かを停止、削除、またはキャンセルするため、事前に確認してください。

コールドメールと見込み顧客（19 個のツール）

コールドメールキャンペーンの作成、開始、一時停止、再開、見込み顧客の追加、更新、一括インポート、さらに配信停止リストの管理を、すべて自然な言葉で行えます。

ツール	種類	機能
create_campaign	変更を伴う	下書き状態の新しいメールキャンペーンを作成します。
update_campaign	変更を伴う	キャンペーンを部分的に更新します。
start_campaign	変更を伴う	メールキャンペーンを開始します。
pause_campaign	変更を伴う（破壊的 — 事前に確認してください）	実行中のメールキャンペーンを一時停止します。
resume_campaign	変更を伴う	一時停止中のキャンペーンを再開します。
enroll_prospects	変更を伴う	見込み顧客をメールキャンペーンに追加します。
unenroll_prospects	変更を伴う（破壊的 — 事前に確認してください）	特定の見込み顧客に対するキャンペーンを停止します（ソフトキャンセル。監査証跡は保持されます）。
create_prospect	変更を伴う	ワークスペースに見込み顧客を作成（または既存の顧客を再利用）し、必要に応じてリストに追加します。
update_prospect	変更を伴う	見込み顧客のフィールドを部分的に更新します。
bulk_create_prospects	変更を伴う	1 回の呼び出しで最大 500 件の見込み顧客を作成します。
add_to_suppression_list	変更を伴う	メールアドレスまたはドメインを配信停止リストに追加し、ワークスペース内のどのキャンペーンからも今後連絡しないようにします。
list_campaigns	読み取り専用	ワークスペース内のメールキャンペーンを返します。
get_campaign	読み取り専用	1 件のメールキャンペーンの詳細を、ステップ（シーケンスメール）、全体統計、実際にフッターに挿入される配信停止リンクとともに返します。
list_prospects	読み取り専用	カーソルページネーションを使用して、ワークスペース内の見込み顧客を返します。
get_prospect	読み取り専用	1 件の見込み顧客の詳細を、カスタムフィールド、リストへの所属状況、登録履歴の概要とともに返します。
list_suppressions	読み取り専用	ワークスペースの配信停止リスト（連絡対象外のメールアドレスとドメイン）を返します。
list_skipped_actions	読み取り専用	キャンペーンが最近ほとんど、またはまったくメールを送信しなかった理由を説明します。過去 N 時間に実行されなかったアクションを原因別にまとめ、それぞれに自然な言葉での説明と、通常のペース調整により自動的に再開するものか、対応が必要なものかを示すフラグを付けて返します。
list_email_templates	読み取り専用	ワークスペースに保存されているメールテンプレート（名前、カテゴリ、件名、プレビューテキスト）を返します。
get_email_template	読み取り専用	保存されているメールテンプレート 1 件の詳細を、件名、プレビューテキスト、本文とともに返します。

トラッキングドメイン（4 個のツール）

独自のブランドドメインを開封とクリックのトラッキングに使用できます。トラッキングドメインを追加して、正しく設定されているか確認し、登録済みのドメインを一覧表示したり、不要になったドメインを削除したりできます。

ツール	種類	機能
add_tracking_domain	変更を伴う	カスタムの開封・クリックトラッキングドメインを追加します。
verify_tracking_domain	変更を伴う	トラッキングドメインの CNAME レコードが正しく設定されているか確認し、検証済みまたはエラー状態に設定します。
list_tracking_domains	読み取り専用	ワークスペースのカスタム開封・クリックトラッキングドメインを、検証状態（保留中、検証済み、またはエラー）、設定する CNAME のターゲット、最終確認日時、検証日時とともに返します。
remove_tracking_domain	変更を伴う（破壊的 — 事前に確認してください）	ID を指定して、カスタムトラッキングドメインをワークスペースから削除します。

LinkedIn — キャンペーン、投稿、リクルーター（19 個のツール、安全制限付き）

LinkedIn を一貫して運用できます。コネクションやメッセージのキャンペーンを実施し、投稿を公開・管理したり、リクルーターの求人を作成・公開・終了して応募者を確認したりできます。すべてのアクションは、アカウントの安全な日次・週次上限の範囲内で調整されます。

ツール	種類	機能
create_linkedin_campaign	変更あり	LinkedIn の新しいアウトリーチキャンペーンを下書きとして作成します（send_invite、wait_accept、send_message、wait_reply、条件分岐などのステップで構成されるシーケンスです）。
start_linkedin_campaign	変更あり	下書きの LinkedIn キャンペーンを開始するか、一時停止中のキャンペーンを再開して、処理を開始します。
pause_linkedin_campaign	変更あり（破壊的 — 先に確認）	実行中の LinkedIn キャンペーンを一時停止します。
resume_linkedin_campaign	変更あり	一時停止中の LinkedIn キャンペーンを再開します。
enroll_in_linkedin_campaign	変更あり	LinkedIn キャンペーンの見込み客をキューに追加します。
create_linkedin_post	変更あり	LinkedIn の投稿を下書きとして作成するか、後の日時に予約します（安全なペースで自動公開されます）。
publish_linkedin_post	変更あり	以前に下書きまたは予約した LinkedIn の投稿を、安全なペースで今すぐ公開します（1 日あたりの投稿上限を遵守します）。
delete_linkedin_post	変更あり（破壊的 — 先に確認）	下書き、予約済み、または失敗した LinkedIn の投稿を削除します。
create_linkedin_job	変更あり	LinkedIn Recruiter の求人を下書きとして作成します（Recruiter のシートが必要です）。
publish_linkedin_job	変更あり	LinkedIn Recruiter の求人を公開します。
close_linkedin_job	変更あり（破壊的 — 先に確認）	LinkedIn Recruiter の求人を終了し、応募を受け付けないようにします。
list_linkedin_accounts	読み取り専用	接続済みの LinkedIn アカウントについて、ステータス、戦略、安全上限に対する現在の日次・週次利用状況を返します。
get_linkedin_account_health	読み取り専用	承認率、返信率、制限、連続エラー、安全上限の余裕など、LinkedIn アカウントの詳細な健全性指標を返します。
list_linkedin_campaigns	読み取り専用	ステータスと主要なカウンターを含む LinkedIn キャンペーンを返します。
get_linkedin_campaign_stats	読み取り専用	招待の送信・承認数、メッセージの送信・返信数、A/B テストを使用している場合はバリアントのパフォーマンスなど、キャンペーンの詳細な健全性指標を返します。
get_linkedin_campaign_throttle	読み取り専用	LinkedIn キャンペーンが現在送信している、または送信していない理由を説明します。送信を妨げている日次・週次の上限、その上限の更新時刻、同じ LinkedIn アカウントを共有するキャンペーンの数、アクションの種類ごとに、このキャンペーンに割り当てられたアカウント上限の割合と今日の使用量を確認できます。
list_linkedin_posts	読み取り専用	ワークスペースの LinkedIn 投稿（下書き、予約済み、公開済み、失敗）について、ステータス、コンテンツ、予約日時、解決済み URL、エンゲージメント数を返します。
list_linkedin_jobs	読み取り専用	接続済みアカウントの LinkedIn Recruiter 求人を一覧表示します（アカウント保護のため、ライブデータへのアクセスはレート制限されています）。
list_linkedin_job_applicants	読み取り専用	接続済みアカウントの LinkedIn Recruiter 求人への応募者を一覧表示します（アカウント保護のため、ライブデータへのアクセスはレート制限されています）。

WhatsApp メッセージ（9 個のツール、安全性ゲート付き）

WhatsApp キャンペーンを作成して開始し、見込み客を登録し、電話番号の健全性と結果を確認します。新しい電話番号は徐々に利用量を増やし、安全な 1 日あたり、初回メッセージ、1 時間あたりの上限内で運用されます。また、メッセージの間には自然な間隔が設けられます。

ツール	種類	説明
create_whatsapp_campaign	mutating	下書き状態の WhatsApp アウトリーチキャンペーンを作成します。
start_whatsapp_campaign	mutating	WhatsApp キャンペーンを開始します。
pause_whatsapp_campaign	mutating (破壊的な操作 — 事前に確認)	実行中の WhatsApp キャンペーンを一時停止します。
resume_whatsapp_campaign	mutating	一時停止中の WhatsApp キャンペーンを再開します。
enroll_in_whatsapp_campaign	mutating	WhatsApp キャンペーンに見込み客を登録します。
list_whatsapp_accounts	read-only	接続済みの WhatsApp 電話番号について、ステータス、段階的な利用状況、安全上限に対する現在の 1 日あたり・新規チャット・1 時間あたりの使用量を返します。
get_whatsapp_account_health	read-only	WhatsApp 電話番号の詳細な健全性情報を返します。これには、過去 30 日間の返信率、制限、連続エラー数、スロットル状態、安全上限に対する 1 日あたり・新規チャット・1 時間あたりの残り余裕が含まれます。
list_whatsapp_campaigns	read-only	WhatsApp キャンペーンのステータスと主なカウンター（登録数、送信済みメッセージ数、返信数）を返します。
get_whatsapp_campaign_stats	read-only	キャンペーンのすべての指標を返します。これには、新規チャット開始数、送信済みメッセージ数、受信した返信数、返信率、A/B テストを使用している場合はバリアントごとのパフォーマンスが含まれます。

Instagram DM（9 個のツール、安全性ゲート付き）

Instagram DM キャンペーンを作成して開始し、見込み客を登録し、アカウントの健全性と結果を確認します。新しいアカウントは徐々に利用量を増やし、安全な 1 日あたり・1 時間あたりのアクション上限内で運用されます。

ツール	種類	説明
create_instagram_campaign	mutating	下書き状態の Instagram DM／アウトリーチキャンペーンを作成します。
start_instagram_campaign	mutating	Instagram キャンペーンを開始します。
pause_instagram_campaign	mutating (破壊的な操作 — 事前に確認)	実行中の Instagram キャンペーンを一時停止します。
resume_instagram_campaign	mutating	一時停止中の Instagram キャンペーンを再開します。
enroll_in_instagram_campaign	mutating	Instagram キャンペーンに見込み客を登録します。
list_instagram_accounts	read-only	接続済みの Instagram アカウントについて、ステータス、段階的な利用状況、複合的な安全上限に対する現在の 1 日あたり・1 時間あたりの使用量を返します。
get_instagram_account_health	read-only	Instagram アカウントの詳細な健全性情報を返します。これには、過去 30 日間の返信率、制限、連続エラー数、複合的な安全上限に対する 1 日あたり・1 時間あたりのアクションの残り余裕が含まれます。
list_instagram_campaigns	read-only	Instagram キャンペーンのステータスと主なカウンター（登録数、フォロー数、送信済み DM 数、返信数）を返します。
get_instagram_campaign_stats	read-only	キャンペーンのすべての指標を返します。これには、実施したフォロー数、送信済み DM 数、受信した返信数、返信率、A/B テストを使用している場合はバリアントごとのパフォーマンスが含まれます。

ウォームアップとメールボックス（5 個のツール）

ウォームアップ設定を調整し、複数のメールボックスをまとめて更新し、送信規模を拡大する前にメールボックスの健全性とウォームアップの進行状況を確認します。

ツール	種類	説明
update_warmup_settings	mutating	1 つのメールボックスのウォームアップ設定（有効化／無効化、1 日あたりの目標送信量、戦略の種類）を変更します。
bulk_update_warmup	mutating	同じウォームアップ設定を複数のメールボックスにまとめて適用します。
list_mailboxes	read-only	接続済みのすべてのメールボックスについて、ステータス、ウォームアップ状態、主な健全性情報を返します。
get_mailbox_health	read-only	最近発生した問題など、1 つのメールボックスの詳細な健全性と到達性のステータスを返します。
get_warmup_stats	read-only	メールのウォームアップ統計情報を返します。

メール認証（7 個のツール）

1 件のメールアドレスを認証することも、リスト全体を送信することもできます。使用前に残りの利用枠を確認し、処理結果を随時確認し、実行を停止して未使用のクレジットを払い戻し、利用可能な結果をすぐに使えるリストに変換できます。結果には、確認済みのメールボックスと、すべてのアドレスを受け付けるメールサーバー上にあるアドレスが含まれるため、エージェントは実際に利用できるアドレスを把握できます。アプリ内の認証機能と同じ安全な速度制限および利用枠が適用されるため、エージェントが一度に大量の処理を行うことはできません。

ツール	種類	機能
verify_email	状態を変更する	1 件のメールアドレスを認証し、有効、無効、リスクあり、不明のいずれであるかを返します。
submit_verification_batch	状態を変更する	最大 5,000 件のメールアドレスを認証のために送信し、get_verification_result でポーリングするための実行 ID を返します。
get_verification_result	読み取り専用	認証実行の進行状況とアドレスごとの結果を返します。必要に応じて、結果を 1 種類に絞り込めます。
list_verification_batches	読み取り専用	このワークスペースのメール認証実行を、新しい順にステータスと結果件数とともに一覧表示します。
get_verification_allowance	読み取り専用	現在認証できるメールアドレスの件数を返します。利用枠の種類（プランの利用枠、購入済みクレジット、または 1 日 1 回の無料チェック）、今月と本日のプラン利用枠の残り、クレジット残高、本日の無料チェックの残り回数、受け付け可能な 1 回のバッチの最大件数も確認できます。
cancel_verification_batch	状態を変更する（破壊的操作 — 事前に確認してください）	進行中の認証実行を停止し、未使用のクレジットを払い戻します。
create_list_from_verification	状態を変更する	完了した認証実行から、再利用可能な見込み客リストを作成します。

リードデータベース（3 個のツール）

役職、業界、所在地を指定して 2 億件以上の B2B リードを検索し、必要なリードを見込み客リストに保存するか、連絡先の詳細をすべて含めてエクスポートできます。検索は無料です。新しいリードを追加するたびに、毎月の利用枠または購入可能なリードクレジットが消費されます。

ツール	種類	機能
search_leads	読み取り専用	キーワード、所在地（郵便番号／ZIP コードのプレフィックスや住所を含む）、業界、役職、職位、部門、データの有無によるフィルターを指定して、2 億件以上の B2B リードを検索します。
save_leads	状態を変更する	データベースのリードを見込み客リストに保存します。new_list_name を指定すると、新しいリストを作成します。
export_leads	状態を変更する	データベースのリードを、マスクされていない連絡先の詳細（メールアドレス、電話番号など）をすべて含む行としてエクスポートします。

ワークスペースとジョブ（3 個のツール）

API キーでアクセスできる内容を確認し、コールドメールのフッターに記載する郵送先住所、オプトアウトの形式、オプトアウトの文言を設定し、キューに入れたジョブや一括操作のステータスを追跡できます。

ツール	種類	機能
get_workspace_info	読み取り専用	この API キーが紐付けられているワークスペースの基本情報、キーに付与されたスコープ、アカウントの請求状況、MCP サーバーのバージョンを返します。
update_workspace_settings	状態を変更する	コールドメールのフッターに記載する郵送先住所を設定し、オプトアウトの方法を選択して、オプトアウトの文言を指定します。
get_job_status	読み取り専用	長時間実行されるリクエスト（たとえば、一括ウォームアップ更新やメールボックス接続テスト）の進行状況を確認します。

---

4. ワークフローとプロンプトの例

リストを使ったコールドメールキャンペーン

「『Agencies EU』リスト向けに、『Q4 agencies』という3ステップのコールドメールキャンペーンを作成してください。月曜〜金曜の9〜17時（Europe/Berlin）に、メールボックスごとに1日40通送信し、返信があったら停止します。ステップ1には『Intro v2』テンプレートを使ってください。開始前に下書きを見せてください。」

1. get_workspace_info → list_mailboxes（ウォームアップ済みで健全なメールボックスを選択）→ list_prospects / リスト ID → list_email_templates → get_email_template。
2. ステップ、timezone、sending_window_start/end、schedule_days、max_sends_per_mailbox_per_day、stop_on_reply、mailbox_ids を指定して create_campaign を実行します。
3. ユーザーが住所／オプトアウトの形式を設定していない場合は、update_workspace_settings でフッターを確認します。
4. enroll_prospects（リスト ID）→ 概要を表示 → 確認を求める → start_campaign。
5. 後で、統計情報には get_campaign を使います。送信数が少ない理由をユーザーが尋ねた場合は、list_skipped_actions を使います。

ウォームアップの調整

「まだウォームアップ中のメールボックスはどれですか？14日目を過ぎたすべての Google メールボックスについて、1日のウォームアップメール数を40通、返信率を30％に設定してください。」

list_mailboxes → get_warmup_stats / get_mailbox_health → bulk_update_warmup（ジョブ ID を返します）→ get_job_status。ウォームアップは自動で継続されるため、調整だけを行います。

LinkedIn キャンペーン

「LinkedIn キャンペーンを作成してください。短いメッセージを添えて招待を送り、承認されたら、2行のメッセージを送ります。メインアカウントで『SaaS founders』リストを登録して、キャンペーンを開始してください。」

list_linkedin_accounts → get_linkedin_account_health → create_linkedin_campaign（send_invite → wait_accept → send_message などのステップ）→ enroll_in_linkedin_campaign → 確認を求める → start_linkedin_campaign。進行が遅い場合は、get_linkedin_campaign_throttle で、どの上限が適用されているか、いつ解除されるかを確認できます。

Instagram DM キャンペーン

「@ourbrand から『Fitness creators』リストに向けて、24時間間隔で2通送るシーケンスの Instagram DM キャンペーンを開始してください。」

list_instagram_accounts → get_instagram_account_health → create_instagram_campaign → enroll_in_instagram_campaign → 確認を求める → start_instagram_campaign。新しいアカウントは徐々にウォームアップされます。送信数を約束するのではなく、ウォームアップの段階を伝えてください。

WhatsApp キャンペーン

「『Webinar sign-ups』リスト向けに、+44 の番号から WhatsApp キャンペーンを作成してください。今日1通送り、返信がなければ3日後にフォローアップを送ります。」

list_whatsapp_accounts → get_whatsapp_account_health → create_whatsapp_campaign → enroll_in_whatsapp_campaign → 確認を求める → start_whatsapp_campaign。新しい連絡先への最初のメッセージには独自の日次上限があります。ユーザーがそれ以上の送信を想定している場合は説明してください。

リストを検証する

「『Trade show 2026』リストを検証して、配信可能なアドレスだけをまとめたクリーンなリストを作成してください。」

get_verification_allowance → 費用をユーザーに伝える → submit_verification_batch（list_id）→ 完了するまで get_verification_result → create_list_from_verification。ユーザーが考えを変えた場合は cancel_verification_batch を使います。未使用のクレジットは返却されます。

2億件以上のリードを検索して保存する

「テキサス州のソフトウェア企業でマーケティングディレクターを検索して、まず25件を表示し、その後、最適な100件を『TX marketing』という新しいリストに保存してください。」

search_leads（無料、マスキングされた検索結果）→ 結果を提示 → 利用枠／クレジットの使用を確認 → new_list_name を指定して save_leads を実行するか、全項目の行を取得する場合は export_leads を実行します。その後、上記の手順でリストをキャンペーンに登録します。

---

5. トラブルシューティング

• サインインが繰り返される／エージェントが何度もサインインを求める — https://warmysender.com/documentation/connecting-an-ai-agent-that-asks-you-to-sign-in に従ってください（エージェントが開いたものと同じプロファイルでブラウザーのサインインを完了します。トークンが取り消されている場合は、サーバーを削除して再追加してください）。
• 「insufficient scope」 — キーにツールが必要とするスコープがありません。Settings → API Keys で適切なスコープを指定して新しいキーを作成し、再接続してください。get_workspace_info でキーが持つスコープを確認できます。
• 「plan upgrade required」／機能を利用できない — ワークスペースのプランに、そのチャネルまたはエージェントの処理能力が含まれていません。制限されている機能をユーザーに伝え、https://warmysender.com/pricing を案内してください。再試行しないでください。
• キャンペーンは開始したが、何も送信されない — 通常は送信ペースが原因です。list_skipped_actions（メール）または get_linkedin_campaign_throttle（LinkedIn）を確認し、理由を報告してください。「きっかけ」を作るために一時停止／再開しないでください。
• メールボックス／アカウントが接続されていない — アカウントの接続はアプリで行います。エージェントからは接続できません。ユーザーに warmysender.com を案内してください。

---

6. リンク

• サーバーとセットアップのドキュメント：https://warmysender.com/mcp
• エージェントでできること：https://warmysender.com/ai-agents
• エージェントの接続方法：https://warmysender.com/documentation/connect-your-ai-agent
• 料金：https://warmysender.com/pricing
• スキルとプラグインのソース：https://github.com/fortuneflick/warmysender-claude-plugin