list_mailboxes
List mailboxes with warmup status, daily limits, sent-today counts and reply capture.
›Show me all mailboxes with how much of today’s limit each has used, sorted by remaining capacity.
What it does
Everything that decides whether a given mailbox can send right now, in one row: its warmup stage, the daily limit currently in force, how many sends it has already used today, and whether replies are being captured.
The `sent_today` counter is the one to watch when volume looks lower than expected. Mailboxes hit their cap and stop; the campaign is not broken, it is throttled, and the difference matters when you are deciding whether to add mailboxes or wait out the ramp.
Reading remaining capacity across every mailbox before enrolling a large list is the planning step most people skip. Four mailboxes with 30 a day is 120 sends, so a list of a thousand takes over a week to work through even with everything healthy. Knowing that in advance is the difference between a paced campaign and a support ticket.
Parameters
None. Call it with an empty object — there is nothing to configure.
* required · Maps to GET /api/mailboxes
What comes back
Array of mailboxes with warmup stage, `daily_limit`, `sent_today`, `reply_capture`.
The thing people get wrong
A high `daily_limit` on a mailbox does not raise the ceiling. The pipeline enforces a hard 30/day cap regardless of what the mailbox record says.
Use it with
create_mailbox
Create a sending mailbox on a verified domain, with reply capture wired up automatically.
warmup_stats
Warmup overview: per-mailbox progress, thread and reply counts, pool accounts.
reconcile_reply_capture
Ensure every active mailbox has a working inbound routing rule — sends are gated on it.
More mailboxes tools
See all 22 tools and the connection string on the MCP server page.