Sendsets

Sendsets：AI エージェント向けコールドメール API

Sendsets を使うと、AI エージェントがプログラムからコールドメールを実行できます。エージェント（Claude Code、Codex、Cursor、Gemini CLI、ChatGPT、自作コードなど）は、営業ダッシュボードの代わりに、MCP サーバー、CLI、または REST API を通じてメールボックスを接続し、ウォームアップして、アウトバウンドキャンペーンを作成・開始し、リードを追加し、返信を読んで返答できます。

このリポジトリは、Sendsets の公開されたエージェント向けの拠点です。

内容	場所
リモート MCP サーバー	https://api.sendsetsapi.com/v1/mcp（ストリーミング可能な HTTP、OAuth 2.1 または API キー）
エージェントスキル（SKILL.md）	skills/send-cold-email、skills/sendsets、skills/sendsets-cli
Claude Code プラグインマーケットプレイス	.claude-plugin/marketplace.json
Codex プラグインマーケットプレイス	.agents/plugins/marketplace.json、.codex-plugin/plugin.json
Agent Plugins マニフェスト	plugin.json、mcp.json（agent-plugins.org）
Gemini CLI 拡張機能	gemini-extension.json
MCP Registry マニフェスト	server.json（io.github.AddisonHoff/sendsets）
OpenAPI 3.1 仕様	openapi.json
ドキュメント	docs.sendsetsapi.com

app.sendsetsapi.com で登録してください。メールボックス10個までは無料です。

エージェントができること

MCP サーバーと REST API は、同じサービスレイヤーのツールを公開します。認証情報から参照できる内容は、付与されたスコープによって制限されます。

• キャンペーン：下書きの作成、シーケンス手順の追加と編集、送信元メールボックスの選択、リード・ログ・統計の表示、開始と停止
• リードと連絡先：追加、検索、タグ付け、一括編集、タイムラインと送信済みメールの確認、セグメントの管理
• メールボックス：接続済みメールボックスの一覧表示と確認、上限の調整、ウォームアップの切り替え、トラッキングドメインの設定、ウォームアップ状況の確認
• 受信トレイと返信：スレッドの一覧表示と閲覧、返信の下書き作成と送信、ラベル付け、スヌーズ、予約送信のキャンセル
• 実行：永続性があり、冪等で、事前チェック済みのキャンペーン実行（create_run、get_run、list_runs、cancel_run）
• 抑制リスト、分析、ウェブフック：「連絡不可」リストの管理、ダッシュボード分析の確認、署名付きウェブフックの管理

送信クラスのツール（start_campaign、compose_email、send_reply、自律型のcreate_run）は、認証情報に紐づくポリシーを通じて実行されます。呼び出しの結果は、executed、awaiting_approval（担当者が30分以内にダッシュボードで承認）、またはblockedのいずれかです。承認によって、オプトアウトの欠落、抑制リストへの登録、メールボックスのヘルスチェック不合格が覆されることはありません。

MCP サーバーに接続する

サーバーは OAuth 2.1 保護リソースメタデータ（RFC 9728）を公開し、動的クライアント登録をサポートしているため、OAuth 対応の MCP クライアントでは、貼り付け用のキーなしでブラウザーからサインインできます。ダッシュボードから取得できる静的なssk_ API キーも、Authorization: Bearer ssk_...として使用できます。

Claude Code

claude mcp add --transport http sendsets https://api.sendsetsapi.com/v1/mcp

プラグインをインストールすると、MCP サーバーとスキルをまとめて追加できます。

/plugin marketplace add AddisonHoff/sendsets
/plugin install sendsets@sendsets

Claude（claude.ai と Claude Desktop）：Settings > Connectors > Add custom connector を選択し、URL にhttps://api.sendsetsapi.com/v1/mcpを指定します。

Codex

codex plugin marketplace add AddisonHoff/sendsets     # MCP server + skills as a plugin

または MCP サーバーのみを追加します。

