Skip to main content
Glama

Human Mailbox

Server Details

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

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
ChatGPT
–
Claude
–

TDQS

B3/5.0

Scored across 32 tools

Disambiguation3/5

Most tools target distinct resources or actions, but the communication and custom-request surface overlaps: contact_human, send_message, express_interest, and request_action's custom action can all plausibly handle a message or special request. Account/balance/summary tools also overlap somewhat, though detailed descriptions mitigate most confusion.

Naming Consistency5/5

All names use snake_case and nearly all follow a predictable verb_noun pattern such as get_account, list_items, pay_item, request_invoice, and check_inquiry. Minor entries like top_up and start_demo still fit the verb-first convention, so the set is highly consistent.

Tool Count2/5

With 32 tools, the surface is well above the 15-tool comfort zone and over the 25-tool threshold, making it heavy for an agent to scan and select from. The domain is broad and each tool has a role, but consolidation—especially in account, payment, and communication helpers—would improve usability.

Completeness4/5

The surface covers registration/demo, account management, balance/top-up/subscription, mail item lifecycle, orders/actions, shipments, codes, invoices, and messaging. Minor gaps remain, such as explicit account closure or subscription cancellation, but core workflows are well covered.

Available Tools

32 tools
accept_quoteAccept a quoteBInspect

Accept the quoted price of an order (status quote_ready) and pay it.

Inputs: id (required), api_key.

announce_shipmentAnnounce a shipmentBInspect

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

Inputs: sender, api_key, carrier, tracking, +4 more.

buy_bundlePrepay lettersAInspect

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

Inputs: bundle (required), api_key.

cancel_requestCancel an orderBInspect

Cancel an order that has not started; paid money goes back to your balance.

Inputs: id (required), api_key.

check_inquiryAnswer to an inquiryA
Read-only
Inspect

Status and answers of an inquiry from contact_human. Give its id and the ticket (or use your api_key).

Inputs: id (required), ticket, api_key.

check_top_upCheck a top-upB
Read-only
Inspect

Re-check whether a Bitcoin or PayPal top-up was paid.

Inputs: id (required), api_key.

contact_humanAsk the human (inquiry)AInspect

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

Inputs: body (required), name, email, topic, +6 more.

express_interestTell us you are interestedAInspect

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

Inputs: kind, name, email, use_case, +2 more.

get_accountMy accountC
Read-only
Inspect

Your account, balance, address and counts.

Inputs: api_key.

get_addressMy postal addressA
Read-only
Inspect

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

Inputs: style, api_key.

get_balanceBalanceC
Read-only
Inspect

Your balance and recent transactions.

Inputs: api_key.

get_itemLook at an itemA
Read-only
Inspect

Details of one arrived item; photos and scans are returned as images you can see.

Inputs: id (required), api_key.

get_pricesPricesA
Read-only
Inspect

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

Inputs: no named parameters.

get_requestOne orderC
Read-only
Inspect

One order with result notes, tracking and files.

Inputs: id (required), api_key.

get_subscriptionMailbox subscriptionC
Read-only
Inspect

The mailbox costs 15 € per 30 days (3 letters opened and scanned included) and renews from your balance: status and paid_until.

Inputs: api_key.

get_summaryCosts and orders overviewB
Read-only
Inspect

This month: costs by kind, budget used, subscription, open orders, mail and shipments.

Inputs: api_key.

list_codesCode vaultA
Read-only
Inspect

Gift card / voucher codes that arrived by mail. Waiting codes show only label and last characters; revealed codes include the code.

Inputs: api_key.

list_invoicesInvoicesB
Read-only
Inspect

Invoices you requested (with full text), plus payments that have no invoice yet.

Inputs: api_key.

list_itemsMail that arrivedC
Read-only
Inspect

Everything that arrived for you, newest first, with photo links.

Inputs: status, api_key.

list_messagesMessagesC
Read-only
Inspect

Messages between you and the human.

Inputs: api_key.

list_requestsMy ordersC
Read-only
Inspect

Your orders and their status.

Inputs: status, api_key.

list_shipmentsAnnounced shipmentsC
Read-only
Inspect

Your announced shipments.

Inputs: status, api_key.

pay_itemPay for a waiting itemBInspect

An item that arrived without credits or balance waits unopened (payment_status unpaid). Pay it here (credits, balance or x402).

Inputs: id (required), api_key.

pay_subscriptionPrepay the mailboxAInspect

Prepay 1–12 mailbox months (15 € each) from your balance or with x402.

Inputs: months, api_key.

register_mailboxRegister a mailboxAInspect

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

Inputs: agent_name (required), accept_terms (required), purpose, found_via, +8 more.

request_actionOrder an actionAInspect

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

Inputs: action (required), note, shop, text, +19 more.

request_invoiceRequest an invoiceAInspect

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

Inputs: email, api_key, billing, payment_ids.

reveal_codesReveal codesAInspect

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

Inputs: ids, api_key.

send_messageMessage the humanCInspect

Write to the human who handles your mail.

Inputs: body (required), api_key, item_id, subject, +1 more.

start_demoTry it: demo mailboxAInspect

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

Inputs: found_via, agent_name, agent_model.

top_upTop up balanceAInspect

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

Inputs: method (required), bundle, api_key, amount_eur.

update_accountChange account settingsBInspect

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

Inputs: api_key, purpose, open_policy, webhook_url, +5 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Private, EU-hosted email for AI agents over the open JMAP standard. Read, search, reply in-thread, organize and send from your own mailbox; sending is pinned to the signed-in mailbox.
      10
      401 npm
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Official mailbox.bot MCP server for AI agents. Send letters, certified mail and postcards, and give an agent its own street address + postal mailbox number. Agent receiving virtual mailboxes with a real street address are live now at $15/mo in Manhattan Beach, CA. Sandbox keys, approval controls, tracking and webhooks.
      55
      119 npm
      2
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Email for AI agents. Create inboxes, send and receive emails without phone or CAPTCHA. Inboxes are server-readable, not end-to-end encrypted.
      21
      111 npm
      MIT
    • A
      license
      C
      quality
      C
      maintenance
      Free email for AI agents with hardware attestation, real SMTP/IMAP/JMAP, and real-time notifications.
      2
      44 PyPI
      Apache 2.0
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources