Disposable email for humans and agents.
An instant throwaway inbox for sign-ups, codes, and confirmations — with a REST API, CLI, and MCP server so your agents can read it too.
Your live inbox
0 messagesOffline
Give your agent its own inbox.
Humans and agents share the same mailbox. Drive it from the terminal, or plug the MCP server into Claude, Cursor, or any MCP client.
terminal
# create a mailbox
npx @smails/cli create
# list and read messages
npx @smails/cli inbox
npx @smails/cli read <id>~/.claude/mcp.json
{
"mcpServers": {
"smails": {
"command": "npx",
"args": ["@smails/cli", "mcp"]
}
}
}MCP Tools
create_mailboxlist_messagesread_messagedelete_messageget_addressOr just call the API.
No SDK required. Create a mailbox, then poll or stream messages with the returned token.
curl
# create a mailbox
curl -X POST https://smails.dev/api/mailbox
# → { "address": "...", "token": "..." }
# list messages with the returned token
curl https://smails.dev/api/mailbox/messages \
-H "Authorization: Bearer <token>"
# read one message (full parsed body)
curl https://smails.dev/api/mailbox/messages/<id> \
-H "Authorization: Bearer <token>"Endpoints
POST
/api/mailboxCreate a mailbox → { address, token }
GET
/api/mailbox/messagesList messages
GET
/api/mailbox/messages/:idRead a message (full body)
DELETE
/api/mailbox/messages/:idDelete a message
WS
/api/mailbox/connectStream new-mail notifications