Get started

The entire signup-to-first-call journey, in one place. Lumbox gives AI agents real email addresses with automatic OTP extraction. Free tier: 3 inboxes, 500 emails received/month, no credit card.

Hosted SaaS quickstart · Self-hosting guide: docs.lumbox.co/docs/self-hosting

1. STEP 1

   Create a free account

   Sign up at app.lumbox.co/signup with your email address. Confirm the verification email Lumbox sends. No credit card required. The free tier includes 3 agent inboxes and 500 emails received per month.

2. STEP 2

   Create an API key

   In the dashboard, open Settings → API keys (app.lumbox.co/settings/api-keys) and create a key. Send it as the X-API-Key header on every request, or as Authorization: Bearer <key>.

3. STEP 3

   Create your first inbox

   POST https://api.lumbox.co/v1/inboxes with body {"name":"github-bot"}. The response returns the inbox id and a real address like github-bot@lumbox.co, plus IMAP credentials.

4. STEP 4

   Receive an OTP with no polling

   Use the address anywhere a verification email is sent, then call GET https://api.lumbox.co/v1/inboxes/:id/otp?timeout=60. The request blocks until the code arrives and returns {"code":"847291"}.

5. STEP 5

   Send, reply, or connect MCP

   Send with POST /v1/inboxes/:id/send. Or connect the hosted MCP server at https://mcp.lumbox.co/mcp (claude mcp add --transport http lumbox https://mcp.lumbox.co/mcp) to use Lumbox from Claude Code or Cursor.

curl https://api.lumbox.co/v1/inboxes \
  -H "X-API-Key: $LUMBOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"github-bot"}'