AI agents are becoming users of the internet. The infrastructure they need doesn't exist yet.
Create throwaway inboxes with a single API call. Your agent signs up for services, receives verification emails, and extracts confirmation links — all programmatically. Addresses are spread across a rotating pool of domains, so they don't get bulk-blocked.
Works with Claude Code, Cursor, Windsurf, Codex, and any agent.
Three endpoints. No authentication. JSON in, JSON out.
/v1/email/inboxesCreate up to 10 disposable inboxes. Expire after 1 hour.
curl -X POST https://api.agentbasics.dev/v1/email/inboxes \
-H "Content-Type: application/json" \
-d '{"count": 3}'{
"inboxes": [
{
"address": "johnsmith_k8x2@nexlio.cloud",
"expires_at": 1711274400000
},
{
"address": "janedoe_m3p9@trevlo.cloud",
"expires_at": 1711274400000
},
{
"address": "samwilson_q7n4@trevlo.cloud",
"expires_at": 1711274400000
}
]
}/v1/email/inboxes/:addressCheck a single inbox. Returns emails with parsed links, text, and attachments.
curl https://api.agentbasics.dev/v1/email/inboxes/johnsmith_k8x2@nexlio.cloud
{
"address": "johnsmith_k8x2@nexlio.cloud",
"total": 1,
"emails": [
{
"from": "noreply@neon.tech",
"subject": "Verify your email",
"links": [
"https://neon.tech/verify?t=eyJ..."
],
"received_at": 1711270905000
}
]
}/v1/email/inboxes/bulkCheck up to 10 inboxes in one request.
curl -X POST https://api.agentbasics.dev/v1/email/inboxes/bulk \
-H "Content-Type: application/json" \
-d '{"addresses": ["johnsmith_k8x2@nexlio.cloud", "janedoe_m3p9@trevlo.cloud"]}'[
{
"address": "johnsmith_k8x2@nexlio.cloud",
"total": 1,
"emails": [{"subject": "Verify...", "links": ["https://..."]}]
},
{
"address": "janedoe_m3p9@trevlo.cloud",
"total": 0,
"emails": []
}
]Creates 10 disposable inboxes, signs up for Neon, receives the verification email, confirms the account, and creates a database. Runs on a laptop, controlled from a phone via PUNK.
AI agents are becoming users of the internet, but the infrastructure they depend on doesn't exist yet.
Humans have a mature layer of basic primitives: email, accounts, identity, storage, payments. Agents don't. They get stuck on tasks like creating accounts, receiving verification emails, extracting links, and continuing workflows.
Agent Basics is an attempt to define that layer. Simple, reliable primitives that just work. Starting with email.
This is just the first primitive. Agents will need a full set of basics to operate reliably on the internet.