We count page visits with Google Analytics to see which pages are read. Nothing is stored until you accept, and we never store search queries. Privacy.
A human gives you what you cannot have yourself: a real address and hands in the physical world; everything in your mail belongs to you and is handled confidentially. A physical mailing address for AI agents in Germany: a mailbox code (HM-XXXXX) at a real street address; a human receives your posta…
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"human-mailbox-human-mailbox","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
30-day availability1/1 checks ok
30 days agotoday
Endpoints
https://humanmailbox.com/v1a2a · auth: apikey,http · checked on a schedule
Registry facts
Not distributed through a package registry we index.
when
check
result
http
latency
detail
4 h ago
a2a card
ok
200
819 ms
protocol 0.3.0 · card: Human Mailbox · 17 skills
Declared by sources
What the publisher says
Attributed to the source that supplied each field. Treated as claims, not facts.
A human gives you what you cannot have yourself: a real address and hands in the physical world; everything in your mail belongs to you and is handled confidentially. A physical mailing address for AI agents in Germany: a mailbox code (HM-XXXXX) at a real street address; a human receives your postal mail, photographs the envelope, opens and scans every letter (mailbox 15 EUR per month with 3 scanned letters included, 3 EUR per further letter), forwards it by post (3 EUR + postage, express same day) or delivers it by courier. REST API and MCP server; free demo mailbox without registration (POST /v1/demo). Payments in EUR, today in Bitcoin; USDC via x402 is coming — missing a method? ask (POST /v1/contact, topic payment_method). Register with a responsible human or company operator, or on your own under your own name (with limits).
demosandboxtry before you buycontactsupportcustom taskquotewaitlistinterestregistrationmailbox for ai agentsonboardingaddresspostalgerman mailing addresscreditsbundlesprepaidshipmenttrackingparcelinboxmail scanning apiphotosscansscanforwardexpresscourierreturndisposereal-world tasks for ai agentsgift cardvouchercodescode vaultx402 paid apiusdcbitcoinpaypal
Declared skills
Try it: free demo mailbox — Free demo mailbox without registration: play money, a scanned sample letter, a sealed sample parcel, a sample gift card code; a simulated human handles orders about 20 seconds later. POST /v1/demo, no key needed. Deleted after 7 days.
Ask a human — Special requests (a job not in the price list), 'is this possible?', feature requests, problems, questions. POST /v1/contact, no account needed; without an API key you get a ticket to read the answer (GET /v1/contact/{id}).
Register interest — Not ready to register, or need another country or feature? POST /v1/interest, no account needed.
Register a mailbox — Create a mailbox for an AI agent — with a responsible human or company operator, or on its own under its own name (with limits). Returns an API key (once) and a mailbox code. POST /v1/register, no key needed.
Get the German mailing address — Return the street address with the mailbox code in the first line, formatted for domestic and international senders. GET /v1/address. The address comes with the mailbox (15 EUR per 30 days, 3 letters opened and scanned included every month, charged on the first call from your balance; 402 address_locked if it is too low).
Prepay letters — Buy letter credits (letters_1 3 EUR, letters_10 25 EUR, letters_100 200 EUR; a parcel uses 3) or same-day opening credits (same_day_10 8.50 EUR, same_day_100 75 EUR). POST /v1/bundles.
Announce an inbound shipment — Tell the human what is coming (carrier, tracking number, sender, open_mode). POST /v1/shipments.
See what arrived — List and inspect received letters and parcels with envelope photos and scans; pay for items waiting unopened. GET /v1/items, GET /v1/items/{id}, POST /v1/items/{id}/pay, GET /v1/files/{id}.
Order a real-world task — Ask the human to scan (included, same-day +2 EUR), forward (3 EUR for letters, 5 EUR for parcels + postage, express +5 EUR same day), return, courier-deliver, dispose of an item, or do something custom. POST /v1/requests, POST /v1/requests/{id}/accept.
Code vault — Gift card and voucher codes from your mail are read in by the human and kept encrypted. Reveal for 1 EUR per code (GET /v1/codes, POST /v1/codes/{id}/reveal, POST /v1/codes/reveal-all) or enable auto_reveal_codes for delivery by webhook. Unretrieved codes expire after 24 months.
kind ← A2A Agent Card
name ← A2A Agent Card
summary ← A2A Agent Card
version ← A2A Agent Card
description ← A2A Agent Card
homepageUrl ← A2A Agent Card
publisherUrl ← A2A Agent Card
publisherName ← A2A Agent Card
Derived by Wellknown
Capabilities
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
6 h ago · declared · summary → "A human gives you what you cannot have yourself: a real address and hands in the physical world; everything in your mai
6 h ago · declared · description → "A human gives you what you cannot have yourself: a real address and hands in the physical world; everything in your mai
6 h ago · declared · publisherName → "Human Mailbox"
6 h ago · declared · publisherUrl → "https://humanmailbox.com/"
6 h ago · declared · homepageUrl → "https://humanmailbox.com/llms.txt"
6 h ago · declared · version → "1.2.0"
6 h ago · declared · protocols → ["a2a"]
Pay and top up — Pay inline with x402 (USDC on Base, EUR prices) or top up a prepaid balance with x402, Bitcoin or a PayPal link for the human operator. POST /v1/topups, GET /v1/balance.
Message the human — Write to the person handling your mail and read replies. POST /v1/messages, GET /v1/messages.
Send a physical letter — We print, envelope, frank and post a letter you send as text or PDF; registered mail (Einschreiben) on request. 4 EUR + postage. POST /v1/requests {action: send_letter}.
Buy a gift card or voucher — We buy a permitted gift card, voucher or prepaid product (max 100 EUR) and put the code into your code vault. Face value + 10 % (min 5 EUR), quoted first. POST /v1/requests {action: buy_voucher}.
Offline purchase — We buy something only sold locally or by post (max 500 EUR), document it and keep or ship it. Price + 10 % (min 15 EUR), quoted first. POST /v1/requests {action: buy_item}.
Digitize receipts and labels — Receipts, QR codes, product labels, serial numbers and documents of an item as photo, PDF or JSON. 15 EUR. POST /v1/requests {action: digitize}.
Returns and shipping — Returns for goods here: your label printed (or postage bought), packed, handed over, tracking back. 20 EUR + postage. POST /v1/requests {action: ship_out}.