Real email for AI agents.

import { Mailroom } from '@mailroom/sdk';

const mr = new Mailroom({
  apiKey: process.env.MAILROOM_API_KEY!,
  baseUrl: 'https://mailroom.capumattu.com',
});

// Idempotent on client_id: run it twice, get the same inbox back.
const inbox = await mr.inboxes.create({
  username: 'support-bot',
  display_name: 'Support Bot',
  client_id: 'support-bot',
});
console.log(inbox.address); // support-bot@agents.capumattu.com

// Wait for the next email (long-poll, up to 60 s). No public URL needed.
const msg = await mr.messages.wait(inbox.id, { timeout: 60 });
if (msg) {
  console.log(msg.extracted_text); // the new part of the reply only
  await mr.messages.reply(inbox.id, msg.id, { text: 'Thanks, on it.' });
}

from capumattu import Capumattu

with Capumattu() as mr:  # reads MAILROOM_API_KEY and MAILROOM_URL
    inbox = mr.inboxes.create(
        username="support-bot",
        display_name="Support Bot",
        client_id="support-bot",  # idempotent
    )
    print(inbox["address"])  # support-bot@agents.capumattu.com

    # Wait for the next email (long-poll, up to 60 s). None on timeout.
    msg = mr.messages.wait(inbox["id"], timeout=60)
    if msg:
        print(msg["extracted_text"])  # the new part of the reply only
        mr.messages.reply(inbox["id"], msg["id"], text="Thanks, on it.")

{
  "mcpServers": {
    "capumattu": {
      "command": "npx",
      "args": ["-y", "@capumattu/mcp"],
      "env": {
        "MAILROOM_API_KEY": "mr_...",
        "MAILROOM_URL": "https://mailroom.capumattu.com"
      }
    }
  }
}

curl -s https://mailroom.capumattu.com/v1/inboxes \
  -H "Authorization: Bearer $MAILROOM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"support-bot","display_name":"Support Bot","client_id":"support-bot"}'

# Wait up to 60 s for the next inbound email
curl -s "https://mailroom.capumattu.com/v1/inboxes/$INBOX_ID/messages/wait?timeout=60" \
  -H "Authorization: Bearer $MAILROOM_API_KEY"