🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Agent Burner
πŸ¦€ ClawHub

Agent Burner

by @jsemldonado

Disposable email API. Use when you need a temporary email address -- receiving mail, reading contents, extracting URLs. Triggers include "create a temp email...

Versionv0.2.1
Downloads587
#clawhub
TERMINAL
clawhub install agent-burner

πŸ“– About This Skill

name: agent-burner version: 0.2.0 description: Disposable email API. Use when you need a temporary email address -- receiving mail, reading contents, extracting URLs. Triggers include "create a temp email", "I need a burner email", "disposable inbox", or any task requiring a throwaway email address. homepage: https://agentburner.com tags: - email - disposable - burner - temp-mail - verification - otp - inbox - api - no-auth - zero-config metadata: author: Jose Maldonado category: email api_base: https://api.agentburner.com

Agent Burner

Disposable email API. No signup, no API key.

Quick Start

# create an inbox
curl -X POST https://api.agentburner.com/inbox

-> { "address": "a3f7b2c1@caledy.com", "key": "550e8400-...", "ttl": 3600 }
read emails

curl https://api.agentburner.com/inbox/550e8400-...

-> { "address": "...", "entries": [{ "id": "...", "from": "...", "subject": "...", "receivedAt": "..." }] }
get full email

curl https://api.agentburner.com/inbox/550e8400-.../EMAIL_ID

-> { "body": "...", "html": "...", "urls": ["..."], ... }
delete inbox (optional -- auto-expires)

curl -X DELETE https://api.agentburner.com/inbox/550e8400-...

API Reference

POST /inbox

Create a disposable inbox.

Body (optional): { "ttl": 60 }   // TTL in minutes, default 60, max 360
Response: { "address": string, "key": string, "ttl": number }

  • address -- the email address
  • key -- inbox key (UUID), the only credential you need
  • ttl -- inbox lifetime in seconds

    • Rate limited to 10 creations per minute per IP.

    GET /inbox/:key

    List received emails.

    Response: { "address": string, "entries": [{ "id": string, "from": string, "subject": string, "receivedAt": string }] }

    Returns 404 if key is expired or invalid.

    GET /inbox/:key/:emailId

    Get full email content.

    Response: {
  "id": string,
  "from": string,
  "to": string[],
  "subject": string,
  "body": string,        // plain text
  "html": string | null, // raw HTML if present
  "urls": string[],      // all extracted URLs
  "receivedAt": string   // ISO 8601
}

    DELETE /inbox/:key

    Delete inbox and all emails. Optional -- inboxes auto-expire.

    Response: { "ok": true }

    Key Details

  • No auth required -- inbox key is the only credential
  • Multiple trusted .com domains
  • Auto-expiry -- 1 hour default, 6 hours max
  • 50 emails per inbox (oldest dropped first)
  • 10MB max email size
  • URLs extracted from both HTML and plain text

    • Errors

    | Status | Meaning | |--------|---------| | 404 | Key expired or invalid | | 429 | Rate limit exceeded |

    πŸ’‘ Examples

    # create an inbox
curl -X POST https://api.agentburner.com/inbox

    -> { "address": "a3f7b2c1@caledy.com", "key": "550e8400-...", "ttl": 3600 }
    read emails
    
curl https://api.agentburner.com/inbox/550e8400-...

    -> { "address": "...", "entries": [{ "id": "...", "from": "...", "subject": "...", "receivedAt": "..." }] }
    get full email
    
curl https://api.agentburner.com/inbox/550e8400-.../EMAIL_ID

    -> { "body": "...", "html": "...", "urls": ["..."], ... }
    delete inbox (optional -- auto-expires)
    
curl -X DELETE https://api.agentburner.com/inbox/550e8400-...