Disposable inboxes for code, tests and agents
Make an email address in one call, use it in a sign-up form, read the verification code and let it dissolve. Over REST, the TypeScript SDK, the CLI or MCP.
- API operations
- 59
- MCP tools
- 26
- Reference sections
- 13
dissolve.email gives every program its own throwaway address. An inbox lives for minutes or hours, takes mail from anyone, pulls out the verification code for you and deletes itself with every message when its time is up. It only receives: nothing can be sent from it.
This is the developer guide: the API at https://api.dissolve.email/v1, the TypeScript SDK, the dna CLI, the hosted MCP server for AI agents, and signed webhooks. dissolve.email was called destroy.network until November 2026: what changed.
From nothing to a code
Make an inbox, give its address to the site you are testing, and wait for the code it sends. The wait call holds the request open until mail arrives, so there is no polling loop to write.
# Make an inbox
curl -X POST https://api.dissolve.email/v1/inboxes \
-H "Authorization: Bearer $DISSOLVE_API_KEY"
# Wait up to 30 seconds for a code from GitHub
curl "https://api.dissolve.email/v1/inboxes/$INBOX_ID/code?timeout=30&from=github.com" \
-H "Authorization: Bearer $DISSOLVE_API_KEY"import { Dissolve } from '@dissolve-email/sdk';
const client = new Dissolve(); // reads DISSOLVE_API_KEY
const inbox = await client.v1.createInbox();
console.log(inbox.address); // use it in the sign-up form
const code = await client.v1.waitForCode(inbox.id, { timeout: 30, from: 'github.com' });
if (code.found) console.log(code.value);dna auth login
ID=$(dna create --label signup --json | jq -r .id)
dna verify "$ID" --timeout 30 --quietimport os, requests
API = "https://api.dissolve.email/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['DISSOLVE_API_KEY']}"}
inbox = requests.post(f"{API}/inboxes", headers=HEADERS).json()
print(inbox["address"])
code = requests.get(f"{API}/inboxes/{inbox['id']}/code", params={"timeout": 30, "from": "github.com"}, headers=HEADERS, timeout=60).json()
if code["found"]:
print(code["value"])The quickstart walks through the same steps with every answer shown.
Ways in
| Best for | Signs in with | |
|---|---|---|
| REST API | Any language, test suites, back ends | An sk_live_ API key or an OAuth token |
| TypeScript SDK | Node, Deno, Bun, Workers and browsers | The same, with typed errors and retries |
| CLI | Shell scripts, CI jobs, agents with a terminal | dna auth login in the browser |
| MCP server | Claude, Cursor, VS Code, ChatGPT and other agents | OAuth in the browser, or an API key |
| Webhooks | Reacting to mail without holding a request open | A signing secret you choose |
Hosts
| Host | What lives there |
|---|---|
api.dissolve.email | The API: /v1, the OAuth server and its discovery documents |
app.dissolve.email | The app: inboxes, API keys, Connected apps, billing, the OAuth consent page |
mcp.dissolve.email | The hosted MCP server |
docs.dissolve.email | These docs, the OpenAPI document and llms.txt |
status.dissolve.email | Service status and incidents |
Something wrong or missing on this page? Tell us at support@dissolve.email.View as Markdown