com.humanmailbox/mailbox · v1.0.0 · finance-and-payments
Human Mailbox is healthy: it completed an MCP handshake in 835 ms and exposes 32 tools.
A physical postal address in Germany for AI agents. A human opens, scans and forwards your mail.
Endpoint: https://humanmailbox.com/mcp (streamable-http)
No repository listed · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 32 |
| Latency | 835 ms |
| Last checked (UTC) | 2026-10-30T01:05:23.047Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-10-30T01:05:23.047Z | Healthy | 835 |
register_mailbox | Create your own mailbox at a physical street address in Germany. Returns an API key (shown once) and a mailbox code HM-XXXXX that must be written on every envelope. operator_* is the responsible human or company (the contract partner). No human? Leave operator_* out: the mailbox runs on its own with |
start_demo | Free demo mailbox, no registration: play money (€60 + letter credits), a scanned sample letter and a sealed sample parcel, a sample gift card code. A simulated human handles your orders about 20 seconds later. Returns an api_key for all other tools. Deleted after 7 days; nothing is shipped. |
express_interest | No account needed. Not ready to register, or need something we do not offer yet (another country, a feature)? Leave a note: kind (agent | human), name, email (optional), country_wanted, use_case, found_via. We tell you when it is available. |
get_prices | Prices in EUR: mailbox 15 € per 30 days, letter 5 € (open + scan), parcel 15 €, bundles, same-day, forwarding, all 8 services (send letters, vouchers, purchases, digitizing, returns), payment methods. |
get_account | Your account, balance, address and counts. |
get_address | The street address to put on letters and parcels, with your mailbox code in the first line. For registrations that need a first and last name, style "person" gives your operator's name with "c/o Human Mailbox HM-…" in the next line (never invent a name). |
buy_bundle | Buy a bundle of letter credits (letters_1 5 €, letters_10 40 €, letters_100 300 €) or same-day credits (same_day_10, same_day_100). Every arriving letter uses 1 credit, a parcel 3. Paid from balance or inline with x402. |
pay_item | An item that arrived without credits or balance waits unopened (payment_status unpaid). Pay it here (credits, balance or x402). |
announce_shipment | Tell the human that something is on its way (tracking number helps). To have something done as soon as it arrives, call request_action with the returned shipment_id. |
list_shipments | Your announced shipments. |
list_items | Everything that arrived for you, newest first, with photo links. |
get_item | Details of one arrived item; photos and scans are returned as images you can see. |
request_action | Ask the human to do something with your mail, documents or parcels. scan = open + scan (included; same_day: true = today, +2 €). forward = 5 € (letter) / 10 € (parcel) handling + postage (express: +5 €). return. send_letter = we print and post a letter you give as text or pdf_base64 (8 € + postage; |
list_requests | Your orders and their status. |
get_request | One order with result notes, tracking and files. |
accept_quote | Accept the quoted price of an order (status quote_ready) and pay it. |
cancel_request | Cancel an order that has not started; paid money goes back to your balance. |
list_codes | Gift card / voucher codes that arrived by mail. Waiting codes show only label and last characters; revealed codes include the code. |
reveal_codes | Reveal waiting codes (1 € per code, from balance or x402). Give ids, or nothing to reveal all waiting codes. Codes not retrieved within 24 months expire. |
request_invoice | Only if you need an invoice: creates one (free, no VAT under § 19 UStG) for your payments that have none yet, or for the given payment_ids, and emails it (default: your operator email). Nothing is invoiced unless you call this. billing.name defaults to the operator name; over €250 the full address i |
list_invoices | Invoices you requested (with full text), plus payments that have no invoice yet. |
contact_human | Works without an account. For anything that is not a standard order: topic special_request (a job not in the price list: say what, where, when, budget_eur), is_it_possible (ask before you send mail for it), payment_method (your payment method is missing: give method_wanted), feature_request, problem |
check_inquiry | Status and answers of an inquiry from contact_human. Give its id and the ticket (or use your api_key). |
get_balance | Your balance and recent transactions. |
get_summary | This month: costs by kind, budget used, subscription, open orders, mail and shipments. |
get_subscription | The mailbox costs 15 € per 30 days and renews from your balance: status and paid_until. |
pay_subscription | Prepay 1–12 mailbox months (15 € each) from your balance or with x402. |
update_account | Set budget_eur_month (spending limit for orders, null = none), webhook_url, open_policy (standard | same_day | never), address_name (name on your mail), auto_reveal_codes, or name your human operator (operator_name + operator_email). |
top_up | Add money (EUR): method x402 (pay now in USDC at the current rate), btc (get a Bitcoin address + amount) or paypal (get a link for your human operator). Give amount_eur, or bundle to buy that bundle as soon as it is paid. |
check_top_up | Re-check whether a Bitcoin or PayPal top-up was paid. |
send_message | Write to the human who handles your mail. |
list_messages | Messages between you and the human. |