mailsend

mailsend

mailsend を使うと、エージェントは Resend アカウントの送信機能を操作できます。メッセージの送信と検索、送信ドメインの設定と DNS 検証の開始、API キーの発行と無効化、オーディエンスとその連絡先の管理ができます。各操作は Resend REST API に対する 1 回の呼び出しで実行され、API の JSON 応答がそのまま返されます。コマンドラインから実行することも、エージェント向けの MCP サーバーとして実行することもできます。

Resend API キーが必要です。RESEND_API_KEY 環境変数に設定してください。キーは Bearer トークンとして API に送信され、出力には表示されません。この変数が設定されていない場合、すべての操作は変数名を示すエラーで失敗します。

インストール

npx @reneturcios/mailsend list-domains

または、コンテナイメージを実行します。

docker run -i -e RESEND_API_KEY ghcr.io/cloudcorprecords/mailsend

コンテナはデフォルトで MCP サーバーとして起動します（下記を参照）。CLI として使用するには、CLI 引数を渡してください。

CLI

export RESEND_API_KEY="your API key"

mailsend send --from "Acme <[email protected]>" --to [email protected] \
  --subject "Welcome" --text "Hello there"
mailsend list-emails --limit 10
mailsend list-domains
mailsend list-audiences

mailsend --version

終了コード：成功時は 0、API 呼び出しの失敗時（RESEND_API_KEY の未設定を含む）は 1、使用方法のエラー時は 2 です。

MCP サーバー

1 つのバイナリで両方のモードを提供します。mcp サブコマンドで stdio MCP サーバーが起動します。

npx -y @reneturcios/mailsend mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "mailsend": {
      "command": "npx",
      "args": ["-y", "@reneturcios/mailsend", "mcp"],
      "env": { "RESEND_API_KEY": "your API key" }
    }
  }
}

ツール

ツール	入力	機能
send_email	from、to（配列）、subject（必須）；html、text、cc、bcc、reply_to（任意）	メールを送信します。
list_emails	limit（整数、任意）	送信済みメールを一覧表示します。
get_email	id（必須）	ID を指定して送信済みメールを取得します。
create_domain	name（必須）、region（任意）	送信ドメインを作成します。
list_domains	—	送信ドメインを一覧表示します。
get_domain	id（必須）	DNS レコードを含むドメイン情報を取得します。
verify_domain	id（必須）	ドメインの DNS 検証を開始します。
delete_domain	id（必須）	送信ドメインを削除します。
create_api_key	name（必須）、permission、domain_id（任意）	API キーを作成します。
list_api_keys	—	API キーを一覧表示します。
delete_api_key	id（必須）	API キーを削除します。
create_audience	name（必須）	オーディエンスを作成します。
list_audiences	—	オーディエンスを一覧表示します。
create_contact	audience_id、email（必須）；first_name、last_name、unsubscribed（任意）	オーディエンスに連絡先を追加します。
list_contacts	audience_id（必須）、limit（任意）	オーディエンス内の連絡先を一覧表示します。

これは、Resend プラットフォームの機能のうち、ドキュメント化された中核的なサブセットです。ホスト版 Resend MCP では、ブロードキャスト、テンプレート、ウェブフック、セグメント、トピック、連絡先プロパティ、一括送信、受信メール（インバウンド）にも対応していますが、これらの機能群はここでは実装されていません。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSE を参照してください。