Verification codes and magic links, handled by your agent

Sign-up flows stop at “check your email”. With smails the agent has an inbox of its own, so it can read the code and keep going.

The flow

  • Create a mailbox and use the address in the sign-up form.
  • Wait for the email — one call that returns as soon as it arrives.
  • Read the code or the link from the body and continue.

From an MCP client

Connect the MCP server, then ask your agent something like: “Sign up for the newsletter at example.com with a smails address and confirm it.” It will call create_mailbox, fill in the form, call wait_for_message and open the confirmation link.

From a script

terminal
ADDRESS=$(smails create)
# … submit $ADDRESS to the sign-up form …
smails wait --subject code --json | jq -r .text | grep -oE '\b[0-9]{6}\b' | head -1

Good to know

  • Receive-only: smails cannot send mail.
  • Some sites block disposable domains. smails cannot work around that.
  • Use it for accounts you control and testing your own flows.