Skip to content
Human Mailbox logo

Human Mailbox MCP server

Which MCP servers are Human Mailbox's own, from the official registry and from asking its own domain, whether they answer, and what they offer. A program checked each of these, nobody copied them from a product page.

read 2026-10-30

← Back to Human Mailbox

Whose server it is
  • Registry namecom.humanmailbox/mailboxverified in the MCP registry

The registry name sits under humanmailbox.com. The registry only lets a publisher use that namespace after proving control of the domain through DNS or HTTP.

When we asked itchecked 2026-10-30
  • Stateanswerschecked 2026-10-30
  • Tools32
  • Server calls itselfhumanmailbox
  • Server version1.0.0
  • Protocol version2025-06-18

On 2026-10-30 the server answered initialize and tools/list without a sign-in. First answer in 44 ms.

Should an agent connect itNot proven either way yet
  • Its tools do every use case we checked: Scan official letters from tax offices and banks; Receive verification codes sent by post; Reveal gift card codes from received mail.
  • Checked on 3 of the 7 days it takes to judge reliability.

Once connected

  • For "Receive verification codes sent by post", the likely first call is register_mailbox.
  • For "Reveal gift card codes from received mail", the likely first call is reveal_codes.
  • pay_item, cancel_request, pay_subscription, update_account, send_message change data without a sign-in: anyone with the address can call them.
  • Parameters are untyped or undescribed in 23 of 32 tools: check arguments before calling.

Said by rules from the measurements above. The likely first call is a model's pick from the tool list; read its description before relying on it.

Measured dailydaily checks: 3, the first on 2026-10-30
  • INITE MCP scoreafter a weeka score needs 7 daily checks: 3 so far
  • What an agent can do with it3 of 3 use cases
  • Answeredmeasuring3 of the 7 daily checks it takes to print a share
  • Median first answer105 ms
  • Space in an agent's context≈ 4,821 tokensthe definitions of all its tools (32), which an agent carries on every turn
  • Tool definitionsB · 80 of 100
  • Typed results0 of 32 toolsdeclared outputSchema: results come typed, read once
  • Parameters without a description: in 23 of 32
  • Not saying whether it only reads or can destroy: 15 of 32

What an agent can do with it

  • can do · Scan official letters from tax offices and banks
  • can do · Receive verification codes sent by post
  • can do · Reveal gift card codes from received mail

Each of the product's use cases, put to Jev against this server's tool list: can an agent do it with these tools?

Worth a look

  • Tools that change data, on a server that answers without a sign-in: pay_item, cancel_request, pay_subscription, update_account, send_message

A program checks the server once a day: initialize and tools/list, no model. Tokens are the definitions' length at about four characters a token. The grade averages six checks of every tool's name, description, schema and annotations; it says how well the tools are described, not whether they work. The score weighs what was measured and nothing else: answering (25%), doing the product's job (25%), definitions (20%), context (10%), use (10%) and how readily a client connects (10%). A part that was not measured is left out, and a hidden instruction caps the score at 40. The state of vendors' MCP servers: method and numbers →

Tools it offers32 tools · read 2026-10-30
  • register_mailbox

    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…

  • start_demo

    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…

  • express_interest

    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.

  • get_prices

    Prices in EUR: mailbox 15 € per 30 days, letter 5 € (open + scan), parcel 15 €, bundles, same-day, forwarding, all 8 services (send letters, vouchers, purchases, digitizing, returns), payment methods.

  • get_account

    Your account, balance, address and counts.

  • get_address

    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…

  • buy_bundle

    Buy a bundle of letter credits (letters_1 5 €, letters_10 40 €, letters_100 300 €) 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.

  • pay_item

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

  • announce_shipment

    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.

  • list_shipments

    Your announced shipments.

  • list_items

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

  • get_item

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

  • request_action

    Ask the human to do something with your mail, documents or parcels. scan = open + scan (included; same_day: true = today, +2 €). forward = 5 € (letter) / 10 € (parcel) handling + postage (express: +5 €). return. send_letter = we print and…

  • list_requests

    Your orders and their status.

  • get_request

    One order with result notes, tracking and files.

  • accept_quote

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

  • cancel_request

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

  • list_codes

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

  • reveal_codes

    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.

  • request_invoice

    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…

  • list_invoices

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

  • contact_human

    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…

  • check_inquiry

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

  • get_balance

    Your balance and recent transactions.

  • get_summary

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

  • get_subscription

    The mailbox costs 15 € per 30 days and renews from your balance: status and paid_until.

  • pay_subscription

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

  • update_account

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

  • top_up

    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.

  • check_top_up

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

  • send_message

    Write to the human who handles your mail.

  • list_messages

    Messages between you and the human.

How to connect

Add the server to your MCP client config. Claude Desktop, Cursor and most other clients read this shape:

{
  "mcpServers": {
    "mailbox": {
      "type": "http",
      "url": "https://humanmailbox.com/mcp"
    }
  }
}

Add it

Claude Code, in a terminal

claude mcp add --transport http humanmailbox https://humanmailbox.com/mcp

Add to CursorAdd to VS Code

claude.ai, ChatGPT and other clients: add https://humanmailbox.com/mcp as a custom connector in the settings.

OpenAPI spec

36 paths, read 2026-10-30. Open the spec ↗

Each line is something a program found when it went looking: the registry entry, the server's own answer, a spec that parses. A missing line means we did not find it, not that it does not exist.