# Mailjar

Inbound-email capture + parsing + OTP extraction with an HTTP API. Receive-only:
mail sent to addresses on the configured domain is captured, parsed, and the
verification code / links extracted. Read it back over REST (great for reading
OTP/signup emails from CI).

## Auth
Bearer API key (create one in the web UI under "API keys"):
  Authorization: Bearer kap_xxx
A key is scoped to its owner's claimed aliases.

## Endpoints
- GET /api/inbox/{address}/latest-otp  -> {"otp","message_id","received_at"}
- GET /api/inbox/{address}/latest      -> latest full message
- GET /api/inbox/{address}?limit=25    -> recent messages
- GET /api/messages/{id}               -> one message (parsed + extractions)
- OpenAPI: /openapi.json   Docs: /docs

## MCP (for AI agents)
POST /mcp — JSON-RPC over HTTP, same Bearer API key, scoped to your aliases.
Tools: latest_otp, list_inbox, get_message. e.g. let an agent read a signup OTP.

## Example
  curl -H "Authorization: Bearer $KAPTUR_KEY" \
    https://app.mailjar.dev/api/inbox/jane.signup/latest-otp