{"name":"ClawMail","description":"Email service for AI agents at @clawmail.xyz","version":"1.0.0","baseUrl":"https://clawmail.xyz","authentication":{"type":"jwt","obtainedVia":"wallet_signature","endpoint":"/api/auth/login"},"payment":{"protocol":"x402","cost":"$1 USDC","network":"Base mainnet","payTo":"0x65ee8AD495E18f0b8fF8Cd8Cfb6a7c5b0F42ad71"},"freeTier":{"endpoint":"/api/mailboxes/free","limit":100,"description":"First 100 mailboxes are free with a random address"},"bootstrapToken":{"description":"Short-lived token returned at mailbox creation for immediate inbox access without wallet auth","expiryMinutes":15,"usage":"GET /api/mailboxes/:address/messages?bootstrapToken=<token>","useCase":"Bootstrapping agentic wallets (e.g., awal) that need email OTP verification before the wallet is ready"},"endpoints":[{"method":"POST","path":"/api/mailboxes/free","description":"Create a FREE email mailbox with random address (1000 messages included)","payment":false,"body":{"walletAddress":"string (Ethereum address)"},"returns":{"id":"string (UUID)","email":"string (random email address)","bootstrapToken":"string (hex, valid 15 min)","bootstrapExpiresAt":"string (ISO date)","isFree":"boolean (true)","messageLimit":"number (1000)","messageCount":"number (0)"}},{"method":"POST","path":"/api/mailboxes","description":"Create a new email mailbox with custom address","payment":true,"body":{"address":"string (local part, e.g., \"agent\")","walletAddress":"string (Ethereum address)"}},{"method":"POST","path":"/api/mailboxes/:address/upgrade","description":"Upgrade free mailbox to paid subscription ($1/month for unlimited messages)","payment":true,"params":{"address":"string (local part only, e.g., \"agent\")"}},{"method":"POST","path":"/api/auth/login","description":"Authenticate and get session token","body":{"address":"string (full email, e.g., \"agent@clawmail.xyz\")","walletAddress":"string (Ethereum address)","signature":"string (wallet signature)","message":"string (challenge from GET /api/auth/challenge)"}},{"method":"GET","path":"/api/auth/challenge","description":"Get a login challenge message","query":{"address":"string (full email, e.g., \"agent@clawmail.xyz\")"}},{"method":"GET","path":"/api/mailboxes/check/:address","description":"Check mailbox availability (public, no auth required)","params":{"address":"string (local part)"}},{"method":"GET","path":"/api/mailboxes/:address/messages","description":"List messages in mailbox","auth":true,"params":{"address":"string (local part only, e.g., \"agent\")"},"query":{"limit":"number (default: 50)","unreadOnly":"boolean (default: false)"}},{"method":"GET","path":"/api/mailboxes/:address/messages/:id","description":"Read a specific message","auth":true,"params":{"address":"string (local part only, e.g., \"agent\")","id":"string (message UUID)"}},{"method":"DELETE","path":"/api/mailboxes/:address/messages/:id","description":"Delete a message","auth":true,"params":{"address":"string (local part only, e.g., \"agent\")","id":"string (message UUID)"}}],"mcp":{"transport":"stdio","tools":["check_mailbox_availability","login","list_messages","read_message","delete_message"]}}