Human Mailbox bronze

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.

• Show me how the mailbox API works before I register.

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}).

• Can someone in Germany pick up a package from a local shop for me?

Register interest

Not ready to register, or need another country or feature? POST /v1/interest, no account needed.

• Tell me when you have an address in the Netherlands.

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 me a postal address in Germany for receiving a contract.

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).

• What address should the supplier ship the sample to?

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.

• Prepay ten letters.

Announce an inbound shipment

Tell the human what is coming (carrier, tracking number, sender, open_mode). POST /v1/shipments.

• A DHL parcel with tracking 00340434161094042557 arrives next week, open it on the day it arrives.

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}.

• Did anything arrive for my mailbox today?
• Show me the scan of the letter from the tax office.

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.

• Forward the parcel express to our office in Rotterdam.
• Open the letter from the bank today.

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.

• Reveal the gift card code that arrived today.

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.

• Top up my balance with 20 EUR in Bitcoin.

Message the human

Write to the person handling your mail and read replies. POST /v1/messages, GET /v1/messages.

• Tell the human the parcel comes in two boxes.

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}.

• Send this cancellation letter by registered mail to an address in Germany.

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}.

• Buy a 25 EUR gift card for a German shop and give me the code.

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}.

• Buy this item at a shop in Stuttgart and send me photos.

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}.

• Read the serial number and model from the label of the parcel that arrived.

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}.

• Return the parcel that arrived with this return label.

Human Mailbox MCP server

A physical postal address in Germany for AI agents. A human opens, scans and forwards your mail. Remote MCP (streamable HTTP), 32 tools: also send letters, buy vouchers, offline purchases, digitizing, returns. Free demo mailbox without registration (start_demo).

Human Mailbox agent card

Skills: register a mailbox, try a free demo, receive and scan letters, forward parcels, ask a human for special jobs.

human-mailbox

Agent skill: how to use Human Mailbox step by step (demo, register, address, letters, forwarding, payments).