Skip to main content

Human Mailbox

com.humanmailbox/mailboxVersion 1.0.0

A physical postal address in Germany for AI agents. A human opens, scans and forwards your mail.

Status

Responds204 msAnswered our handshake without sign-in.

Registry data may be out of date

We could not refresh it, so this page shows the last copy.
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 ms
No sign-in

Claude Code

claude mcp add --transport http mailbox https://humanmailbox.com/mcp

Claude Desktop and claude.ai

Settings > Connectors > Add custom connector
Name: mailbox
Remote MCP server URL: https://humanmailbox.com/mcp

Cursor

{
  "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.

Host your own MCP server on run.zero

Tools

32 tools

Tools of Human Mailbox
Read-only
Idempotent
Open world
accept_quoteAccept the quoted price of an order (status quote_ready) and pay it.Not declaredNot declaredNot declaredNot 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 declaredNot declaredNot declaredNot 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 declaredNot declaredNot declaredNot declared
cancel_requestCancel an order that has not started; paid money goes back to your balance.Not declaredNot declaredNot declaredNot declared
check_inquiryStatus and answers of an inquiry from contact_human. Give its id and the ticket (or use your api_key).Not declaredYesNot declaredNo
check_top_upRe-check whether a Bitcoin or PayPal top-up was paid.Not declaredYesNot declaredNo
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 declaredNot declaredNot declaredNot 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 declaredNot declaredNot declaredNot declared
get_accountYour account, balance, address and counts.Not declaredYesNot declaredNo
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 declaredYesNot declaredNo
get_balanceYour balance and recent transactions.Not declaredYesNot declaredNo
get_itemDetails of one arrived item; photos and scans are returned as images you can see.Not declaredYesNot declaredNo
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 declaredYesNot declaredNo
get_requestOne order with result notes, tracking and files.Not declaredYesNot declaredNo
get_subscriptionThe mailbox costs 15 € per 30 days (3 letters opened and scanned included) and renews from your balance: status and paid_until.Not declaredYesNot declaredNo
get_summaryThis month: costs by kind, budget used, subscription, open orders, mail and shipments.Not declaredYesNot declaredNo
list_codesGift card / voucher codes that arrived by mail. Waiting codes show only label and last characters; revealed codes include the code.Not declaredYesNot declaredNo
list_invoicesInvoices you requested (with full text), plus payments that have no invoice yet.Not declaredYesNot declaredNo
list_itemsEverything that arrived for you, newest first, with photo links.Not declaredYesNot declaredNo
list_messagesMessages between you and the human.Not declaredYesNot declaredNo
list_requestsYour orders and their status.Not declaredYesNot declaredNo
list_shipmentsYour announced shipments.Not declaredYesNot declaredNo
pay_itemAn item that arrived without credits or balance waits unopened (payment_status unpaid). Pay it here (credits, balance or x402).Not declaredNot declaredNot declaredNot declared
pay_subscriptionPrepay 1–12 mailbox months (15 € each) from your balance or with x402.Not declaredNot declaredNot declaredNot 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 declaredNot declaredNot declaredYes
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).NoNot declaredNot declaredYes
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 declaredNot declaredNot declaredNot 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 declaredNot declaredNot declaredNot declared
send_messageWrite to the human who handles your mail.Not declaredNot declaredNot declaredNot 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 declaredNot declaredNot declaredNot 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 declaredNot declaredNot declaredNot 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 declaredNot declaredNot declaredNot 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

Are you the operator? Claim this listing