codex mcp add sendsets --url https://api.sendsetsapi.com/v1/mcp
codex mcp login sendsets

Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "sendsets": { "url": "https://api.sendsetsapi.com/v1/mcp" }
  }
}

VS Code（.vscode/mcp.json）

{
  "servers": {
    "sendsets": { "type": "http", "url": "https://api.sendsetsapi.com/v1/mcp" }
  }
}

Gemini CLI

gemini extensions install https://github.com/AddisonHoff/sendsets

静的キーを使う任意のクライアント

{
  "mcpServers": {
    "sendsets": {
      "type": "http",
      "url": "https://api.sendsetsapi.com/v1/mcp",
      "headers": { "Authorization": "Bearer ssk_..." }
    }
  }
}

スキルをインストールする

send-cold-email は、リードリストを受け取り、メールボックスの確認から配信開始、返信への対応まで、フォローアップを含むコールドメールのシーケンスを送信する直接的な方法です。sendsets スキルでは、エージェントが製品を読み取り、製品自体を活用するアウトバウンドワークフローを5つ提案し、選んだものを構築して実行する方法を学びます。sendsets-cli スキルは、ターミナルから Sendsets を操作するための完全なリファレンスです。

npx skills add AddisonHoff/sendsets

または、skills/sendsets を ~/.claude/skills/（Claude Code）または ~/.codex/skills/（Codex）にコピーしてください。同じファイルは https://sendsetsapi.com/skills/sendsets/SKILL.md でも提供されています。また、https://sendsetsapi.com/claude.md は、あらゆるコーディングエージェント向けの、リンク1つで始められるページです。

CLI

brew install addisonhoff/tap/sendsets                 # macOS, Linux
sendsets login --hostname sendsetsapi.com
sendsets doctor --json

Windows の場合は、scoop bucket add sendsets https://github.com/AddisonHoff/homebrew-tap を実行し、続けて scoop install sendsets を実行してください。すべてのプラットフォーム向けのアーカイブと checksums.txt は、sendsets-releases から入手できます。CLI はユーザーとしてサインインし、公開 REST API のみを利用します。すべてのコマンドで --json を指定します。

REST API

ベース URL は https://api.sendsetsapi.com/v1 です。エラーには安定した code と request_id が含まれ、リストでは data とカーソル形式の pagination が使用されます。副作用を伴う書き込みでは Idempotency-Key を指定できます。仕様書：openapi.json。リファレンス：docs.sendsetsapi.com/api。

このプラグインの接続先

• HTTPS 経由の MCP サーバー https://api.sendsetsapi.com/v1/mcp。自身の OAuth サインインまたは API キーで認証します。すべてのツール呼び出しで Sendsets ワークスペース内のデータを読み取るか変更します。送信ツールは、接続済みのメールボックスから実際のメールを送信します。
• スキルでは、AddisonHoff/homebrew-tap から Homebrew または Scoop を使って、あるいは公開済みの checksums.txt と照合したリリースアーカイブから、エージェントに sendsets CLI のインストールを指示する場合があります。CLI は https://api.sendsetsapi.com のみと通信します。
• それ以外には接続しません。このプラグインにはフックもローカルサーバーもなく、インストール時に実行されるスクリプトもありません。また、MCP 設定が環境変数から認証情報を読み取ることもありません。

安全性のデフォルト設定

Sendsets はデフォルトで慎重に動作します。メールボックスごとのキャンペーンメールは1日50通、同じメールボックスからの送信間隔は600秒に制限され、ウォームアップは段階的に行われます。バウンス、苦情、配信停止が発生すると自動的に抑制され、返信があると送信を停止します。テスト送信と実際の配信開始は別々の判断事項です。ユーザーから送信の依頼がない限り、エージェントはキャンペーンを開始してはいけません。

ライセンス

このリポジトリのスキルとマニフェストは、Apache-2.0 ライセンスの下で提供されています。