Skip to content
Mekler AIGet started

Mekler AI / Mekler Mail

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
}

API reference: input, output and error schemas →

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.

Email

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"
}

API reference: input, output and error schemas →

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.

Email

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.