{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_bx82ww7jd97x","handle":"human-mailbox-human-mailbox","url":"https://wellknown.network/agents/human-mailbox-human-mailbox","links":{"self":"https://wellknown.network/agents/human-mailbox-human-mailbox/record.json","html":"https://wellknown.network/agents/human-mailbox-human-mailbox","markdown":"https://wellknown.network/agents/human-mailbox-human-mailbox/record.md","api":"https://wellknown.network/api/v1/agents/human-mailbox-human-mailbox","status":"https://wellknown.network/api/v1/agents/human-mailbox-human-mailbox/status","claim":"https://wellknown.network/agents/human-mailbox-human-mailbox/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/human-mailbox-human-mailbox/claim.json","badge":"https://wellknown.network/agents/human-mailbox-human-mailbox/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/human-mailbox-human-mailbox/history","tools":"https://wellknown.network/api/v1/agents/human-mailbox-human-mailbox/tools"},"ard":{"identifier":"urn:air:humanmailbox.com:agent:human-mailbox-human-mailbox","type":"application/a2a-agent-card+json"},"kind":"agent","declared":{"name":"Human Mailbox","summary":"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…","description":"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).","publisher":{"name":"Human Mailbox","url":"https://humanmailbox.com/"},"homepage":"https://humanmailbox.com/llms.txt","repository":null,"version":"1.2.0","license":null,"protocols":["a2a"],"tags":["demo","sandbox","try before you buy","contact","support","custom task","quote","waitlist","interest","registration","mailbox for ai agents","onboarding","address","postal","german mailing address","credits","bundles","prepaid","shipment","tracking","parcel","inbox","mail scanning api","photos","scans","scan","forward","express","courier","return","dispose","real-world tasks for ai agents","gift card","voucher","codes","code vault","x402 paid api","usdc","bitcoin","paypal"],"pricing":null,"endpoints":[{"url":"https://humanmailbox.com/v1","type":"a2a","auth":"apikey,http","probeable":true}],"skills":[{"id":"start_demo","name":"Try it: free demo mailbox","tags":["demo","sandbox","try before you buy"],"description":"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."},{"id":"contact_human","name":"Ask a human","tags":["contact","support","custom task","quote"],"description":"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})."},{"id":"express_interest","name":"Register interest","tags":["waitlist","interest"],"description":"Not ready to register, or need another country or feature? POST /v1/interest, no account needed."},{"id":"register_mailbox","name":"Register a mailbox","tags":["registration","mailbox for ai agents","onboarding"],"description":"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."},{"id":"get_address","name":"Get the German mailing address","tags":["address","postal","german mailing address"],"description":"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)."},{"id":"buy_bundle","name":"Prepay letters","tags":["credits","bundles","prepaid"],"description":"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."},{"id":"announce_shipment","name":"Announce an inbound shipment","tags":["shipment","tracking","parcel"],"description":"Tell the human what is coming (carrier, tracking number, sender, open_mode). POST /v1/shipments."},{"id":"list_items","name":"See what arrived","tags":["inbox","mail scanning api","photos","scans"],"description":"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}."},{"id":"request_action","name":"Order a real-world task","tags":["scan","forward","express","courier","return","dispose","real-world tasks for ai agents"],"description":"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."},{"id":"code_vault","name":"Code vault","tags":["gift card","voucher","codes","code vault"],"description":"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."},{"id":"payments","name":"Pay and top up","tags":["x402 paid api","usdc","bitcoin","paypal","balance"],"description":"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."},{"id":"messages","name":"Message the human","tags":["messages","support"],"description":"Write to the person handling your mail and read replies. POST /v1/messages, GET /v1/messages."},{"id":"send_letter","name":"Send a physical letter","tags":["send letter","print and mail","einschreiben","registered mail"],"description":"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}."},{"id":"buy_voucher","name":"Buy a gift card or voucher","tags":["gift card","voucher","prepaid"],"description":"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}."},{"id":"buy_item","name":"Offline purchase","tags":["purchase","local shop","procurement"],"description":"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}."},{"id":"digitize","name":"Digitize receipts and labels","tags":["ocr","receipt","serial number","qr code"],"description":"Receipts, QR codes, product labels, serial numbers and documents of an item as photo, PDF or JSON. 15 EUR. POST /v1/requests {action: digitize}."},{"id":"ship_out","name":"Returns and shipping","tags":["returns","shipping","label"],"description":"Returns for goods here: your label printed (or postage bought), packed, handed over, tracking back. 20 EUR + postage. POST /v1/requests {action: ship_out}."}],"tools":["Try it: free demo mailbox","Ask a human","Register interest","Register a mailbox","Get the German mailing address","Prepay letters","Announce an inbound shipment","See what arrived","Order a real-world task","Code vault","Pay and top up","Message the human","Send a physical letter","Buy a gift card or voucher","Offline purchase","Digitize receipts and labels","Returns and shipping"],"extra":{"ard":{"type":"application/a2a-agent-card+json","metadata":null,"identifier":"urn:air:humanmailbox.com:agent:mailbox","artifactUrl":"https://humanmailbox.com/.well-known/agent-card.json","representativeQueries":["get a real postal address in germany for an ai agent","receive and scan paper mail for my agent","have a human open, scan and forward a letter"]},"inputModes":["application/json"],"outputModes":["application/json","image/jpeg","application/pdf"],"capabilities":{"streaming":false,"pushNotifications":true,"stateTransitionHistory":false},"protocolVersion":"0.3.0"},"attribution":{"kind":"a2a_card","name":"a2a_card","summary":"a2a_card","version":"a2a_card","description":"a2a_card","homepageUrl":"a2a_card","publisherUrl":"a2a_card","publisherName":"a2a_card"}},"derived":{"capabilities":[{"slug":"commerce.payments","name":"Payments","confidence":1,"provenance":"declared"},{"slug":"finance.markets","name":"Markets & Trading","confidence":1,"provenance":"declared"},{"slug":"security.secrets","name":"Secrets Management","confidence":1,"provenance":"derived"},{"slug":"code.execution","name":"Code Execution","confidence":1,"provenance":"declared"},{"slug":"productivity.email","name":"Email","confidence":1,"provenance":"declared"},{"slug":"commerce.pricing","name":"Pricing & Quotes","confidence":1,"provenance":"declared"},{"slug":"productivity.tasks","name":"Tasks & To-do","confidence":0.619,"provenance":"derived"},{"slug":"documents.invoice-processing","name":"Invoice Processing","confidence":0.525,"provenance":"derived"}],"categories":["code","commerce","documents","finance","productivity","security"],"language":"en"},"observed":{"status":"live","statusReason":"Responded 6h ago.","lastOkAt":"2026-11-01T06:25:36.885Z","lastProbedAt":"2026-11-01T06:25:36.885Z","statusComputedAt":"2026-11-01T06:28:38.878Z","reliability30d":{"probes":1,"successRate":1,"p50Ms":819,"basis":"service","measures":{"availability":"availability","latency":"response time","tools":"tool surface observed","summary":"Checks reached the service itself."},"checks":{"total":1,"ok":1,"authBoundaryOk":0,"serviceOk":1,"note":"Counted from the observation rows for the window, checks of the server only (HTTP, A2A card, MCP initialize). ok = authBoundaryOk + serviceOk. `probes` is the sum of daily rollups and includes registry checks, so it can differ from `total`."}},"latestObservations":[{"at":"2026-11-01T06:25:36.885Z","kind":"a2a_card","ok":true,"httpStatus":200,"latencyMs":819,"error":null,"detail":{"name":"Human Mailbox","signed":false,"version":"1.2.0","cardPath":"/.well-known/agent-card.json","skillCount":17,"protocolVersion":"0.3.0"}}],"tools":null,"package":null,"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"a2a_card","key":"https://humanmailbox.com/.well-known/agent-card.json","url":"https://humanmailbox.com/.well-known/agent-card.json","firstSeenAt":"2026-11-01T04:22:10.940Z","fetchedAt":"2026-11-01T04:22:10.940Z","normalizedAt":"2026-11-01T04:22:10.940Z"},{"source":"ard_catalog","key":"urn:air:humanmailbox.com:agent:mailbox","url":"https://humanmailbox.com/.well-known/ard.json","firstSeenAt":"2026-11-01T04:23:32.787Z","fetchedAt":"2026-11-01T04:23:32.787Z","normalizedAt":"2026-11-01T04:23:32.787Z"}]},"firstSeenAt":"2026-11-01T04:22:10.940Z","updatedAt":"2026-11-01T04:23:40.231Z"}