Send the email. Know what happened.

1curl -X POST "https://mailtruss.com/api/v1/emails" \
2  -H "Authorization: Bearer $MAILTRUSS_API_KEY" \
3  -H "Idempotency-Key: welcome-user-4812" \
4  -H "Content-Type: application/json" \
5  -d '{
6    "from": "Acme <hello@mail.acme.dev>",
7    "to": "ana@fabrikam.com",
8    "subject": "Welcome to Acme",
9    "html": "<p>Thanks for signing up.</p>"
10  }'

1import { MailClient } from "mailtruss";
2​
3const mail = new MailClient({ apiKey: process.env.MAILTRUSS_API_KEY! });
4​
5const { id } = await mail.emails.send(
6  {
7    from: "Acme <hello@mail.acme.dev>",
8    to: "ana@fabrikam.com",
9    subject: "Welcome to Acme",
10    html: "<p>Thanks for signing up.</p>",
11  },
12  { idempotencyKey: "welcome-user-4812" }, // retries are safe
13);

1from mailtruss import Mailtruss
2​
3m = Mailtruss()  # reads MAILTRUSS_API_KEY
4​
5m.emails.send(
6    from_="Acme <hello@mail.acme.dev>",
7    to="ana@fabrikam.com",
8    subject="Welcome to Acme",
9    html="<p>Thanks for signing up.</p>",
10    idempotency_key="welcome-user-4812",  # retries are safe
11)

1"use server";
2import { MailClient } from "mailtruss";
3​
4const mail = new MailClient({ apiKey: process.env.MAILTRUSS_API_KEY! });
5​
6export async function sendWelcome(email: string, userId: string) {
7  const { id } = await mail.emails.send(
8    { from: "Acme <hello@mail.acme.dev>", to: email, subject: "Welcome to Acme", html: "<p>Thanks for signing up.</p>" },
9    { idempotencyKey: `welcome-${userId}` },
10  );
11  return id; // look it up later: mail.emails.get(id)
12}

1{
2  "mcpServers": {
3    "mailtruss": {
4      "command": "npx",
5      "args": ["-y", "mailtruss-mcp"],
6      "env": { "MAILTRUSS_API_KEY": "ms_live_…" }
7    }
8  }
9}