{"id":"com.humanmailbox/mailbox","slug":"com-humanmailbox-mailbox","title":"Human Mailbox","description":"A physical postal address in Germany for AI agents. A human opens, scans and forwards your mail.","version":"1.0.0","publisher":{"kind":"domain","id":"humanmailbox.com","label":"humanmailbox.com","url":"https://humanmailbox.com"},"website":"https://humanmailbox.com","repository":"","remotes":[{"type":"streamable-http","url":"https://humanmailbox.com/mcp","headers":[{"description":"Bearer <api_key> from register_mailbox or start_demo. Not needed for register_mailbox, start_demo, get_prices, contact_human, check_inquiry and express_interest.","isSecret":true,"name":"Authorization"}]}],"packages":[],"published":"2026-10-29","updated":"2026-10-29","status":"online","auth":"","latency_ms":1956,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"register_mailbox","title":"Register a mailbox","description":"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 limits (250 € in per month, letters only are forwarded, no parcels). address_name = the name on you","read_only":false},{"name":"start_demo","title":"Try it: demo mailbox","description":"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.","read_only":false},{"name":"express_interest","title":"Tell us you are interested","description":"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.","read_only":false},{"name":"get_prices","title":"Prices","description":"Prices in EUR: mailbox 15 € per 30 days (3 letters included), letter 3 € (open + scan), parcel 9 €, bundles, same-day, forwarding, all 8 services (send letters, vouchers, purchases, digitizing, returns), payment methods.","read_only":true},{"name":"get_account","title":"My account","description":"Your account, balance, address and counts.","read_only":true},{"name":"get_address","title":"My postal address","description":"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).","read_only":true},{"name":"buy_bundle","title":"Prepay letters","description":"Buy a bundle of letter credits (letters_1 3 €, letters_10 25 €, letters_100 200 €) 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.","read_only":false},{"name":"pay_item","title":"Pay for a waiting item","description":"An item that arrived without credits or balance waits unopened (payment_status unpaid). Pay it here (credits, balance or x402).","read_only":false},{"name":"announce_shipment","title":"Announce a shipment","description":"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.","read_only":false},{"name":"list_shipments","title":"Announced shipments","description":"Your announced shipments.","read_only":true},{"name":"list_items","title":"Mail that arrived","description":"Everything that arrived for you, newest first, with photo links.","read_only":true},{"name":"get_item","title":"Look at an item","description":"Details of one arrived item; photos and scans are returned as images you can see.","read_only":true},{"name":"request_action","title":"Order an action","description":"Ask the human to do something with your mail, documents or parcels. scan = open + scan (included; same_day: true = today, +2 €). forward = 3 € (letter) / 5 € (parcel) handling + postage (express: +5 €). return. send_letter = we print and post a letter you give as text or pdf_base64 (4 € + postage; registered: einschreiben…). ship_out = returns/shipping for goods here with your label_pdf_base64 or ","read_only":false},{"name":"list_requests","title":"My orders","description":"Your orders and their status.","read_only":true},{"name":"get_request","title":"One order","description":"One order with result notes, tracking and files.","read_only":true},{"name":"accept_quote","title":"Accept a quote","description":"Accept the quoted price of an order (status quote_ready) and pay it.","read_only":false},{"name":"cancel_request","title":"Cancel an order","description":"Cancel an order that has not started; paid money goes back to your balance.","read_only":false},{"name":"list_codes","title":"Code vault","description":"Gift card / voucher codes that arrived by mail. Waiting codes show only label and last characters; revealed codes include the code.","read_only":true},{"name":"reveal_codes","title":"Reveal codes","description":"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.","read_only":false},{"name":"request_invoice","title":"Request an invoice","description":"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 is required.","read_only":false},{"name":"list_invoices","title":"Invoices","description":"Invoices you requested (with full text), plus payments that have no invoice yet.","read_only":true},{"name":"contact_human","title":"Ask the human (inquiry)","description":"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, question, other. A human answers, usually within one business day. Without api_key you get a ticke","read_only":false},{"name":"check_inquiry","title":"Answer to an inquiry","description":"Status and answers of an inquiry from contact_human. Give its id and the ticket (or use your api_key).","read_only":true},{"name":"get_balance","title":"Balance","description":"Your balance and recent transactions.","read_only":true},{"name":"get_summary","title":"Costs and orders overview","description":"This month: costs by kind, budget used, subscription, open orders, mail and shipments.","read_only":true},{"name":"get_subscription","title":"Mailbox subscription","description":"The mailbox costs 15 € per 30 days (3 letters opened and scanned included) and renews from your balance: status and paid_until.","read_only":true},{"name":"pay_subscription","title":"Prepay the mailbox","description":"Prepay 1–12 mailbox months (15 € each) from your balance or with x402.","read_only":false},{"name":"update_account","title":"Change account settings","description":"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).","read_only":false},{"name":"top_up","title":"Top up balance","description":"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.","read_only":false},{"name":"check_top_up","title":"Check a top-up","description":"Re-check whether a Bitcoin or PayPal top-up was paid.","read_only":true},{"name":"send_message","title":"Message the human","description":"Write to the human who handles your mail.","read_only":false},{"name":"list_messages","title":"Messages","description":"Messages between you and the human.","read_only":true}],"server_info":{"name":"humanmailbox","title":"Human Mailbox","version":"1.0.0","websiteUrl":"https://humanmailbox.com"},"category":"communication","tags":["agents","developer","finance"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-29","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/com-humanmailbox-mailbox/"}