mailsend

mailsend

mailsend 可让 Agent 执行 Resend 账户的发送端操作：发送邮件并查询邮件，设置发送域名并启动其 DNS 验证，创建或停用 API 密钥，以及管理受众和联系人。每项操作都会调用一次 Resend REST API，并原样返回 API 的 JSON 响应。它可通过命令行运行，也可作为供 Agent 使用的 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 调用失败时为 1（包括缺少 RESEND_API_KEY 的情况），用法错误时为 2。

MCP 服务

一个可执行文件提供两种用法。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 还支持广播、模板、webhook、 细分、主题、联系人属性、批量发送和接收（入站） 邮件；此处未实现这些功能组。

开发

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。