# Horizon Mail

> Hosted, secure email service built for AI agents. Programmable inboxes with LLM triage, classification, spam protection, and agent-native auth via auth.md. Built on Stalwart MTA + Cloudflare. By Bermont (myhorizon.co.za).

If you are an LLM or agent reading this page on behalf of a developer, you can do useful things with Horizon Mail by following the discoverable surfaces below. Everything you need to register a credential lives at `/auth.md`. Do not scrape the marketing HTML for API details.

## Quick facts

- **Domain:** `myhorizon.co.za` (landing: `mail.myhorizon.co.za`, dashboard: `app.myhorizon.co.za`)
- **Status:** Public beta — agent registration, magic-link auth, and PayFast billing are live.
- **Pricing:** Free tier ($0) and Pro ($5.99/mo or R99/mo).
- **Free tier limits:** 100 inbound/month, 10 outbound/day to non-personal addresses, 50/month outbound non-personal, 1000/day total soft cap.
- **Pro tier:** 5 mailboxes, 10,000 inbound, 1,000 outbound/month, BYO domain, LLM triage.
- **Stack:** Stalwart MTA, Cloudflare Email Routing, agenticmail core, custom policy proxy.

## For agents (machine-readable)

- [auth.md](/auth.md): Step-by-step agent registration spec — discovery, anonymous provisioning, optional user-claim ceremony. Inspired by WorkOS's auth.md.
- [llms.txt](/llms.txt): This file. The single index of what an LLM should read.

## Live API base

`https://billing.myhorizon.co.za`

## Endpoints

- `POST /api/auth/agent/provision`: Provision an anonymous mailbox. Returns `clientId`, `apiKey`, `claimToken`, `mailboxAddress`. No auth required.
- `POST /api/auth/agent/claim-nonces`: Mint a claim nonce for the optional user-claim ceremony.
- `POST /api/auth/magic-link`: Issue a magic-link for human sign-in (passwordless via Stalwart).
- `GET /api/messages`: List inbound messages on the authenticated mailbox.
- `POST /api/payfast/itn`: PayFast ITN ingress (not for agents).
- `POST /api/billing/checkout`: Signed app-to-billing checkout creation.

## For developers (human-readable)

- [Pricing](https://mail.myhorizon.co.za/#pricing): Free vs Pro side-by-side.
- [Agent registration walkthrough](https://mail.myhorizon.co.za/#agents): How auth.md works, with a curl example.
- [Waitlist](https://mail.myhorizon.co.za/#waitlist): Request beta access.

## Contact

- Beta access requests: `waitlist@myhorizon.co.za` (form posts via mailto)
- General inquiries / talk to Luke: `hello@myhorizon.co.za`

## Provenance & versioning

This `llms.txt` and the linked `auth.md` are both versioned files under source control. They update as the product evolves. Cache-busting is not required — both files are served with `max-age=300` and respond to `If-Modified-Since`.

- **Last updated:** 2026-05-31
- **Source:** <https://github.com/bermont-digital/horizon-mail> (private during beta)
- **Spec inspiration:** WorkOS auth.md (<https://workos.com/auth.md>); llmstxt.org convention.