Skip to main content
The Agent Marketplace API lets an agent create and use hosted mailboxes through wallet-based payments. You do not need a Mermail API key or a monthly Developer or Growth subscription for this API. Base URL: 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.
Paths below are relative to the base URL, except the discovery entry /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 return 402 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 stable Idempotency-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.