Email addresses for AI agents at @clawmail.xyz, with bootstrap tokens for wallet OTP flows.
What it does
ClawMail is an email service purpose-built for AI agents and LLMs. It provides @clawmail.xyz email addresses that agents can create, authenticate against, and read programmatically. The service is designed to solve the circular dependency problem when bootstrapping agentic wallets: an agent needs an inbox to receive OTP codes, but needs a wallet to authenticate into the inbox. ClawMail addresses this with short-lived bootstrap tokens (valid 15 minutes) returned at mailbox creation, allowing immediate inbox access without wallet auth.
The service offers two tiers: a free tier (POST /api/mailboxes/free) that provides a randomly-named mailbox with 1000 messages included, and a custom mailbox tier (POST /api/mailboxes) that costs $1 USDC via the x402 protocol on Base mainnet. Free mailboxes can be upgraded to unlimited messages for $1/month. Authentication after the bootstrap window uses Ethereum wallet signatures (EIP-191 personal_sign) to obtain JWT session tokens.
ClawMail exposes a full REST API covering mailbox creation, availability checking, message listing, reading, and deletion. It also supports MCP (Model Context Protocol) integration with tools for checking availability, logging in, listing messages, reading messages, and deleting messages. Payments settle on Base mainnet (eip155:8453) to address 0x65ee8AD495E18f0b8fF8Cd8Cfb6a7c5b0F42ad71.
Capabilities
Use cases
- —Bootstrapping agentic wallets that require email OTP verification before the wallet is fully set up
- —Giving AI agents a dedicated email address for receiving notifications, confirmations, or verification codes
- —Automating email-based signup flows where an agent needs to read confirmation emails
- —Integrating email reading capabilities into LLM workflows via MCP tools
- —Receiving and processing inbound emails programmatically in agent pipelines
Fit
Best for
- —AI agents that need email addresses for OTP/verification flows
- —Developers building autonomous wallet setup pipelines
- —LLM applications needing email receive capability via MCP
- —Agents that need temporary or persistent inbound email
Not for
- —Sending outbound emails (ClawMail is receive-only based on documented endpoints)
- —High-volume email marketing or bulk email operations
- —Human end-user email clients or traditional email workflows
Quick start
# Create a free mailbox (no payment required)
curl -X POST https://clawmail.xyz/api/mailboxes/free \
-H 'Content-Type: application/json' \
-d '{"walletAddress": "0xYourWalletAddress"}'
# Read messages using bootstrap token (valid 15 min)
curl https://clawmail.xyz/api/mailboxes/swift-horse-staple/messages?bootstrapToken=YOUR_TOKENExample
Request
{
"walletAddress": "0x1234567890abcdef1234567890abcdef12345678"
}Response
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"email": "swift-horse-staple@clawmail.xyz",
"isFree": true,
"messageCount": 0,
"messageLimit": 1000,
"bootstrapToken": "abcdef1234567890abcdef1234567890",
"bootstrapExpiresAt": "2025-01-15T12:15:00.000Z"
}Endpoint
Quality
The endpoint is live (402 challenge confirmed for custom mailbox creation), with comprehensive API documentation available from the landing page and /api endpoint. Full endpoint schemas, authentication flow, pricing, and MCP tool list are documented. No formal OpenAPI spec is served, and /docs returns 404, but the inline documentation is thorough.
Warnings
- —No formal OpenAPI specification available (/docs returns 404)
- —Free tier limited to 100 total mailboxes globally (error 429 when exhausted)
- —Free mailboxes limited to 1000 messages before requiring $1/month upgrade
- —Outbound email sending does not appear to be supported
Citations
- —ClawMail provides email addresses for AI agents at @clawmail.xyzhttps://clawmail.xyz
- —Free tier provides random email with 1000 messages included via POST /api/mailboxes/freehttps://clawmail.xyz
- —Custom mailbox creation costs $1 USDC via x402 protocol on Base mainnethttps://clawmail.xyz/api
- —Bootstrap token valid for 15 minutes for immediate inbox access without wallet authhttps://clawmail.xyz
- —Payment address is 0x65ee8AD495E18f0b8fF8Cd8Cfb6a7c5b0F42ad71 on eip155:8453https://clawmail.xyz/api
- —MCP tools include check_mailbox_availability, login, list_messages, read_message, delete_messagehttps://clawmail.xyz/api
- —Free mailbox global limit is 100https://clawmail.xyz
- —Free mailboxes can be upgraded for $1/month via POST /api/mailboxes/:address/upgradehttps://clawmail.xyz