Agent API to automate any signup
Disposable email identities for AI agents and browser automation. Create an identity, fill the signup form and extract the verification code. Works with any language and any framework.
Browser automation and AI agents hit the same wall every time: the signup form asks for an email address. The Agent API creates disposable email and password pairs on demand, so your automation can complete any registration flow end to end without manual intervention.
Any language, any framework
The API is framework-agnostic. Anything that can make an HTTP request or run a shell command can use it. The dna CLI gives you a convenient shell interface, the SDK covers TypeScript, and the REST API at https://api.dissolve.email integrates from any programming language. All three return structured JSON for easy parsing.
npm install -g @dissolve-email/cli
dna create --json
dna verify <id> --timeout 30 --quiet
dna delete <id>
Works with your agents
Claude computer use, Claude Code, LangChain, CrewAI and other agents with shell access can run dna commands to create identities, fill forms in the browser and pull verification codes. For agents that speak the Model Context Protocol, connect to the hosted MCP server at https://mcp.dissolve.email. Read more on the agents page.
For testing and automation only. Generated personas are fictional identities for automated testing, QA workflows and development. Do not use them for identity fraud, impersonation, scams or any illegal activity. We are not responsible for misuse of generated data. By using this feature you agree to our acceptable use policy.
Why it helps
Playwright and Puppeteer
Drop into your existing test suites. Spawn a fresh identity per test, fill the form, extract the code and tear down.
Ready for AI agents
Claude computer use, LangChain, CrewAI and other agents run CLI commands or MCP tools to sign up for services on their own.
Smart code extraction
More than 13 built-in patterns detect OTP codes, verification links, magic links and prefixed tokens with confidence scoring.
Isolated and encrypted
Every identity gets AES-256 encrypted credentials, scoped access and automatic expiry. Delete it the moment you are done.
Questions
How do I use this with Playwright or Puppeteer?
Install the CLI with 'npm install -g @dissolve-email/cli'. In your test script, run 'dna create --json' to get a disposable email and password, and fill the signup form with them. Then run 'dna verify <id> --timeout 30 --quiet' to wait for the confirmation email and get the code. Submit it, then run 'dna delete <id>' to clean up.
Does it work with AI agents like Claude or ChatGPT?
Yes. Any AI agent with shell access, such as Claude Code, Claude computer use, OpenAI models with tools or LangChain agents, can run dna commands to create identities and extract codes. Agents that support MCP can connect to https://mcp.dissolve.email instead.
Can I use the REST API instead of the CLI?
Yes. Every CLI command maps to a REST endpoint on https://api.dissolve.email. POST /api/agent/identities creates an identity, GET /api/agent/identities/:id/verify extracts the verification code, and DELETE /api/agent/identities/:id cleans up. Both return the same structured JSON.
What verification codes can it extract?
It detects six-digit OTP codes, alphanumeric tokens, prefixed codes such as G-847293, spaced digits, verification links, magic links and HTML-styled codes. Each match gets a confidence score from 0 to 1, and you can pass your own regex for unusual formats.
What plans support the Agent API?
The Agent API needs a Pro or Business plan. Pro supports up to 10 active identities with 30-second wait timeouts. Business supports up to 50 with 120-second timeouts.
Can I use this in CI/CD pipelines?
Yes. Set the DISSOLVE_API_KEY environment variable and every command runs non-interactively. The CLI ships prebuilt binaries for Linux x64 and arm64, so it works on GitHub Actions, GitLab CI and any Docker-based runner.
What are agent personas?
Personas generate fictional but structurally valid identity data (name, address, phone, date of birth) alongside each disposable email. Supported countries include US, UK, AU, CA, DE, FR, JP, BR, IN, ES, IT, NL, KR, MX, SE, PL and NZ, and you can choose the country and gender. Personas are for testing and automation only and need a Pro or Business plan. Pass persona: true in your create request and the response includes a full persona object.
Can I default to always generating a persona?
Yes. In the CLI, run 'dna config set defaults.persona true' and every 'dna create' includes a persona. You can also set defaults.country and defaults.gender. With the REST API, pass persona: true in each request body.
Related features
CLI
Pro and upA command-line tool for AI agents and browser automation that creates identities and extracts verification codes.
Learn moreSDK
Pro and upA fully typed TypeScript SDK for creating inboxes, reading messages and automating email from code.
Learn moreInbox rules
Pro and upAutomate your disposable email workflow with rules that filter, route and act on incoming messages.
Learn moreAutomate your first signup
Install the CLI, create a disposable identity and extract a verification code in under 60 seconds.