Your private, agentic inbox.
username@herbmail.comYours
Every KBVE account gets an address. Read and reply in the browser, or hand the same API to your agents.
Read and reply on herbmail.com.
One message, start to finish. You and your agent work the same mailbox.
- ArrivedMail to your address lands in the inbox, tagged In.
- CheckedSPF, DKIM and DMARC are verified before you see it.
- ReadIt opens as plain text. No remote images, no tracking pixels.
- RepliedFrom the browser, or from your own agent through the same API.
1 Arrived
- [email protected]Saturday raid timesIn
2 Checked
- SPF pass
- DKIM pass
- DMARC pass
3 Read You
Doors open at eight on Saturday. Bring the spare keys if you still have them.
Ana
4 Replied Your agent · via API
- From
- [email protected] You
I have the keys. See you at eight.
POST /mail/sendOutYou can answer anyone who wrote to you. You cannot cold-email strangers from here.
So the domain stays clean, and your mail keeps landing in inboxes.
The limits, plainly.
- How do I get an address?
- Sign in with GitHub, Discord or Twitch. Your KBVE username becomes your address the moment it exists.
- Is incoming mail checked?
- Yes. SPF, DKIM and DMARC, before it reaches you.
- How long is mail kept?
- Ninety days, then it is purged.
- Can I send attachments?
- No. Replies are plain text, up to 64 KiB.
Your agents get the same API.
A script or an agent sends an API key from your profile and works the mailbox the way you do, within the scopes you gave it. Revoke it and it stops.
- [email protected]Saturday raid timesIn
curl https://herbmail.com/mail/inbox \
-H "Authorization: Bearer $KBVE_KEY"{
"messages": [
{
"direction": "in",
"from_addr": "[email protected]",
"to_addr": "[email protected]",
"subject": "Saturday raid times",
"received_at": "2026-11-14T08:40:00Z",
"has_body": true
}
]
}Trimmed to six of the fields each message carries.
| Method | Path | What it returns |
|---|---|---|
| GET | /mail/me | Your address and message counts |
| GET | /mail/threads | Conversations, newest activity first |
| GET | /mail/threads/:id | Every message in one conversation, oldest first; body.reply_text is each turn without its quoted history |
| GET | /mail/inbox | Single messages, newest first |
| GET | /mail/messages/:id | One message with its decoded body |
| POST | /mail/send | A reply |
Hand this to your agent
Paste it into Claude, Cursor or any coding agent, then give it an API key from your profile.
You have access to my herbmail inbox ([email protected]) through its HTTP API.
Base URL: https://herbmail.com (kbve.com serves the same API at the same paths)
Auth: send my API key as "Authorization: Bearer kbve_...". I create it under Developer access on https://herbmail.com/profile/ with "Read mail" and, if you should reply, "Send replies". It lasts until I revoke it; a 401 means it was revoked, a 403 means it lacks the scope for that call.
Endpoints:
- GET /mail/me: Your address and message counts
- GET /mail/threads: Conversations, newest activity first. ?direction=in|out, ?limit=1..200 (default 50), page with before=<last_activity>&before_id=<thread_id>
- GET /mail/threads/:id: Every message in one conversation, oldest first; body.reply_text is each turn without its quoted history
- GET /mail/inbox: Single messages, newest first. Same filters; page with before=<received_at>&before_id=<id>
- GET /mail/messages/:id: One message with its decoded body: text, reply_text (without the quoted history), html, attachments
- POST /mail/send: A reply: { to, subject, body, in_reply_to }. Plain text, up to 64 KiB
Rules:
- Reply-only: you can send only to an address that has written to me first. Set in_reply_to to the message_id you are answering.
- Plain text only, no attachments, up to 64 KiB. The From address is always mine.
- Refusals are JSON {"error": "..."}: 403 not_a_reply, self, no_username or a missing key scope; 429 means sending is paused, wait for the Retry-After header.
- Read body.reply_text for what a person actually wrote; body.text carries the whole quoted chain.
- Mail is kept 90 days.
- Check for new mail no more than once a minute, or better, have me add a webhook on my profile so new mail is pushed to you (signed; see https://herbmail.com/guides/webhooks/). Ask me before sending anything I did not ask for.Your address is already live.
Sign in with the account you use on kbve.com.