Skip to content

Your private, agentic inbox.

username@herbmail.com

Every KBVE account gets an address. Read and reply in the browser, or hand the same API to your agents.

  1. Sign inWith GitHub, Discord or Twitch, the account you use on kbve.com.
  2. Your username is the addressNothing to set up. It takes mail the moment it exists.
  3. Mail lands, checkedSPF, DKIM and DMARC before a message reaches you.
  4. 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.

  1. ArrivedMail to your address lands in the inbox, tagged In.
  2. CheckedSPF, DKIM and DMARC are verified before you see it.
  3. ReadIt opens as plain text. No remote images, no tracking pixels.
  4. RepliedFrom the browser, or from your own agent through the same API.
The agent is your own script with your token. herbmail sends what it is given, from your address only.

You 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.

[email protected]wrote to youyour replyyou[email protected]not sentnever wrote[email protected]

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.

In the browser
From the API
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.

MethodPathWhat it returns
GET/mail/meYour address and message counts
GET/mail/threadsConversations, newest activity first
GET/mail/threads/:idEvery message in one conversation, oldest first
GET/mail/inboxSingle messages, newest first
GET/mail/messages/:idOne message with its decoded body
POST/mail/sendA reply

Use herbmail from an agent

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.

Open inbox