drop a MAILBOX.md into your agent

how to wire it up
1

Create an agent in the mailbox.bot dashboard. Grab your API key from the API Keys tab. Optionally set a webhook URL — we'll POST package events there in real time. If you skip it, your agent can poll the API instead.

2

Drop a MAILBOX.md file into your agent's context — system prompt, project root, MCP tool config, or wherever your agent reads instructions.

3

Your agent reads the file, calls the API, and configures your standing instructions as rules. Packages arrive, rules evaluate, actions fire — automatically.

📬v1.0 — accepted package types

mailbox.bot accepts packages from private carriers only — FedEx, UPS, DHL, Amazon, and other commercial carriers. Carrier-delivered documents — such as FedEx envelopes, UPS Express letters, and DHL document shipments — are accepted and processed as carrier packages (photograph, scan, forward). We do not accept USPS mail in v1.0 — no CMRA, no Form 1583. Any USPS deliveries will be returned to sender. USPS support is planned for v2.

🤖hardware agentparts & components
MAILBOX.md
# Package Instructions

You manage shipments at mailbox.bot
Ref MB-8C2D

## Component orders

- Digi-Key, Mouser, SparkFun, Adafruit
- Photograph every shipment on arrival
- Log to parts inventory
- Small packages → forward to the lab
- Heavy (20+ lbs) → hold for pickup,
  post in #logistics

## High-value items

- Anything over $200 →
  Requires approval. Slack me.
  I'll approve from the dashboard.

## Unknown senders

- Hold and Slack me with photos
what happens
📦
Digi-Key shipment arrives via FedEx
Photographed (label + contents). Logged to parts inventory.
⚙️
Rules evaluate automatically
sender_contains: "Digi-Key" matches → forward action created
🚚
Small package forwarded to lab
Under 20 lbs. Auto-forwarded. No approval needed.
💬
Posted to #logistics
"Digi-Key order received: ESP32 dev boards x10. Forwarded to Lab 204."
when approval is required
📦
$450 oscilloscope arrives
High-value item detected. Forwarding paused.
🔔
Slack notification sent
"$450 shipment from Keysight needs approval to forward. Review: mailbox.bot/dashboard"
🧑‍💻
You approve on dashboard
Review photos and details. Approve forwarding.
✅
Forwarded after approval
Package shipped. Inventory updated automatically.
📦shopping agentonline orders
MAILBOX.md
# Package Instructions

You manage my packages at mailbox.bot
Ref MB-3A7F

## Online orders

- Amazon, Shopify → forward home
- Send me a Slack alert with photos
- Heavy packages (20+ lbs) → hold,
  text me for pickup

## Unknown senders

- Photo it, Slack me
- Don't forward without my OK →
  Requires approval

## Notifications

- Slack for everything
- Needs approval → Slack DM with
  a link to mailbox.bot/dashboard
what happens
📦
Amazon package arrives via UPS
Photographed, sender matched. Forward rule triggers.
⚙️
Rules evaluate automatically
sender_contains: "Amazon" matches → forward action created
🚚
Auto-forwarded to home
Shipped to your address via UPS Ground. No approval needed.
💬
Slack alert sent
"Your Amazon package has been forwarded to 456 Home St"
when approval is required
📦
Unknown sender package arrives
No matching rule. Photographed and held.
💬
Slack DM sent
"Unknown package from Shenzhen, CN. Review: mailbox.bot/dashboard"
🧑‍💻
You decide on dashboard
See photos. Approve to forward, or hold for pickup.

you stay in control

write “needs approval” next to any rule in your MAILBOX.md. the action pauses. you get pinged. you review it in the dashboard.

1
📦
package arrives

A rule matches but you marked it as needing approval. The action is created but pauses.

2
💬
you get pinged

Your agent sends you a Slack DM, email, or text with a link to the mailbox.bot dashboard.

3
🖥️
you review & approve

Login, see photos and details, approve or deny. The action runs after approval.

📦

give your agent
a physical endpoint.

drop a MAILBOX.md into your agent — it handles the rest, sensitive stuff waits for you

API docsget started →