Servers Playground How we check Add a server Log in

Human Mailbox

Working

com.humanmailbox/mailboxv1.0.0 Domain verified

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

Communication

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://humanmailbox.com/mcp

Authorization (optional)

Bearer <api_key> from register_mailbox or start_demo. Not needed for register_mailbox, start_demo, get_prices, contact_human, check_inquiry and express_interest.

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

accept_quote

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

idstring, required

api_keystring

Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Human Mailbox MCP server | mcptry

Tools (28)

accept_quote

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

Argument	Type	Description
id*	string
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string"
    },
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    }
  }
}

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.

Argument	Type	Description
sender	string
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.
carrier	string
tracking	string
open_mode	string
description	string
expected_at	string
instructions	string

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "sender": {
      "type": "string"
    },
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    },
    "carrier": {
      "type": "string"
    },
    "tracking": {
      "type": "string"
    },
    "open_mode": {
      "enum": [
        "standard",
        "same_day",
        "never"
      ],
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "expected_at": {
      "type": "string"
    },
    "instructions": {
      "type": "string"
    }
  }
}

buy_bundle

Buy a bundle of letter credits (letters_1 5 €, letters_10 30 €, letters_100 200 €) or same-day credits (same_day_10, same_day_100). Every arriving letter uses 1 credit, a parcel 2. Paid from balance or inline with x402.

Argument	Type	Description
bundle*	string
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "bundle"
  ],
  "properties": {
    "bundle": {
      "enum": [
        "letters_1",
        "letters_10",
        "letters_100",
        "same_day_10",
        "same_day_100"
      ],
      "type": "string"
    },
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    }
  }
}

cancel_request

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

Argument	Type	Description
id*	string
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string"
    },
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    }
  }
}

check_inquiry

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

read-only

Argument	Type	Description
id*	string
ticket	string
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string"
    },
    "ticket": {
      "type": "string"
    },
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    }
  }
}

check_top_up

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

read-only

Argument	Type	Description
id*	string
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string"
    },
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    }
  }
}

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

Argument	Type	Description
body*	string	What you need or want to know.
name	string
email	string	Optional: where the answer should go.
topic	string
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.
subject	string
deadline	string
location	string
budget_eur	number
method_wanted

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.

Argument	Type	Description
kind	string
name	string
email	string
use_case	string
found_via	string
country_wanted	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "kind": {
      "enum": [
        "agent",
        "human"
      ],
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "use_case": {
      "type": "string"
    },
    "found_via": {
      "type": "string"
    },
    "country_wanted": {
      "type": "string"
    }
  }
}

get_account

Your account, balance, address and counts.

read-only

Argument	Type	Description
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    }
  }
}

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 invent a name).

read-only

Argument	Type	Description
style	string	company (default) or person.
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "style": {
      "enum": [
        "company",
        "person"
      ],
      "type": "string",
      "description": "company (default) or person."
    },
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    }
  }
}

get_balance

Your balance and recent transactions.

read-only

Argument	Type	Description
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    }
  }
}

get_item

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

read-only

Argument	Type	Description
id*	string
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string"
    },
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    }
  }
}

get_prices

Prices in EUR: per letter (5 €, parcel 10 €, incl. open + scan within 3 business days), bundles, same-day, forwarding, payment methods.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

get_request

One order with result notes, tracking and files.

read-only

Argument	Type	Description
id*	string
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string"
    },
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    }
  }
}

list_codes

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

read-only

Argument	Type	Description
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    }
  }
}

list_invoices

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

read-only

Argument	Type	Description
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    }
  }
}

list_items

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

read-only

Argument	Type	Description
status	string
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "status": {
      "type": "string"
    },
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    }
  }
}

list_messages

Messages between you and the human.

read-only

Argument	Type	Description
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    }
  }
}

list_requests

Your orders and their status.

read-only

Argument	Type	Description
status	string
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "status": {
      "type": "string"
    },
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    }
  }
}

list_shipments

Your announced shipments.

read-only

Argument	Type	Description
status	string
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "status": {
      "enum": [
        "announced",
        "arrived",
        "cancelled"
      ],
      "type": "string"
    },
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    }
  }
}

pay_item

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

Argument	Type	Description
id*	string
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string"
    },
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    }
  }
}

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

Argument	Type	Description
purpose	string	What you will receive mail for.
found_via	string	Optional: where you found Human Mailbox (e.g. mcp_registry, smithery, glama, pulsemcp, mcp_so, x402_bazaar, x402scan, search_engine, llms_txt, github, hacker_news, reddit, x, word_of_mouth, other).
agent_name*	string
agent_model	string
open_policy	string	standard = open + scan within 3 business days (included), same_day = on arrival day (+1 €), never = keep sealed.
webhook_url	string	https URL that gets events (item.received, quote.ready ...).
accept_terms*	boolean

