SendGrid sends email. MultiMail makes agent email accountable.

"cm"># SendGrid — no identity, no oversight
import sendgrid
from sendgrid.helpers.mail import Mail

sg = sendgrid.SendGridAPIClient(api_key=&"cm">#039;SG.xxxx')
message = Mail(
    from_email=&"cm">#039;[email protected]',
    to_emails=&"cm">#039;[email protected]',
    subject=&"cm">#039;Follow-up from your account review',
    plain_text_content=&"cm">#039;Hi, your account review is complete.'
)
sg.client.mail.send.post(request_body=message.get())
"cm"># Delivered immediately, no identity, no approval gate

"cm"># MultiMail — identity signed, gated_send oversight
import requests

response = requests.post(
    &"cm">#039;https://api.multimail.dev/send_email',
    headers={&"cm">#039;Authorization': 'Bearer $MULTIMAIL_API_KEY'},
    json={
        &"cm">#039;mailbox': '[email protected]',
        &"cm">#039;to': '[email protected]',
        &"cm">#039;subject': 'Follow-up from your account review',
        &"cm">#039;body': 'Hi, your account review is complete.',
        &"cm">#039;oversight_mode': 'gated_send'
    }
)
# Returns pending approval item ID — not delivered until human approves
print(response.json())
# {'status': 'pending', 'approval_id': 'apr_01HZ...', 'agent_identity': 'agt_01HZ...'}

import requests

BASE = &"cm">#039;https://api.multimail.dev'
HEADERS = {&"cm">#039;Authorization': 'Bearer $MULTIMAIL_API_KEY'}

"cm"># Fetch all messages awaiting human approval
pending = requests.get(f&"cm">#039;{BASE}/list_pending', headers=HEADERS).json()

for item in pending[&"cm">#039;items']:
    print(f"From: {item[&"cm">#039;mailbox']}")
    print(f"To:   {item[&"cm">#039;to']}")
    print(f"Subj: {item[&"cm">#039;subject']}")
    print(f"Body: {item[&"cm">#039;body_preview']}")
    print(f"Agent: {item[&"cm">#039;agent_identity']['model']} v{item['agent_identity']['version']}")
    print()

    "cm"># Human reviews and approves
    decision = requests.post(
        f&"cm">#039;{BASE}/decide_email',
        headers=HEADERS,
        json={
            &"cm">#039;approval_id': item['approval_id'],
            &"cm">#039;approved': True,
            &"cm">#039;note': 'Reviewed — accurate and on-brand'
        }
    )
    print(f"Decision: {decision.json()[&"cm">#039;status']}")  # 'delivered'

"cm">// In your MCP-connected agent (Claude Desktop, Cursor, Windsurf, etc.)
"cm">// MultiMail exposes these tools natively — no wrapper code required

"cm">// Tool: send_email
"cm">// The MCP server handles auth, identity signing, and oversight routing
const draft = await mcp.call('send_email', {
  mailbox: '[email protected]',
  to: '[email protected]',
  subject: 'Your onboarding checklist is ready',
  body: 'Hi David, your onboarding checklist is ready to review.\n\nStep 1: Connect your domain...',
  "cm">// oversight_mode inherited from mailbox config (gated_send)
});
"cm">// Returns: { status: 'pending', approval_id: 'apr_01HZ...', delivery_eta: null }

"cm">// Tool: list_pending — check what's waiting for approval
const queue = await mcp.call('list_pending', {
  mailbox: '[email protected]',
  limit: 10
});

// Tool: decide_email — approve or reject
const result = await mcp.call('decide_email', {
  approval_id: queue.items[0].approval_id,
  approved: true
});
// result.status === 'delivered'

"cm"># Webhook handler — receives inbound email events
from flask import Flask, request, jsonify
import requests

app = Flask(__name__)
BASE = &"cm">#039;https://api.multimail.dev'
HEADERS = {&"cm">#039;Authorization': 'Bearer $MULTIMAIL_API_KEY'}

@app.route(&"cm">#039;/webhooks/multimail', methods=['POST'])
def handle_inbound():
    event = request.json

    if event[&"cm">#039;type'] == 'email.received':
        email_id = event[&"cm">#039;email_id']

        "cm"># Read full email content
        email = requests.get(
            f&"cm">#039;{BASE}/read_email',
            headers=HEADERS,
            params={&"cm">#039;email_id': email_id}
        ).json()

        "cm"># Get full thread for context
        thread = requests.get(
            f&"cm">#039;{BASE}/get_thread',
            headers=HEADERS,
            params={&"cm">#039;thread_id': email['thread_id']}
        ).json()

        "cm"># Agent processes and composes reply
        "cm"># (your LLM call here, passing thread context)
        reply_body = agent_compose_reply(thread)

        "cm"># Send reply — routes to gated_send approval queue
        requests.post(
            f&"cm">#039;{BASE}/reply_email',
            headers=HEADERS,
            json={
                &"cm">#039;email_id': email_id,
                &"cm">#039;body': reply_body
            }
        )

    return jsonify({&"cm">#039;ok': True})