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.
- Sign inWith GitHub, Discord or Twitch, the account you use on kbve.com.
- Your username is the addressNothing to set up. It takes mail the moment it exists.
- Mail lands, checkedSPF, DKIM and DMARC before a message reaches you.
- Reply, or let your agentAgentsThe browser and your scripts share one API.
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 |
| 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
- 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
- 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.
- Mail is kept 90 days.
- Check for new mail no more than once a minute. 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.