agmail

Boîtes mail pour agents IA, à l’heure : une adresse de votre choix, un appel pour attendre un message, le code ou lien extrait. Sans compte, payé par appel avec les stablecoins x402.

Serveur MCP hébergé

npx add-mcp 'https://agmail.shveik.dev/mcp'

S’installe dans Claude Code, Codex, Cursor et plus

Documentation

Email inboxes for agents, by the hour.

An address of your choice that only receives. One call waits for a message and returns the code or the link.

1. Pick an address

Choose a name, or leave it out for a random one. The address is name@agmail.shveik.dev.

2. Pay

One paid call per inbox, in stablecoins, over x402 or MPP. An unpaid request returns the quote first.

3. Wait for the message

One call waits for mail and returns the code or the link. Nothing is parsed on your side.

4. Let it expire

An inbox lasts one, four or 24 hours. Pay again to extend it; nothing renews by itself.

Good to know

  • Payment: Stablecoins
  • Accounts: None. No keys to issue, no subscription
  • Protocols: x402 and MPP
  • Mail: Received only. Nothing can be sent
  • Compared with: Mail APIs with accounts and sending-reputation workflows send mail; agmail provides receive-only inboxes with a quote before per-call payment.

Authentication/payment

No API key or account is required. The unpaid request returns HTTP 402 with a quote: x402 uses PAYMENT-REQUIRED and a paid retry with PAYMENT-SIGNATURE; MPP uses WWW-Authenticate: Payment and a paid retry with Authorization: Payment. Review and sign the quote, then retry the same request. See the deprecation policy.

Pricing

Current endpoint prices and limits are generated at https://agmail.shveik.dev/pricing.md. Each quote is returned before payment.

Endpoints

  • POST /x402/inbox-1h (x402) and POST /mpp/inbox-1h (MPP): Inbox for one hour
  • POST /x402/inbox-1h-renew (x402) and POST /mpp/inbox-1h-renew (MPP): Extend by one hour
  • POST /x402/inbox-4h (x402) and POST /mpp/inbox-4h (MPP): Inbox for four hours
  • POST /x402/inbox-4h-renew (x402) and POST /mpp/inbox-4h-renew (MPP): Extend by four hours
  • POST /x402/inbox-24h (x402) and POST /mpp/inbox-24h (MPP): Inbox for a day
  • POST /x402/inbox-24h-renew (x402) and POST /mpp/inbox-24h-renew (MPP): Extend by 24 hours

OpenAPI

OpenAPI 3.1

MCP

Remote MCP is available at https://agmail.shveik.dev/mcp, with tools corresponding to the enabled endpoints.

Rate limits

Free documents are limited to 120 requests per IP per minute. Paid API routes have no general request quota; endpoint-specific limits are documented with each route.

Limits and reliability

No uptime SLA; service and upstream availability are best-effort. Free GET documents, including /docs, /agents.md, /llms.txt, /openapi.json, /pricing and /pricing.md, are limited to 120 requests per client IP per minute and return RateLimit headers; HTTP 429 includes Retry-After. Paid-route timeouts and any route-specific in-flight limits are described in the product docs. GET /health is a liveness check on agdata, agproxy and agvps; agmail and agpay use GET /healthz. HTTP 402 means payment is required, 429 means a limit was reached, 502 means delivery failed, and 503 means the service cannot accept work; follow Retry-After when present. Review the quote before paying. An unpaid request returns a quote before payment; work starts after settlement. A request refused before settlement is not charged; product-specific refund rules apply.

Capabilities

Receive-only email inboxes for AI agents, by the hour. Pay in stablecoins with x402 or MPP; one call returns the code or the link.

Contact

Contact the operator. Read the full documentation