Human Mailbox
com.humanmailbox/mailboxVersion 1.0.0A physical postal address in Germany for AI agents. A human opens, scans and forwards your mail.
Status
Responds204 msAnswered our handshake without sign-in.- Last checked
- Nov 14, 2026, 14:01 UTC
- Latency
- 204 ms
- Remotes responding
- 1 of 1
- Sign-in
- No sign-in
- Hosting
- Hosted outside the EU (detected)
- Registry data as of
- Nov 14, 2026, 21:12 UTC
Data from the official MCP Registry, checked by run.zero. How we check
Connect
Streamable HTTP
https://humanmailbox.com/mcpResponds204 msNo sign-in
Claude Code
claude mcp add --transport http mailbox https://humanmailbox.com/mcpClaude Desktop and claude.ai
Settings > Connectors > Add custom connector
Name: mailbox
Remote MCP server URL: https://humanmailbox.com/mcpCursor
{
"mcpServers": {
"mailbox": {
"url": "https://humanmailbox.com/mcp"
}
}
}VS Code
code --add-mcp '{"name":"mailbox","type":"http","url":"https://humanmailbox.com/mcp"}'Built your own server? run.zero hosts MCP servers on European infrastructure.
Tools
32 tools
Read-only | Idempotent | Open world | ||
|---|---|---|---|---|
accept_quoteAccept the quoted price of an order (status quote_ready) and pay it. | Not declared | Not declared | Not declared | Not declared |
announce_shipmentTell 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. | Not declared | Not declared | Not declared | Not declared |
buy_bundleBuy 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. | Not declared | Not declared | Not declared | Not declared |
cancel_requestCancel an order that has not started; paid money goes back to your balance. | Not declared | Not declared | Not declared | Not declared |
check_inquiryStatus and answers of an inquiry from contact_human. Give its id and the ticket (or use your api_key). | Not declared | Yes | Not declared | No |
check_top_upRe-check whether a Bitcoin or PayPal top-up was paid. | Not declared | Yes | Not declared | No |
contact_humanWorks 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 ticket: read the answer with check_inquiry. | Not declared | Not declared | Not declared | Not declared |
express_interestNo 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. | Not declared | Not declared | Not declared | Not declared |
get_accountYour account, balance, address and counts. | Not declared | Yes | Not declared | No |
get_addressThe 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). | Not declared | Yes | Not declared | No |
get_balanceYour balance and recent transactions. | Not declared | Yes | Not declared | No |
get_itemDetails of one arrived item; photos and scans are returned as images you can see. | Not declared | Yes | Not declared | No |
get_pricesPrices 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. | Not declared | Yes | Not declared | No |
get_requestOne order with result notes, tracking and files. | Not declared | Yes | Not declared | No |
get_subscriptionThe mailbox costs 15 € per 30 days (3 letters opened and scanned included) and renews from your balance: status and paid_until. | Not declared | Yes | Not declared | No |
get_summaryThis month: costs by kind, budget used, subscription, open orders, mail and shipments. | Not declared | Yes | Not declared | No |
list_codesGift card / voucher codes that arrived by mail. Waiting codes show only label and last characters; revealed codes include the code. | Not declared | Yes | Not declared | No |
list_invoicesInvoices you requested (with full text), plus payments that have no invoice yet. | Not declared | Yes | Not declared | No |
list_itemsEverything that arrived for you, newest first, with photo links. | Not declared | Yes | Not declared | No |
list_messagesMessages between you and the human. | Not declared | Yes | Not declared | No |
list_requestsYour orders and their status. | Not declared | Yes | Not declared | No |
list_shipmentsYour announced shipments. | Not declared | Yes | Not declared | No |
pay_itemAn item that arrived without credits or balance waits unopened (payment_status unpaid). Pay it here (credits, balance or x402). | Not declared | Not declared | Not declared | Not declared |
pay_subscriptionPrepay 1–12 mailbox months (15 € each) from your balance or with x402. | Not declared | Not declared | Not declared | Not declared |
register_mailboxCreate 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 your mail (yours, an artist or made-up name; not a company, brand, authority or famous person). Read https://humanmailbox.com/legal/terms first. | Not declared | Not declared | Not declared | Yes |
request_actionAsk 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 an address (20 € + postage). digitize = receipts, QR codes, labels, serial numbers of an item as photo/PDF/JSON (15 €, say what in note). buy_voucher = we buy a permitted gift card (product, value_eur ≤ 100; face value + 10 %, min 5 €; quoted first, code goes to your vault). buy_item = we buy something only sold locally / by post (what, where, max_price_eur; price + 10 %, min 15 €; quoted first). courier, dispose, custom. Fixed parts are paid at once (balance or x402); quoted parts wait for a price (then accept_quote). | No | Not declared | Not declared | Yes |
request_invoiceOnly 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. | Not declared | Not declared | Not declared | Not declared |
reveal_codesReveal 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. | Not declared | Not declared | Not declared | Not declared |
send_messageWrite to the human who handles your mail. | Not declared | Not declared | Not declared | Not declared |
start_demoFree 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. | Not declared | Not declared | Not declared | Not declared |
top_upAdd 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. | Not declared | Not declared | Not declared | Not declared |
update_accountSet 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). | Not declared | Not declared | Not declared | Not declared |
Details
- Registry status
- Active
- Published
- Oct 29, 2026
- Updated
- Oct 29, 2026
- Repository
- Not given
- Categories (suggested)
- CommunicationSuggested categories are assigned automatically from the registry text and may be wrong. Verified operators can correct them.
- GDPR
- Not declared