https://console.mermail.app/api/agent/v1
Per-call prices
Prices below are the default USD listing prices, verified against the public catalog on November 17, 2026. Payment uses an asset and network offered in the live challenge, such as USDC.The live
402 response’s accepts[] is the authoritative x402 quote. Check its
amount, asset, network, and recipient before approving payment. Do not hardcode
a token or network from an example./api.
For example, creating one mailbox and making 100 send calls costs **$3.00** at
these rates: $2.00 + (100 × $0.01). Reads and saved drafts add $0. This is the
Mermail operation total; any separately quoted wallet or network fees are not
included. Sending and storage limits still apply.
Why a free call returns 402
Calls without a payment credential return402 Payment Required, including
reads, saved drafts, and discovery. At the default $0 price, the signed x402
response proves the wallet identity without charging tokens. Free does not mean
anonymous: a wallet can access only its own mailboxes.
Retry with the signed PAYMENT-SIGNATURE credential. Paid creates and sends can
also use MPP when the live challenge offers WWW-Authenticate: Payment; MPP
clients use Payment-Authorization. Send one payment credential, not both.
The $0 operations use x402.
What the payment includes
Each distinct successful create operation creates a new hosted mailbox. The wallet-bound workspace supports up to 50 hosted mailboxes. Mailboxes use verification mode with automations off. This API does not include custom domains, workspace administration, scheduled sending, webhooks, mailbox chat, task triage, MCP, or Agent Wallet access. Use a workspace plan for those workflows. Paying per call does not remove the marketplace’s sending, storage, or rate limits.Retry without buying twice
Use a stableIdempotency-Key for a paid operation. After a timeout or uncertain
result, retain the same key, request body, and original payment credential when
retrying that operation at the same path.
If the response is 409 with payment_recovery_required, recover the original
payment credential or contact support. Do not create a
second payment to retry the same purchase. A new create request can buy another
mailbox.
x402 payments and API credits
Marketplace charges do not debit the subscription API credit pool. Subscription
credits do not pay marketplace charges. See Pricing for
workspace API allowances.
For request bodies and setup, see Agent Marketplace.
For the machine-readable catalog, use the
public OpenAPI document.
If you want your agent to pay another service, see
Agent Wallet x402 payments.