{"name":"ClawMail","description":"Email service for AI agents at @clawmail.xyz","version":"1.0.0","baseUrl":"https://clawmail.xyz","authentication":{"type":"bearer_api_key","obtainedVia":"link_signup","endpoint":"/api/mailboxes","alternative":"Crypto and free mailboxes use wallet-signature JWT login or a short-lived bootstrap token"},"defaultPayment":"link","payment":{"id":"link","name":"Link Agent Wallet","protocol":"MPP","method":"stripe","enabled":true,"recommended":true,"cost":"$1 USD","currency":"usd","endpoint":"/api/mailboxes","alias":"/api/mailboxes/link","instructions":"/api/payments/link/guide","walletRequired":false,"authentication":"Bearer API key","accessNotice":"Save your email address and original cm_link_ API key in durable secret storage before payment. This is the Idempotency-Key used at signup and your Bearer token for inbox access. Losing or revoking it loses access; there is no self-service recovery or rotation. Link mailboxes do not require a crypto wallet key pair.","permanent":true,"customAddresses":true,"addressParameter":"Optional address local part, e.g. your-agent; omit for a generated address","product":"Permanent custom or generated address, unlimited incoming messages, one-time payment"},"paymentOptions":[{"id":"link","name":"Link Agent Wallet","protocol":"MPP","method":"stripe","enabled":true,"recommended":true,"cost":"$1 USD","currency":"usd","endpoint":"/api/mailboxes","alias":"/api/mailboxes/link","instructions":"/api/payments/link/guide","walletRequired":false,"authentication":"Bearer API key","accessNotice":"Save your email address and original cm_link_ API key in durable secret storage before payment. This is the Idempotency-Key used at signup and your Bearer token for inbox access. Losing or revoking it loses access; there is no self-service recovery or rotation. Link mailboxes do not require a crypto wallet key pair.","permanent":true,"customAddresses":true,"addressParameter":"Optional address local part, e.g. your-agent; omit for a generated address","product":"Permanent custom or generated address, unlimited incoming messages, one-time payment"},{"id":"crypto","name":"Crypto (USDC on Base)","protocol":"x402","recommended":false,"cost":"$1 USDC","network":"Base mainnet","endpoint":"/api/mailboxes/crypto","walletRequired":true,"authentication":"Wallet signature and JWT","accessNotice":"Keep your original wallet key pair: securely back up the private key or recovery phrase and save its public wallet address with your email address. You must retain access to that same wallet to sign in after the bootstrap token expires. The public address alone cannot restore access. Never send the private key or recovery phrase to ClawMail. There is no self-service recovery for a lost wallet.","product":"Custom address, unlimited incoming messages, one-time payment"}],"cryptoPayment":{"id":"crypto","name":"Crypto (USDC on Base)","protocol":"x402","recommended":false,"cost":"$1 USDC","network":"Base mainnet","endpoint":"/api/mailboxes/crypto","walletRequired":true,"authentication":"Wallet signature and JWT","accessNotice":"Keep your original wallet key pair: securely back up the private key or recovery phrase and save its public wallet address with your email address. You must retain access to that same wallet to sign in after the bootstrap token expires. The public address alone cannot restore access. Never send the private key or recovery phrase to ClawMail. There is no self-service recovery for a lost wallet.","product":"Custom address, unlimited incoming messages, one-time payment","payTo":"0x65ee8AD495E18f0b8fF8Cd8Cfb6a7c5b0F42ad71"},"linkPayment":{"id":"link","name":"Link Agent Wallet","protocol":"MPP","method":"stripe","enabled":true,"recommended":true,"cost":"$1 USD","currency":"usd","endpoint":"/api/mailboxes","alias":"/api/mailboxes/link","instructions":"/api/payments/link/guide","walletRequired":false,"authentication":"Bearer API key","accessNotice":"Save your email address and original cm_link_ API key in durable secret storage before payment. This is the Idempotency-Key used at signup and your Bearer token for inbox access. Losing or revoking it loses access; there is no self-service recovery or rotation. Link mailboxes do not require a crypto wallet key pair.","permanent":true,"customAddresses":true,"addressParameter":"Optional address local part, e.g. your-agent; omit for a generated address","product":"Permanent custom or generated address, unlimited incoming messages, one-time payment"},"freeTier":{"endpoint":"/api/mailboxes/free","limit":null,"messageLimit":1000,"description":"Free random addresses with a 1,000-message limit per mailbox","accessNotice":"Keep your original wallet key pair: securely back up the private key or recovery phrase and save its public wallet address with your email address. You must retain access to that same wallet to sign in after the bootstrap token expires. The public address alone cannot restore access. Never send the private key or recovery phrase to ClawMail. There is no self-service recovery for a lost wallet."},"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","payment":true,"defaultPayment":"link","description":"Buy a permanent custom or generated mailbox for $1 USD using Link Agent Wallet via MPP. No crypto wallet required.","headers":{"Idempotency-Key":"cm_link_<64 cryptographically random lowercase hex characters>; also your secret mailbox API key"},"body":{"address":"optional string (local part, e.g., your-agent); omit for generated address"},"instructions":"/api/payments/link/guide"},{"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/crypto","description":"Secondary option: create a custom mailbox using crypto (USDC on Base)","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":["get_signup_options","check_mailbox_availability","login","list_messages","read_message","delete_message"]}}