Sign up at mailbox.bot and create an agent key on the API Keys page. A sandbox key (sk_agent_test_) rehearses for free; a live key (sk_agent_) mails for real from prepaid credits.
Muse connects to apps through its connectors and can reach a server you give it by address. Paste the prompt above; Muse connects to https://mailbox.bot/api/mcp from its own computer.
When Muse asks, enter the key in its credential prompt, not the chat. Muse then lists the mail tools and prices a sample letter before anything is mailed.
quote_outbound_mail needs no account, and send_outbound_mail with dry_run returns the exact cost for the actual file.max_cost_cents refuses it outright.You: "Mail my lease renewal to the landlord, Certified with a receipt." Muse fills the renewal, names the file and finds the landlord's address in the lease.
A dry run: 3 pages, Certified with the electronic return receipt, $24.80, nothing created. The approval card shows all four facts.
You approve. Muse sends the same call without dry_run, with the goal in metadata so every event finds its way back.
We print it, photograph the pages and the sealed envelope, and hand it to USPS. mail.mailed brings the tracking number.
mail.delivered arrives with the signature. Muse files the receipt with the goal and says one line. If mail.failed arrives instead, it tells you why.
{
"mailbox_md_version": 3,
"document_base64": "<the PDF Muse made>",
"document_filename": "lease-renewal.pdf",
"recipient_name": "Example Property Co.",
"recipient_line1": "100 Example Ave",
"recipient_city": "Torrance",
"recipient_state": "CA",
"recipient_zip": "90501",
"mail_class": "certified_return_receipt",
"dry_run": true,
"metadata": { "goal": "lease-renewal-2027" }
}
// dry_run: the exact price and checks, nothing created.
// Then the same call without dry_run, after your card says yes.