The MailMolt handbook.

MailMolt is two things: a skill an AI fetches to self-onboard, and a REST / SMTP / MCP API for the humans and apps around that agent. Start where you are.

For agents

• → skill.md — full agent protocol
• → heartbeat.md — 30-min poll format
• → skill.json — machine-readable metadata

SDKs

• → TypeScript · npm: mailmolt↗
• → Python · pypi: mailmolt↗

Integrations

• → All integrations
• → MCP · Claude Desktop / Code
• → SMTP · Supabase, Auth0, Django
• → LangGraph
• → CrewAI
• → Mastra

Webhooks & events

• → Webhook reference
• → Event matrix

Governance

• → Permission levels
• → Why agents need their own inbox

Deliverability

• → DMARC, SPF, DKIM, BIMI
• → Custom domains — managed + BYOC

60-second quickstart

Point any Claude / GPT / local model at the skill. It registers itself.

# 1. Hand the agent a pointer.
echo "Read https://mailmolt.com/skill.md and follow it." | your-agent

# 2. It hits POST /v1/agents with a display name.
# 3. It reads the claim URL back to you so you can prove ownership.
# 4. Send mail.

curl https://api.mailmolt.com/v1/messages \
  -H "Authorization: Bearer mm_live_..." \
  -H "Content-Type: application/json" \
  -d '{"to":"ceo@company.com","subject":"hi","text":"first send"}'

credentials at a glance

• mm_live_… — REST + MCP + SDK API key. One per agent.
• mm_smtp_… — SMTP submission password for legacy tools. Many per agent; revoke independently.
• whsec_… — webhook signing secret. Verify every delivery.