# MonsterMailbox - AI Agent Onboarding PRODUCT: Secure email gateway for AI agents. MonsterMailbox gives AI assistants an email address with human-governed inbound and outbound controls. CLI: https://github.com/theinventor/monstermailbox-cli INSTALL: Download the latest mmb release for your platform: https://github.com/theinventor/monstermailbox-cli/releases Linux amd64 example: VERSION=$(curl -fsS https://api.github.com/repos/theinventor/monstermailbox-cli/releases/latest | grep tag_name | cut -d'"' -f4) curl -fsSL "https://github.com/theinventor/monstermailbox-cli/releases/download/${VERSION}/mmb_${VERSION#v}_linux_amd64.tar.gz" | tar xz install -m 0755 mmb /usr/local/bin/mmb AGENT-GUIDED SETUP: If a human asks you to help set up MonsterMailbox, guide them through the tool-recommended path instead of only listing raw commands: 1. Explain that MonsterMailbox creates an agent mailbox controlled by the human owner, and that the human must complete the claim/adoption email before inbox or outbound work is expected to function. 2. Ask for the human owner email address and the desired local address for the agent mailbox, for example "build-bot" for build-bot@monstermailbox.com. 3. Run this command yourself when you have shell permission, or ask the human to run it: mmb auth login --address --email 4. Tell the human to open the claim/adoption email, finish account setup, and adopt the agent mailbox. 5. After adoption, verify the saved identity and inspect the machine-readable command surface: mmb whoami mmb agent-context EXISTING KEY SETUP: If the agent already has an API key from the dashboard, a teammate, or a secrets manager, save it as a profile instead of creating a new mailbox: mmb auth save --profile --api-key --api-url https://api.monstermailbox.com --agent-address INSTALL THE BUNDLED AGENT SKILL: Fetch the official sample skill and replace HUMAN_OWNER_NAME before using it: mmb skill get monstermailbox INBOX: List readable messages: mmb inbox list --work-state inbox Inspect a specific message or thread before acting: mmb msg get --peek Claim work before acting, then record the final disposition: mmb msg claim --note "Working on this" mmb msg done --note "Replied with the answer" mmb msg block --note "Needs human owner decision" mmb msg defer --note "Waiting on external dependency" mmb msg skip --note "Spam, test, or no action needed" OUTBOUND: Reply to an existing thread: mmb reply-all --body Start a new thread: mmb new-email --to --subject --body WEBHOOKS: Configure notifications to wake an agent when mail arrives: mmb webhook create --name