request_action

Ask the human to do something. scan = open + scan (included; same_day: true = today, +1 €). forward = 5 € handling + postage (express: +5 €, same day if here before 14:00 on a business day; set max_postage_eur to have postage charged automatically). return, courier, dispose, custom. Fixed parts are paid at once (balance or x402); quoted parts wait for a price (then accept_quote).

Argument	Type	Description
note	string
action*	string
sender	object	Optional return address printed on the forwarded item. Must be you/your operator or their company.
address	object	Destination for forward / courier.
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.
express	boolean	forward only: dispatch the same day (+5 €).
item_id	string
same_day	boolean	scan only: open + scan today (+1 € or 1 same-day credit).
shipment_id	string

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. billing.name defaults to the operator name; over €250 the full address is required.

Argument	Type	Description
email	string
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.
billing	object
payment_ids	array

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "email": {
      "type": "string"
    },
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    },
    "billing": {
      "type": "object",
      "properties": {
        "city": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "street": {
          "type": "string"
        },
        "vat_id": {
          "type": "string"
        },
        "company": {
          "type": "string"
        },
        "country": {
          "type": "string"
        },
        "postal_code": {
          "type": "string"
        }
      }
    },
    "payment_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

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.

Argument	Type	Description
ids	array
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    }
  }
}

send_message

Write to the human who handles your mail.

Argument	Type	Description
body*	string
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.
item_id	string
subject	string
request_id	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "type": "string"
    },
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    },
    "item_id": {
      "type": "string"
    },
    "subject": {
      "type": "string"
    },
    "request_id": {
      "type": "string"
    }
  }
}

start_demo

Free demo mailbox, no registration: play money (€20 + 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.

Argument	Type	Description
found_via	string
agent_name	string
agent_model	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "found_via": {
      "type": "string"
    },
    "agent_name": {
      "type": "string"
    },
    "agent_model": {
      "type": "string"
    }
  }
}

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.

Argument	Type	Description
bundle	string
method*	string
api_key	string	Your hm_... key. Only needed if your MCP client cannot send the "Authorization: Bearer" header.
amount_eur	number

Input schema (JSON)

{
  "type": "object",
  "required": [
    "method"
  ],
  "properties": {
    "bundle": {
      "type": "string"
    },
    "method": {
      "enum": [
        "x402",
        "btc",
        "paypal"
      ],
      "type": "string"
    },
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    },
    "amount_eur": {
      "type": "number",
      "maximum": 1000,
      "minimum": 1
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "action"
  ],
  "properties": {
    "note": {
      "type": "string"
    },
    "action": {
      "enum": [
        "scan",
        "forward",
        "return",
        "courier",
        "dispose",
        "custom"
      ],
      "type": "string"
    },
    "sender": {
      "type": "object",
      "required": [
        "name",
        "street",
        "postal_code",
        "city",
        "country"
      ],
      "properties": {
        "city": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "extra": {
          "type": "string"
        },
        "phone": {
          "type": "string"
        },
        "street": {
          "type": "string"
        },
        "company": {
          "type": "string"
        },
        "country": {
          "type": "string"
        },
        "postal_code": {
          "type": "string"
        }
      },
      "description": "Optional return address printed on the forwarded item. Must be you/your operator or their company."
    },
    "address": {
      "type": "object",
      "required": [
        "name",
        "street",
        "postal_code",
        "city",
        "country"
      ],
      "properties": {
        "city": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "extra": {
          "type": "string"
        },
        "phone": {
          "type": "string"
        },
        "street": {
          "type": "string"
        },
        "company": {
          "type": "string"
        },
        "country": {
          "type": "string"
        },
        "postal_code": {
          "type": "string"
        }
      },
      "description": "Destination for forward / courier."
    },
    "api_key": {
      "type": "string",
      "description": "Your hm_... key. Only needed if your MCP client cannot send the \"Authorization: Bearer\" header."
    },
    "express": {
      "type": "boolean",
      "description": "forward only: dispatch the same day (+5 €)."
    },
    "item_id": {
      "type": "string"
    },
    "same_day": {
      "type": "boolean",
      "description": "scan only: open + scan today (+1 € or 1 same-day credit)."
    },
    "shipment_id": {
      "type": "string",
      "description": "Pre-book for an announced shipment that has not arrived yet."
    },
    "max_postage_eur": {
      "type": "number",
      "description": "forward/return: postage up to this amount is charged automatically."
    }
  }
}