mailsend

mailsend lets an agent run the sending side of a Resend account: send a message and look it back up, set up a sending domain and start its DNS verification, mint or retire API keys, and keep audiences and their contacts in order. Each operation is one call against the Resend REST API, and the API's JSON answer comes back as-is. It runs from the command line or as an MCP server for agents.

A Resend API key is required. Put it in the RESEND_API_KEY environment variable; the key is sent to the API as a Bearer token and never appears in output. When the variable is missing, every operation fails with an error that names it.

Install

npx @reneturcios/mailsend list-domains

Or run the container image:

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

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

Related MCP server: Resend MCP Server

CLI

export RESEND_API_KEY="your API key"

mailsend send --from "Acme <hello@acme.example>" --to user@example.com \
  --subject "Welcome" --text "Hello there"
mailsend list-emails --limit 10
mailsend list-domains
mailsend list-audiences

mailsend --version

Exit codes: 0 on success, 1 when an API call fails (including a missing RESEND_API_KEY), 2 for usage errors.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

npx -y @reneturcios/mailsend mcp

MCP client configuration:

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

Tools

This is a documented core subset of the Resend platform surface. The hosted Resend MCP also covers broadcasts, templates, webhooks, segments, topics, contact properties, batch sending, and received (inbound) email; those groups are not implemented here.

Development

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

License

MIT — see LICENSE.