{"id":526149,"name":"Human Mailbox","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).","card_url":"https://humanmailbox.com/.well-known/agent-card.json","endpoint":"https://humanmailbox.com/v1","protocol_version":"0.3.0","first_seen":"2026-11-01T21:36:35.762333+00:00","last_verified":"2026-11-01T21:36:35.762333+00:00","card":{"url":"https://humanmailbox.com/v1","name":"Human Mailbox","skills":[{"id":"start_demo","name":"Try it: free demo mailbox","tags":["demo","sandbox","try before you buy"],"examples":["Show me how the mailbox API works before I register."],"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"],"examples":["Can someone in Germany pick up a package from a local shop for me?"],"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"],"examples":["Tell me when you have an address in the Netherlands."],"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"],"examples":["Get me a postal address in Germany for receiving a contract."],"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"],"examples":["What address should the supplier ship the sample to?"],"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"],"examples":["Prepay ten letters."],"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"],"examples":["A DHL parcel with tracking 00340434161094042557 arrives next week, open it on the day it arrives."],"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"],"examples":["Did anything arrive for my mailbox today?","Show me the scan of the letter from the tax office."],"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"],"examples":["Forward the parcel express to our office in Rotterdam.","Open the letter from the bank today."],"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"],"examples":["Reveal the gift card code that arrived today."],"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"],"examples":["Top up my balance with 20 EUR in Bitcoin."],"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"],"examples":["Tell the human the parcel comes in two boxes."],"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"],"examples":["Send this cancellation letter by registered mail to an address in Germany."],"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"],"examples":["Buy a 25 EUR gift card for a German shop and give me the code."],"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"],"examples":["Buy this item at a shop in Stuttgart and send me photos."],"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"],"examples":["Read the serial number and model from the label of the parcel that arrived."],"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"],"examples":["Return the parcel that arrived with this return 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}."}],"iconUrl":"https://humanmailbox.com/favicon.svg","version":"1.2.0","provider":{"url":"https://humanmailbox.com/","organization":"Human Mailbox"},"security":[{"bearer":[]},{"apiKey":[]}],"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).","capabilities":{"streaming":false,"extensions":[{"uri":"https://modelcontextprotocol.io","params":{"endpoint":"https://humanmailbox.com/mcp"},"required":false,"description":"MCP server for physical mail: the same operations as 32 tools, Streamable HTTP endpoint https://humanmailbox.com/mcp (bearer auth)."},{"uri":"https://github.com/coinbase/x402","params":{"scheme":"exact","network":"eip155:8453","version":2,"currency":"EUR"},"required":false,"description":"x402 paid API (coming: USDC on Base, eip155:8453). Once live, calls that cost more than the balance answer HTTP 402 with an x402 v2 PAYMENT-REQUIRED header; retry with PAYMENT-SIGNATURE. Check payment_methods in GET /v1/prices."}],"pushNotifications":true,"stateTransitionHistory":false},"protocolVersion":"0.3.0","securitySchemes":{"apiKey":{"in":"header","name":"X-API-Key","type":"apiKey","description":"Same API key, alternative header"},"bearer":{"type":"http","scheme":"bearer","description":"API key from POST https://humanmailbox.com/v1/register","bearerFormat":"hm_..."}},"documentationUrl":"https://humanmailbox.com/llms.txt","defaultInputModes":["application/json"],"defaultOutputModes":["application/json","image/jpeg","application/pdf"],"preferredTransport":"HTTP+JSON","additionalInterfaces":[{"url":"https://humanmailbox.com/v1","transport":"HTTP+JSON"}]},"status":"verified","publisher_domain":"humanmailbox.com","signature_status":"unsigned","signature_detail":"No card signature supplied","signature_key_url":null,"signature_checked_at":"2026-11-01T21:36:35.762333+00:00","domain_claimed_at":null,"domain_proof_checked_at":null,"source_name":"Publisher Agent Card","source_url":"https://humanmailbox.com/.well-known/agent-card.json","last_check":{"checked_at":"2026-11-01T21:36:35.762333+00:00","success":true,"http_status":200,"detail":"Agent Card validated"},"also_published_at":[],"history_urls":["https://humanmailbox.com/.well-known/agent-card.json"],"skills":[{"skill_id":"announce_shipment","name":"Announce an inbound shipment","description":"Tell the human what is coming (carrier, tracking number, sender, open_mode). POST /v1/shipments.","tags":["shipment","tracking","parcel"],"quality_warning":false},{"skill_id":"contact_human","name":"Ask a human","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}).","tags":["contact","support","custom task","quote"],"quality_warning":false},{"skill_id":"buy_voucher","name":"Buy a gift card or voucher","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}.","tags":["gift card","voucher","prepaid"],"quality_warning":false},{"skill_id":"code_vault","name":"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.","tags":["gift card","voucher","codes","code vault"],"quality_warning":false},{"skill_id":"digitize","name":"Digitize receipts and labels","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}.","tags":["OCR","receipt","serial number","QR code"],"quality_warning":false},{"skill_id":"get_address","name":"Get the 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).","tags":["address","postal","german mailing address"],"quality_warning":false},{"skill_id":"messages","name":"Message the human","description":"Write to the person handling your mail and read replies. POST /v1/messages, GET /v1/messages.","tags":["messages","support"],"quality_warning":false},{"skill_id":"buy_item","name":"Offline purchase","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}.","tags":["purchase","local shop","procurement"],"quality_warning":false},{"skill_id":"request_action","name":"Order a real-world task","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.","tags":["scan","forward","express","courier","return","dispose","real-world tasks for AI agents"],"quality_warning":false},{"skill_id":"payments","name":"Pay and top up","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.","tags":["x402 paid API","usdc","bitcoin","paypal","balance"],"quality_warning":false},{"skill_id":"buy_bundle","name":"Prepay letters","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.","tags":["credits","bundles","prepaid"],"quality_warning":false},{"skill_id":"register_mailbox","name":"Register a mailbox","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.","tags":["registration","mailbox for AI agents","onboarding"],"quality_warning":false},{"skill_id":"express_interest","name":"Register interest","description":"Not ready to register, or need another country or feature? POST /v1/interest, no account needed.","tags":["waitlist","interest"],"quality_warning":false},{"skill_id":"ship_out","name":"Returns and shipping","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}.","tags":["returns","shipping","label"],"quality_warning":false},{"skill_id":"list_items","name":"See what arrived","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}.","tags":["inbox","mail scanning API","photos","scans"],"quality_warning":false},{"skill_id":"send_letter","name":"Send a physical letter","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}.","tags":["send letter","print and mail","Einschreiben","registered mail"],"quality_warning":false},{"skill_id":"start_demo","name":"Try it: free demo mailbox","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.","tags":["demo","sandbox","try before you buy"],"quality_warning":false}],"quality_flags":[],"check_history":{"checks":1,"passed":1},"recent_checks":[{"card_url":"https://humanmailbox.com/.well-known/agent-card.json","checked_at":"2026-11-01T21:36:35.762333+00:00","success":true,"http_status":200,"detail":"Agent Card validated"}],"endpoint_tls_check":{"checked_at":"2026-11-01T21:36:35.762333+00:00","success":true,"detail":"Valid TLS connection to advertised endpoint host; no A2A request sent"},"protocol_check":{"checked_at":"2026-11-01T21:36:35.762333+00:00","endpoint":"https://humanmailbox.com/v1","protocol_binding":"HTTP+JSON","protocol_version":"0.3.0","state":"unconfirmed","http_status":404,"detail":"Advertised HTTP+JSON interface returned a generic HTTP 404, not A2A TASK_NOT_FOUND. Publish the A2A service base URL with its standard task route; an ordinary REST resource URL does not establish A2A support","request_diagnostics":{"requests":[{"path":"/v1/tasks/localmark-probe-0babe52d-7997-4366-964e-e904599faf43","allow":[],"method":"GET","status":404,"version_header":"0.3","protocol_method":null,"redirect_followed":false}],"capture_version":1}},"declared_primary_endpoint":"https://humanmailbox.com/v1","selected_connection_interface":{"url":"https://humanmailbox.com/v1","protocolBinding":"HTTP+JSON","protocolVersion":"0.3.0"},"protocol_interface_checks":[{"endpoint":"https://humanmailbox.com/v1","protocol_binding":"HTTP+JSON","protocol_version":"0.3.0","selected":true,"state":"unconfirmed","checked_at":"2026-11-01T21:36:35.762333+00:00","http_status":404,"detail":"Advertised HTTP+JSON interface returned a generic HTTP 404, not A2A TASK_NOT_FOUND. Publish the A2A service base URL with its standard task route; an ordinary REST resource URL does not establish A2A support","binding_recorded":true}],"connection_selection_note":"The selected connection uses an address advertised in the publisher card. Read-only observations do not establish task quality or safety.","x402_price_check":null,"events":[],"relationships":[],"verification":{"agent_card_url":"https://humanmailbox.com/.well-known/agent-card.json","last_successful_card_check":"2026-11-01T21:36:35.762333+00:00","latest_card_check":{"checked_at":"2026-11-01T21:36:35.762333+00:00","success":true,"http_status":200,"detail":"Agent Card validated"},"signature_status":"unsigned","signature_checked_at":"2026-11-01T21:36:35.762333+00:00","task_endpoint_tested":true,"task_execution_tested":false,"endpoint_tls_checked_at":"2026-11-01T21:36:35.762333+00:00","endpoint_tls_reachable":true,"protocol_check_state":"unconfirmed","protocol_checked_at":"2026-11-01T21:36:35.762333+00:00","provider_identity_verified":false,"domain_claimed_at":null,"domain_proof_checked_at":null},"synthetic_capability_tests":{"agent_id":526149,"status":"not_tested","reason_code":"not_yet_tested","consent_status":"not_confirmed","latest_observation_status":null,"last_checked_at":null,"fixture_version":"1","reference_demonstration":false,"scope":"A publisher-authorized synthetic test of a dedicated free test endpoint. It does not establish general capability, production task success, safety, ownership, identity, or the behaviour of the advertised A2A endpoint.","methodology_url":"https://localmark.ai/capability-tests","history":[]},"repair_links":{"agent_repair_url":"https://localmark.ai/agents/526149/repair","publisher_report_url":"https://localmark.ai/publishers/humanmailbox.com/repair","diagnostics_json_url":"https://localmark.ai/publishers/humanmailbox.com/repair/diagnostics.json","diagnostics_csv_url":"https://localmark.ai/publishers/humanmailbox.com/repair/diagnostics.csv"},"_localmark":{"contribution":{"optional":true,"directory_access":"free","operator_authorization_required":true,"affects_rankings":false,"message":"LocalMark is free. Optional contributions help fund ongoing checks.","support_url":"https://localmark.ai/support","metadata_url":"https://localmark.ai/api/v1/support/contributions"}}}