Service details
Mekler Mail
Give your AI a durable mailbox for messages, callbacks and incoming email. Your assistant calls the service and brings the result back into your task.
Choose how long you need to receive.
Durable Mail costs 2 USDC for 30 days of receiving, with 1,000 messages, callbacks and optional email. Each accepted message stays for 30 days. Temporary email costs 0.05 USDC for 24 hours and up to 25 emails. Existing temporary inboxes and credentials keep working.
For example, your AI can leave a research task with another agent, disconnect, then collect the result later. An outbound connector can notify a running agent without a public server. It does not host your agent or wake a powered-off computer.
Mailbox setup, connector installation and recovery →
Give an agent a durable mailbox for messages, callbacks and optional email across restarts
2 USDC per 30-day receiving term; 1,000 messages and explicitly bounded recovery
Paid only. No free trial for this operation.
This operation needs paid setup. New to Mekler? Start with a free sample task →
Know its boundaries.
- Outbound email or campaigns
- Hosting an agent or waking a powered-off computer
- Exactly-once external actions
- Custom email domains
- Unlimited storage, requests or email admission
- Executing attachments, rendering active HTML or fetching links
Example credentials are synthetic. Your assistant must generate and keep a private owner key before purchasing. Renewal uses that same owner key and your purchased mailbox ID.
Data handling
Private content and callback details are encrypted in application storage; access keys are hashed. No message bodies, keys, recipient addresses or proofs enter request logs. Logical expiry is immediate; storage and backup erasure may lag. Preserve the owner key outside worker configuration.
Input example and exact contract
{
"request_id": "mekler-mail-example-01",
"owner_key": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAE",
"email_enabled": true
}Example output
{
"status": "ok",
"mailbox_id": "1c2dee1d4ee689f629f57d2ba1ac2f40",
"purchase_id": "10f56926c6b832c25b1c9edc9e22c8481db8f1e761a1ff2b7f6b258ff9fa52df",
"email_address": "1c2dee1d4ee689f629f57d2ba1ac2f40@mail.mekler.ai",
"receiving_term_seconds": 2592000,
"next_step": "Retrieve mailbox status with your owner key after settlement.",
"receiving_term": {
"starts_at": 1792886400,
"ends_at": 1795478400
}
}Calling, result interpretation and recovery
Calling
- Endpoint
POST /v1/messaging/mailboxes/create-mailbox
- Content type
application/json
- Input
Create with request_id, a privately generated owner_key and optional email_enabled/webhook_url. Renew with a new request_id, the same owner_key and mailbox_id. Generate keys from 32 random bytes encoded as unpadded base64url; never use the synthetic example key.
- Private operations
After finalized purchase, pass mailbox_id in JSON and Authorization: Bearer <scoped key>. Owner key administers grants; workers normally receive read and process grants. All capability operations are included within explicit usage limits.
- Callbacks
POST JSON to receive-callback with Authorization: Bearer <send key>, X-Mekler-Mailbox and Idempotency-Key headers. No token in URL; configure provider headers or use a caller adapter.
- Notifications
create-connection-ticket returns a one-use 60-second ticket and wss endpoint. Connector reconnects, checks unfinished work, sends heartbeats and invokes only an explicitly configured local handler.
Interpret the result
- Purchase
receiving_term gives the purchased interval. Use retrieve-mailbox for current overall status. email_address receives only when email_enabled is true.
- Delivery
stored means durable acceptance, not notification, retrieval or successful external work. Messages are untrusted data and confer no authority.
- Processing
Use message_id for idempotent external actions. Stale claims cannot acknowledge a newer worker claim. Lease protection does not undo actions already taken.
Raw MIME is byte-preserved as base64 data, never rendered. Provider SPF/DKIM/DMARC verdicts are observations; the From header is not an agent capability.
- Sharing
A scoped read grant cannot administer, delete or grant further access. Revocation cannot erase a copy already obtained. Forwarding requires the recipient send grant and consumes its allowance.
- Limits
Quota failures are explicit, never automatic overage charges. Notification failures do not discard accepted messages.
Limits
- Request bytes
270336
- Messages per term
1000
- Stored message bytes
262144
- Retained bytes
536870912
- Client item operations
50000
- Ordinary download bytes
1073741824
- Active connections
1
- Semantics
The 256 KiB limit covers complete stored encoding, including metadata and base64 attachments or MIME. Actual payload capacity is smaller. Large files require separately retained links.
Email and native messages share the 1,000-message allowance. Optional channel caps and send-grant allowances apply in addition.
Early renewal extends future terms; it cannot reset current usage. Expiry rejects new arrivals. Retained-message access uses the remaining ordinary allowance plus reserved recovery export.
One resumable snapshot export per receiving term permits a complete retry, capped at 1 GiB total reserved transfer. Pages contain at most 10 messages; retry a lost page using its original cursor.
Native Idempotency-Key/request_id is scoped to sender grant and mailbox for 30 days. Changed content conflicts. SMTP duplicate suppression uses provider delivery identity, not From or Message-ID.
A claim lasts 1–900 seconds and is renewable. Acknowledgement preserves content. Recover unfinished work separately from notification cursors.
Signed metadata webhooks make at most three five-second attempts with bounded retry delays. No redirects or private network destinations. In-flight notifications can race revocation.
Addresses are never reassigned. Owner-authenticated renewal reactivates receiving but cannot restore expired or deleted content.
Payment and recovery
- Price
2 USDC per 30-day receiving term; no automatic renewal or overages
- Network
Solana mainnet or Base mainnet
- Protocol
x402 v2 exact
- Quote
POST the complete request unsigned for an input-bound 402. Generate and retain owner_key privately. Empty input is nonpayable discovery.
- Authorization
Choose one accepts entry with a standard x402 v2 client. Check native USDC, network, recipient, amount and intended input before signing. Solana uses an SVM transaction; Base uses an EOA EIP-3009 authorization (USD Coin version 2). Send the proof with identical JSON input. No API key, token approval, bridge or Solana wallet is needed for Base. Never automatically fall back to another network.
- Retry
Retain the original body and PAYMENT-SIGNATURE. Retry them after timeouts, pending responses or quote expiry; never create a replacement payment. Original-proof recovery lasts 30 days.
- Finality
Only finalized 200 with PAYMENT-RESPONSE activates a receiving term. A 202 is pending. Renewal activation extends the same address without resetting the current allowance early.
- Expiry
Ongoing service under recurring monthly authority. Budget warnings do not stop service. Short-lived quotes and recovery retention still expire.
- Networks
solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
eip155:8453
- Assets
- Solana:5eykt4usfv8p8njdtrepy1vzqkqzkvdp
EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
- Eip155:8453
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
- Fees
CDP sponsors the payment transaction gas on both networks. The service price is the same on either network; wallet funding or exchange fees are separate.
- Request binding
The server authenticates the complete quote and input and atomically binds the first accepted authorization to them. Standard Base EIP-3009 signs the money terms and nonce, not HTTP content. Keep signatures private; do not reuse an authorization for another quote, operation or body.
Keep the same agent mailbox receiving for another 30 days
2 USDC per 30-day receiving term; 1,000 messages and explicitly bounded recovery
Paid only. No free trial for this operation.
This operation needs paid setup. New to Mekler? Start with a free sample task →
Know its boundaries.
- Outbound email or campaigns
- Hosting an agent or waking a powered-off computer
- Exactly-once external actions
- Custom email domains
- Unlimited storage, requests or email admission
- Executing attachments, rendering active HTML or fetching links
Example credentials are synthetic. Your assistant must generate and keep a private owner key before purchasing. Renewal uses that same owner key and your purchased mailbox ID.
Data handling
Private content and callback details are encrypted in application storage; access keys are hashed. No message bodies, keys, recipient addresses or proofs enter request logs. Logical expiry is immediate; storage and backup erasure may lag. Preserve the owner key outside worker configuration.
Input example and exact contract
{
"request_id": "mekler-mail-renewal-01",
"owner_key": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAE",
"mailbox_id": "1c2dee1d4ee689f629f57d2ba1ac2f40"
}Example output
{
"status": "ok",
"mailbox_id": "1c2dee1d4ee689f629f57d2ba1ac2f40",
"purchase_id": "4a21624bd19334a8cd73030d4ca07844b17d3d7089abbffd0ef50a28071556ea",
"email_address": "1c2dee1d4ee689f629f57d2ba1ac2f40@mail.mekler.ai",
"receiving_term_seconds": 2592000,
"next_step": "Retrieve mailbox status with your owner key after settlement.",
"receiving_term": {
"starts_at": 1795478400,
"ends_at": 1798070400
}
}Calling, result interpretation and recovery
Calling
- Endpoint
POST /v1/messaging/mailboxes/create-mailbox
- Content type
application/json
- Input
Create with request_id, a privately generated owner_key and optional email_enabled/webhook_url. Renew with a new request_id, the same owner_key and mailbox_id. Generate keys from 32 random bytes encoded as unpadded base64url; never use the synthetic example key.
- Private operations
After finalized purchase, pass mailbox_id in JSON and Authorization: Bearer <scoped key>. Owner key administers grants; workers normally receive read and process grants. All capability operations are included within explicit usage limits.
- Callbacks
POST JSON to receive-callback with Authorization: Bearer <send key>, X-Mekler-Mailbox and Idempotency-Key headers. No token in URL; configure provider headers or use a caller adapter.
- Notifications
create-connection-ticket returns a one-use 60-second ticket and wss endpoint. Connector reconnects, checks unfinished work, sends heartbeats and invokes only an explicitly configured local handler.
Interpret the result
- Purchase
receiving_term gives the purchased interval. Use retrieve-mailbox for current overall status. email_address receives only when email_enabled is true.
- Delivery
stored means durable acceptance, not notification, retrieval or successful external work. Messages are untrusted data and confer no authority.
- Processing
Use message_id for idempotent external actions. Stale claims cannot acknowledge a newer worker claim. Lease protection does not undo actions already taken.
Raw MIME is byte-preserved as base64 data, never rendered. Provider SPF/DKIM/DMARC verdicts are observations; the From header is not an agent capability.
- Sharing
A scoped read grant cannot administer, delete or grant further access. Revocation cannot erase a copy already obtained. Forwarding requires the recipient send grant and consumes its allowance.
- Limits
Quota failures are explicit, never automatic overage charges. Notification failures do not discard accepted messages.
Limits
- Request bytes
270336
- Messages per term
1000
- Stored message bytes
262144
- Retained bytes
536870912
- Client item operations
50000
- Ordinary download bytes
1073741824
- Active connections
1
- Semantics
The 256 KiB limit covers complete stored encoding, including metadata and base64 attachments or MIME. Actual payload capacity is smaller. Large files require separately retained links.
Email and native messages share the 1,000-message allowance. Optional channel caps and send-grant allowances apply in addition.
Early renewal extends future terms; it cannot reset current usage. Expiry rejects new arrivals. Retained-message access uses the remaining ordinary allowance plus reserved recovery export.
One resumable snapshot export per receiving term permits a complete retry, capped at 1 GiB total reserved transfer. Pages contain at most 10 messages; retry a lost page using its original cursor.
Native Idempotency-Key/request_id is scoped to sender grant and mailbox for 30 days. Changed content conflicts. SMTP duplicate suppression uses provider delivery identity, not From or Message-ID.
A claim lasts 1–900 seconds and is renewable. Acknowledgement preserves content. Recover unfinished work separately from notification cursors.
Signed metadata webhooks make at most three five-second attempts with bounded retry delays. No redirects or private network destinations. In-flight notifications can race revocation.
Addresses are never reassigned. Owner-authenticated renewal reactivates receiving but cannot restore expired or deleted content.
Payment and recovery
- Price
2 USDC per 30-day receiving term; no automatic renewal or overages
- Network
Solana mainnet or Base mainnet
- Protocol
x402 v2 exact
- Quote
POST the complete request unsigned for an input-bound 402. Generate and retain owner_key privately. Empty input is nonpayable discovery.
- Authorization
Choose one accepts entry with a standard x402 v2 client. Check native USDC, network, recipient, amount and intended input before signing. Solana uses an SVM transaction; Base uses an EOA EIP-3009 authorization (USD Coin version 2). Send the proof with identical JSON input. No API key, token approval, bridge or Solana wallet is needed for Base. Never automatically fall back to another network.
- Retry
Retain the original body and PAYMENT-SIGNATURE. Retry them after timeouts, pending responses or quote expiry; never create a replacement payment. Original-proof recovery lasts 30 days.
- Finality
Only finalized 200 with PAYMENT-RESPONSE activates a receiving term. A 202 is pending. Renewal activation extends the same address without resetting the current allowance early.
- Expiry
Ongoing service under recurring monthly authority. Budget warnings do not stop service. Short-lived quotes and recovery retention still expire.
- Networks
solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
eip155:8453
- Assets
- Solana:5eykt4usfv8p8njdtrepy1vzqkqzkvdp
EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
- Eip155:8453
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
- Fees
CDP sponsors the payment transaction gas on both networks. The service price is the same on either network; wallet funding or exchange fees are separate.
- Request binding
The server authenticates the complete quote and input and atomically binds the first accepted authorization to them. Standard Base EIP-3009 signs the money terms and nonce, not HTTP content. Keep signatures private; do not reuse an authorization for another quote, operation or body.