# Freedom Agent Mail > Free, receive-only, disposable email inboxes for AI agents and humans. No sign-up or API key. > Simple REST API plus agent extras: a long-polling wait endpoint and automatic extraction of > one-time codes and verification links. Base URL: https://freedomagentmail.us Domains: freedomagentmail.us Inboxes are kept until you delete them; messages are deleted after 30 days. Inboxes cannot send email. Tokens expire after a while: log in again with the address and password (POST /token). ## Fastest path: MCP Add this MCP server (Streamable HTTP): https://freedomagentmail.us/mcp?ref=llms Tools: create_inbox, login_inbox, wait_for_email, list_emails, read_email, delete_inbox. ## REST API OpenAPI 3.1 description: https://freedomagentmail.us/openapi.json 1. Create an inbox (pick any username on an available domain and any password, 6+ chars): POST https://freedomagentmail.us/accounts {"address": "someone123@freedomagentmail.us", "password": "..."} 2. Get a token: POST https://freedomagentmail.us/token {"address": "...", "password": "..."} -> {"token": "...", "id": "..."} 3. Use the address (e.g. in a sign-up form), then wait for mail: GET https://freedomagentmail.us/messages/wait?timeout=60&format=agent Header: Authorization: Bearer Returns unread messages as soon as they arrive (or [] after the timeout) and marks them read. Each message includes "codes" (one-time codes) and "verificationLinks". Other endpoints (send "Accept: application/json" for plain JSON instead of JSON-LD): - GET /domains - GET /me - GET /messages?page=1 - GET /messages/{id} (marks it read; includes text, html, codes, links) - PATCH /messages/{id} {"seen": true|false} - DELETE /messages/{id} - GET /messages/{id}/download (raw .eml) - GET /sources/{id} - DELETE /accounts/{id} Limits: inbox creation is rate-limited per IP; messages over ~1 MB are rejected. Privacy: we record usage analytics (client type, MCP client name, endpoints used, sender domains of received mail). We do not record passwords, tokens, one-time codes or email bodies in analytics.