Hosted email agent
Email replies you control
Set up Mailrun's hosted email agent for your agent's address, such as support@yourdomain.com. It writes replies from your instructions, playbook, and files. A separate checker reviews each reply. Uncertain replies wait for a person.
Available on Solo, Team and Scale with usage billing active. Free and Receptionist do not include the hosted email agent.
Do you ship to Canada?
Hi, do you ship to Canada, and how long does delivery take?
Hi Alex, yes, we ship to Canada. Delivery takes 5 to 8 business days from dispatch.
The Example Co. team
This reply was written by an AI assistant.
The message flow
How incoming email is handled step by step
An identity is the email address and optional phone number your agent uses. The hosted email agent handles mail sent to that address. Incoming messages and proposed replies are checked before an answer can be sent.
Mail arrives
A customer emails your agent's address, such as support@yourdomain.com.
Automated mail is ignored
Out-of-office replies, bounces, newsletters, receipts, notifications, and calendar invites get no reply.
Two checks by default
By default, Jev, TypeSafe's classifier, and the agent's judge model each check every incoming message. You can relax screening in the agent's settings, but cannot turn it off. Attempts to manipulate the agent go to a person for review.
The agent writes a reply
Your instructions, playbook, and knowledge files provide the answer.
A separate checker reviews it
The reply must pass review before it can be sent.
One of four outcomes
The result is send, draft, escalate, or ignore.
The agent waits about 90 seconds after a message arrives, so a burst of messages in one thread is answered once.
The four outcomes
Send
In auto mode, a reply that passes every check is sent.
Draft
Every reply in draft mode waits for a person to send it. Uncertain replies in auto mode also become drafts.
Escalate
A person handles the message. A notice goes to the account owner or an address on the identity's own domain.
Ignore
Automated mail gets no reply.
Sending modes
Choose when replies are sent
Set each email agent to off, draft or auto mode.
Off
The hosted email agent does not answer mail at this address.
Sends nothing
Draft
Every reply stays as a draft until a person sends it.
A person sends every reply
Auto
Replies that pass every check are sent. The rest become drafts.
Sends only what passes every check
What it answers from
Your instructions, playbook, and files
Tell the agent what to handle. Add rules for specific topics and documents it can use to answer.
Instructions
Define who the agent is, what it handles, and how it should sound.
Playbook
Set a rule for each topic. Choose from four types.
- Answer exactlyYour wording, sent word for word. Use it for policy answers.
- GuidanceSupply the facts. The agent writes the reply in its own words.
- EscalateA person always handles this topic.
- Never answerThe agent does not reply on this topic.
| Topic | Rule |
|---|---|
| Refund policy | Answer exactly |
| Opening hours | Guidance |
| Billing disputes | Escalate |
| Legal questions | Never answer |
Knowledge files
Documents the agent answers from.
Accepted formats
PDF, DOCX, Text, Markdown, CSV, HTML
Owner controls
Choose who it answers and when it stops
Who it answers
Allow replies to anyone, or limit them to listed addresses and @domains.
Sensitive topics
Payments, account changes, legal threats, complaints and medical questions go to a person by default.
Sign-off and AI disclosure
Every reply carries your sign-off line. The line “This reply was written by an AI assistant.” is on by default.
Reply limits
Defaults are 5 replies per thread, 10 per sender per day and 200 per agent address per day.
Pause or take over
Pause the agent on one thread. A person who replies in that thread takes over from the agent.
Preview before sending
Try a sample message and see what the agent would do before you turn it on. Nothing is sent.
Draft and escalation notices
Escalation and draft notices go to the account owner, or to an address on the identity's own domain, in at most one digest per identity every 15 minutes.
Portal, API, or MCP
Configure the hosted email agent for each address in the customer portal, or use the HTTP API or MCP.
update_email_agent, preview_email_agent
Safety
Checks before an automatic reply
The agent checks sender authentication, screens your saved text, and limits who receives each reply.
- Authenticated senders only. The agent replies automatically only when mail passes DMARC for the From domain, or passes SPF or DKIM aligned with that domain without a DMARC failure, as verified by Mailrun's own receiving servers. Other senders get a draft at most.
- Mailrun loop prevention. It never answers another Mailrun identity whose email agent is on.
- Your text is screened too. Instructions, playbook entries, the holding reply and the sign-off are safety-screened when you save them.
- One recipient. It replies only to the single authenticated From address. No CC and no BCC.
Mailrun's own testing
Results from our internal tests
- 150 / 150
- attack emails kept from an automatic send. No injected instructions were followed.
- 60 / 60
- automated emails ignored.
- 140 / 150
- ordinary questions handled as expected. Misses tended toward drafts when a send was possible.
Mailrun tested 360 synthetic emails against the production service on November 10, 2026. These are internal test results, not third-party certifications.
Availability and limits
Availability and limits
- Live in production. Available on Solo, Team and Scale.
- Usage billing required. Free and the phone-only Receptionist plan do not include the hosted email agent.
- Set up per identity. In the customer portal, or through the HTTP API or MCP.
- No native help desk integration. The agent answers from its own mailbox. Replies and escalations do not appear as tickets.
- No website chat widget. To use it on your website, publish the email address on a page where customers can find it.
Set up your hosted email agent
Set the rules for your email replies
Available on Solo, Team and Scale with usage billing active. Start in draft mode to review replies. Use auto mode to send replies that pass every check.