# Molted Email Docs

> Documentation for Molted Email, the mailbox agents send and receive through: API, CLI, MCP server, policy, journeys and inbound mail.

Every page is also available as Markdown: append `.md` to its URL (https://molted.email/docs/quickstart.md), or request the page with `Accept: text/markdown`. The whole documentation in one file: https://molted.email/docs/llms-full.txt.

## Getting Started

- [Developer Docs](https://molted.email/docs/index.md): API reference and guides for Molted Email - send policy-checked email, handle inbound replies, coordinate agents, and track business outcomes.
- [Why Molted](https://molted.email/docs/why-molted.md): How Molted's policy engine protects your agent from sending the wrong email - and why prompt-level guardrails are not enough.
- [Quickstart](https://molted.email/docs/quickstart.md): Create a Molted Email account, choose a plan, and send your first policy-checked email in under five minutes.
- [CLI Quickstart](https://molted.email/docs/cli-quickstart.md): Install the Molted CLI, authenticate your agent, and send your first policy-checked email from the terminal in under two minutes.
- [Authentication](https://molted.email/docs/authentication.md): Session auth for the portal UI and Bearer API keys for the sending API.
- [Managing API keys programmatically](https://molted.email/docs/api-keys.md): Mint, scope, list, rotate, and revoke API keys over the REST API -- for apps that provision keys for their own agents, workers, or customers.
- [Supervising your agents](https://molted.email/docs/portal.md): What a person sees and clicks in the Molted portal - the Needs you stack, decision links, bulk send review, the email viewer, keyboard shortcuts, Activity, and Settings.
- [Undo what an agent changed](https://molted.email/docs/undo-agent-changes.md): Stop an agent key and put back every settings change it made since a time. A person's action, from Settings > Access.
- [Adoption & Device Flow](https://molted.email/docs/adoption.md): Add agents or CLI users to an existing tenant via invite tokens or the device authorization flow.
- [MCP Server](https://molted.email/docs/mcp-server.md): Connect Claude Code, Cursor, VS Code, Windsurf, or any MCP client to Molted Email through the hosted MCP endpoint at mcp.molted.email, authenticated with your API key.
- [Migrating from Resend, Postmark, or SES](https://molted.email/docs/migration-guide.md): Switch your AI agent's email sending from Resend, Postmark, or Amazon SES to Molted. Step-by-step migration with side-by-side code examples.

## Sending

- [Sending Email](https://molted.email/docs/sending-email.md): Send email with policy enforcement, autonomy-level gating, and delivery tracking.
- [Outbound](https://molted.email/docs/outbound.md): Send and reply to email from a specific mailbox using the mailbox-scoped outbound API.
- [Templates](https://molted.email/docs/templates.md): Create, version, and publish email templates with approval workflows and lint checks.
- [Batch Operations](https://molted.email/docs/batch-operations.md): Send, simulate, classify, and get recommendations for up to 500 recipients in a single request.
- [Humanizer](https://molted.email/docs/humanizer.md): LLM-powered email rewriting that gives your automated emails a natural, human tone.
- [Autonomy Levels](https://molted.email/docs/autonomy-levels.md): Control how much human oversight is required before outbound emails are sent from each mailbox.
- [Approval Queues](https://molted.email/docs/approval-queues.md): Review, approve, reject, edit, and escalate held messages using the override queue API.
- [Pause and Resume Sending](https://molted.email/docs/account-pause.md): Stop all outgoing email for the whole workspace from the portal, the phone app, the API or the CLI, and how a pause is lifted.
- [Policy Simulation](https://molted.email/docs/policy-simulation.md): Dry-run sends against the policy engine without actually sending email.
- [Tracking Delivery](https://molted.email/docs/tracking-delivery.md): Delivery statuses, delivery events, and how to monitor email delivery from the CLI, API, MCP and portal.

## Receiving

- [Mailboxes](https://molted.email/docs/mailboxes.md): Create, manage, and delete mailboxes for receiving inbound email, with plan-based limits.
- [Inbound Email](https://molted.email/docs/inbound.md): Receive and classify inbound email with platform labels, routing actions, and safety flags.
- [Safety Settings](https://molted.email/docs/safety-settings.md): Configure tenant-wide guardrails for inbound threat classification and sending behavior.
- [Threads](https://molted.email/docs/threads.md): Manage email conversations - list, read, reply, schedule follow-ups, archive, trash, and permanently delete threads.
- [Mailbox Rules](https://molted.email/docs/rules.md): Label or archive new inbound conversations automatically, based on sender or subject.
- [Labels](https://molted.email/docs/labels.md): Your own categories for conversations, per mailbox. Define them, apply them to threads, filter by them, and react to them.

## Contacts & Compliance

- [Email Capture](https://molted.email/docs/email-capture.md): One-call contact collection with list subscription and optional confirmation email.
- [Contacts & Accounts](https://molted.email/docs/contacts.md): Sync contacts, manage accounts, and maintain your contact data through the API.
- [Suppressions & Consent](https://molted.email/docs/suppressions.md): Manage suppression lists, record consent, and enforce compliance across scopes.
- [GDPR & Privacy Compliance](https://molted.email/docs/privacy.md): Export tenant data, delete contacts or message content, and view the decision trace for all data operations.

## Automation

- [Journeys](https://molted.email/docs/journeys.md): Build multi-step email sequences with delays, branching, and event-triggered execution.
- [Segmentation](https://molted.email/docs/segmentation.md): Create dynamic contact segments with filter groups, nested logic, and async computation.
- [Email Lists](https://molted.email/docs/lists.md): Create subscriber lists for newsletters, announcements, and marketing broadcasts.
- [Experimentation](https://molted.email/docs/experimentation.md): Run A/B tests and holdout experiments with weighted variants and statistical significance.

## Analytics

- [Analytics](https://molted.email/docs/analytics.md): Contact fatigue scores, send velocity, deliverability rates, segment membership, and outcome attribution.

## Agents

- [Agent Coordination](https://molted.email/docs/agents.md): Register agents, acquire contact leases, and run consensus votes for multi-agent coordination.
- [Use Molted with Hermes Agent](https://molted.email/docs/hermes-agent.md): Connect Hermes Agent (Nous Research, open source) to Molted's hosted MCP server so the agent gets its own mailbox instead of the owner's.
- [Event Streaming](https://molted.email/docs/events.md): Subscribe to real-time events via SSE with filtering and replay support, from the API or with molted listen.
- [Building a Reactive Agent](https://molted.email/docs/reactive-agent-guide.md): Use molted listen to build agents that respond to inbound email, bounces, and delivery events in real-time.
- [LangChain Integration Guide](https://molted.email/docs/langchain-integration-guide.md): Add a governed email mailbox to your LangChain agents. Send, receive, and track email with built-in policy enforcement.
- [CrewAI Integration Guide](https://molted.email/docs/crewai-integration-guide.md): Give your CrewAI agents a governed email mailbox. Send, receive, and track email with built-in policy enforcement.
- [AutoGen Integration Guide](https://molted.email/docs/autogen-integration-guide.md): Add a governed email mailbox to your AutoGen agents and multi-agent conversations. Send, receive, and track email with built-in policy enforcement.
- [Human-in-the-Loop Email Approvals](https://molted.email/docs/human-in-the-loop-guide.md): Keep humans in the loop for sensitive or high-stakes email sends. Use autonomy levels and the approval queue to build review workflows around your agent.
- [OpenAI Agents SDK Integration Guide](https://molted.email/docs/openai-agents-integration-guide.md): Add a governed email mailbox to your OpenAI Agents SDK agents. Send, receive, and track email with built-in policy enforcement.
- [Pydantic AI Integration Guide](https://molted.email/docs/pydantic-ai-integration-guide.md): Add a governed email mailbox to your Pydantic AI agents. Send, receive, and track email with built-in policy enforcement and type-safe tool definitions.
- [Google ADK Integration Guide](https://molted.email/docs/google-adk-integration-guide.md): Add a governed email mailbox to your Google ADK agents. Send, receive, and track email with built-in policy enforcement in Python or TypeScript.
- [Semantic Kernel Integration Guide](https://molted.email/docs/semantic-kernel-integration-guide.md): Add a governed email mailbox to your Semantic Kernel agents. Send, receive, and track email with built-in policy enforcement in C# or Python.
- [LlamaIndex Integration Guide](https://molted.email/docs/llamaindex-integration-guide.md): Add a governed email mailbox to your LlamaIndex agents. Send, receive, and track email with built-in policy enforcement.

## Platform

- [Webhooks](https://molted.email/docs/webhooks.md): Receive real-time notifications when events occur in your Molted Email account.
- [Inbound Webhook Mappings](https://molted.email/docs/inbound-hooks.md): Connect external services like Clerk, Stripe, and Supabase to Molted Email without writing code.
- [Sending Domains](https://molted.email/docs/domains.md): Add and verify sending domains with DKIM, SPF, and DMARC records.
- [DMARC Reports](https://molted.email/docs/dmarc.md): Route DMARC aggregate reports to Molted, then view and summarize authentication health per domain.
- [Sender Addresses & Domain Rate Limits](https://molted.email/docs/sender-addresses.md): Manage the local part of your fallback sending address and configure per-sending-domain rate limits.
- [Workspace Settings](https://molted.email/docs/workspace-settings.md): The workspace-wide sending settings (cooldown, postal address, marketing consent), who may change them, how a change is recorded and undone, and how to rename the workspace.
- [Alert Destinations](https://molted.email/docs/alerts.md): Configure webhook and Slack destinations to receive alerts when queue, send-failure, policy-block, bounce, complaint or SLA conditions fire.
- [Storage & Attachments](https://molted.email/docs/storage.md): How storage is tracked, attachment handling, plan limits, and retention windows.
- [Billing & Plans](https://molted.email/docs/billing.md): Plans, email limits, free tier, upgrading via Stripe, and managing your subscription.
- [Rate Limits](https://molted.email/docs/rate-limits.md): Monthly, daily, and hourly send limits and how to check your current usage.
- [Send Diagnostics](https://molted.email/docs/send-diagnostics.md): Read-only operator endpoints for diagnosing why a tenant's outgoing email is not sending, and what state an account is in.
- [Errors & Policy Blocks](https://molted.email/docs/errors.md): Every policy block reason and suppression reason explained.

## CLI Reference

- [CLI Reference](https://molted.email/docs/cli.md): Every molted command, generated from the CLI itself: arguments, options and the agent context each command prints with --help.
- [molted adopt](https://molted.email/docs/cli/adopt.md): Agent adoption flows (invite & device)
- [molted agents](https://molted.email/docs/cli/agents.md): Multi-agent coordination
- [molted alerts](https://molted.email/docs/cli/alerts.md): Manage alert destinations
- [molted analytics](https://molted.email/docs/cli/analytics.md): Sending analytics and contact insights
- [molted approvals](https://molted.email/docs/cli/approvals.md): List send approvals and withdraw your own pending send
- [molted attachments](https://molted.email/docs/cli/attachments.md): Manage email attachments
- [molted auth](https://molted.email/docs/cli/auth.md): Authentication commands
- [molted billing](https://molted.email/docs/cli/billing.md): Billing and plan management
- [molted budget](https://molted.email/docs/cli/budget.md): Check remaining send quota across monthly, daily and hourly windows
- [molted capture](https://molted.email/docs/cli/capture.md): Capture an email address - upsert contact, subscribe to list, and optionally send confirmation
- [molted classify](https://molted.email/docs/cli/classify.md): Classify an inbound email the way the inbound pipeline would (platform label, safety verdict, route)
- [molted consent](https://molted.email/docs/cli/consent.md): Manage recipient consent records
- [molted contacts](https://molted.email/docs/cli/contacts.md): Manage contacts
- [molted doctor](https://molted.email/docs/cli/doctor.md): Can this key send yet, and why isn't mail flowing? Renders GET /v1/agent/setup plus the after-send checks. Exit code: 1 if any blocker is found (not ready to send); otherwise 2 if any check could not be fully verified; otherwise 0 -- 0 means ready to send and every check fully verified, safe to gate a script on.
- [molted domains](https://molted.email/docs/cli/domains.md): Manage sending domains
- [molted events](https://molted.email/docs/cli/events.md): View message event timelines
- [molted experiments](https://molted.email/docs/cli/experiments.md): Run A/B or holdout experiments on journey steps
- [molted humanizer](https://molted.email/docs/cli/humanizer.md): Manage email humanizer configuration
- [molted inbound-hooks](https://molted.email/docs/cli/inbound-hooks.md): Manage inbound webhook mappings for zero-code integrations
- [molted incidents](https://molted.email/docs/cli/incidents.md): List and acknowledge/resolve ops incidents
- [molted journeys](https://molted.email/docs/cli/journeys.md): Manage journey orchestration
- [molted labels](https://molted.email/docs/cli/labels.md): Define labels and apply them to threads (your own business categories, per mailbox)
- [molted listen](https://molted.email/docs/cli/listen.md): Connect to the SSE event stream — persistent event loop for agents
- [molted lists](https://molted.email/docs/cli/lists.md): Manage email lists and send broadcasts
- [molted mailboxes](https://molted.email/docs/cli/mailboxes.md): Manage mailboxes
- [molted messages](https://molted.email/docs/cli/messages.md): Retrieve message data
- [molted next-action](https://molted.email/docs/cli/next-action.md): Get the next best action for a contact
- [molted outcomes](https://molted.email/docs/cli/outcomes.md): Track and query outcomes
- [molted overrides](https://molted.email/docs/cli/overrides.md): Human-in-the-loop overrides
- [molted pause](https://molted.email/docs/cli/pause.md): Pause your entire account (blocks all sends across every mailbox)
- [molted record-inbound](https://molted.email/docs/cli/record-inbound.md): Record an inbound email
- [molted resume](https://molted.email/docs/cli/resume.md): Resume a paused account (usually a human decision)
- [molted rules](https://molted.email/docs/cli/rules.md): Manage mailbox rules for automated thread routing
- [molted safety](https://molted.email/docs/cli/safety.md): Manage tenant safety settings
- [molted search](https://molted.email/docs/cli/search.md): Search your threads by subject, the other party's address or name, an attachment filename (fuzzy, typo tolerant), or whole words in the messages
- [molted segments](https://molted.email/docs/cli/segments.md): Manage audience segments
- [molted send](https://molted.email/docs/cli/send.md): Send an email via the agent API
- [molted settings](https://molted.email/docs/cli/settings.md): Manage tenant settings (cooldown, consent enforcement, etc.)
- [molted suppressions](https://molted.email/docs/cli/suppressions.md): Manage email suppressions and suppressed domains
- [molted team-addresses](https://molted.email/docs/cli/team-addresses.md): List, add and remove verified team addresses (sends to them are free)
- [molted templates](https://molted.email/docs/cli/templates.md): Manage email templates
- [molted threads](https://molted.email/docs/cli/threads.md): Manage email threads
- [molted timeline](https://molted.email/docs/cli/timeline.md): Get the delivery event timeline for a send request
- [molted trace](https://molted.email/docs/cli/trace.md): Get the full decision trace for a send request
- [molted update](https://molted.email/docs/cli/update.md): Update the Molted CLI to the latest version
- [molted webhooks](https://molted.email/docs/cli/webhooks.md): Manage webhook endpoints for real-time event notifications