# agentsite-static-version=eeb0e7c6-bf25-4a9d-9c42-3f3a9e955f49
# machinemail.dev

> AI-optimized mirror of machinemail.dev containing 242 pages totalling 368,812 words of clean markdown content, structured data, and semantic HTML. Original source: https://machinemail.dev. Last updated: 2026-11-04T12:47:20.436Z.

Each page is available as HTML (with JSON-LD structured data) and Markdown (text-only, ideal for LLMs and RAG).

## Homepage

- [MachineMail: email API for AI agents](/content/site-root.html): Every agent gets its own email address, for free, and nothing in the inbox can hijack it. A trust report on every message, AgentMail-compatible API. (506 words)

## Articles & Blog Posts

- [docs/reference/api/organization-md.html](/content/docs/reference/api/organization-md.html) (3,489 words)
- [docs/reference/api/lists-md.html](/content/docs/reference/api/lists-md.html) (1,694 words)
- [docs/cli/commands/messages-md.html](/content/docs/cli/commands/messages-md.html) (2,561 words)
- [docs/reference/api/agent-auth-md.html](/content/docs/reference/api/agent-auth-md.html) (3,560 words)
- [docs/reference/api/metrics-md.html](/content/docs/reference/api/metrics-md.html) (1,373 words)
- [docs/reference/authentication-md.html](/content/docs/reference/authentication-md.html) (3,618 words)
- [docs/reference/api/events-md.html](/content/docs/reference/api/events-md.html) (1,420 words)
- [docs/agents/mcp-md.html](/content/docs/agents/mcp-md.html) (3,664 words)
- [docs/reference/api/export/index.html](/content/docs/reference/api/export/index.html) (70 words)
- [Organization · MachineMail Docs](/content/docs/reference/api/organization/index.html): Read, update and delete your MachineMail organization, invite and manage its members, and check the plan, its allowances and usage in the current period. (127 words)
- [docs/reference/limits-md.html](/content/docs/reference/limits-md.html) (2,389 words)
- [docs/agents/auth-md-md.html](/content/docs/agents/auth-md-md.html) (2,185 words)
- [docs/agents/clients-md.html](/content/docs/agents/clients-md.html) (2,476 words)
- [docs/cli/commands/webhooks-md.html](/content/docs/cli/commands/webhooks-md.html) (2,054 words)
- [docs/trust/trust-report-md.html](/content/docs/trust/trust-report-md.html) (2,394 words)
- [docs/reference/errors-md.html](/content/docs/reference/errors-md.html) (2,093 words)
- [docs/getting-started/quickstart-md.html](/content/docs/getting-started/quickstart-md.html) (1,905 words)
- [docs/reference/mcp-tools-md.html](/content/docs/reference/mcp-tools-md.html) (1,924 words)
- [docs/guides/custom-domain-md.html](/content/docs/guides/custom-domain-md.html) (2,064 words)
- [docs/reference/api/cli-auth-md.html](/content/docs/reference/api/cli-auth-md.html) (1,705 words)
- [docs/getting-started/from-agentmail-md.html](/content/docs/getting-started/from-agentmail-md.html) (2,383 words)
- [docs/guides/attachments-md.html](/content/docs/guides/attachments-md.html) (1,472 words)
- [docs/cli/commands/drafts-md.html](/content/docs/cli/commands/drafts-md.html) (1,346 words)
- [docs/reference/agentmail-compatibility-md.html](/content/docs/reference/agentmail-compatibility-md.html) (986 words)
- [docs/concepts/webhooks-md.html](/content/docs/concepts/webhooks-md.html) (1,243 words)
- [docs/cli/commands-md.html](/content/docs/cli/commands-md.html) (1,000 words)
- [docs/reference/api/pods-md.html](/content/docs/reference/api/pods-md.html) (898 words)
- [docs/guides/give-an-agent-an-inbox-md.html](/content/docs/guides/give-an-agent-an-inbox-md.html) (1,327 words)
- [docs/concepts/api-keys-md.html](/content/docs/concepts/api-keys-md.html) (1,515 words)
- [docs/cli/commands/inboxes-md.html](/content/docs/cli/commands/inboxes-md.html) (1,455 words)
- [docs/reference/api/inbound-md.html](/content/docs/reference/api/inbound-md.html) (1,332 words)
- [docs/cli/commands/domains-md.html](/content/docs/cli/commands/domains-md.html) (990 words)
- [compare/openmail-md.html](/content/compare/openmail-md.html) (2,285 words)
- [docs/reference/rate-limits-md.html](/content/docs/reference/rate-limits-md.html) (1,562 words)
- [docs/cli/commands/api-keys-md.html](/content/docs/cli/commands/api-keys-md.html) (820 words)
- [docs/concepts/threads-and-messages-md.html](/content/docs/concepts/threads-and-messages-md.html) (1,264 words)
- [docs/guides/realtime-events-md.html](/content/docs/guides/realtime-events-md.html) (1,529 words)
- [docs/reference/api/mcp-md.html](/content/docs/reference/api/mcp-md.html) (142 words)
- [docs/concepts/organizations-and-pods-md.html](/content/docs/concepts/organizations-and-pods-md.html) (1,968 words)
- [docs/reference/api/suppressions-md.html](/content/docs/reference/api/suppressions-md.html) (714 words)
- [docs/guides/verify-webhooks-md.html](/content/docs/guides/verify-webhooks-md.html) (1,303 words)
- [docs/reference/api/trust-md.html](/content/docs/reference/api/trust-md.html) (622 words)
- [docs/cli/agent-workflows-md.html](/content/docs/cli/agent-workflows-md.html) (1,723 words)
- [docs/concepts/events-md.html](/content/docs/concepts/events-md.html) (1,132 words)
- [docs/trust/classifier-md.html](/content/docs/trust/classifier-md.html) (1,372 words)
- [docs/concepts/domains-md.html](/content/docs/concepts/domains-md.html) (1,186 words)
- [Authentication · MachineMail Docs](/content/docs/reference/authentication/index.html): How to authenticate with the MachineMail API: API keys, key scopes and permissions, agent access tokens, and the dashboard session, passkeys and invitations. (3,677 words)
- [docs/reference/api/connected-apps-md.html](/content/docs/reference/api/connected-apps-md.html) (659 words)
- [compare/agentmail-md.html](/content/compare/agentmail-md.html) (2,016 words)
- [MCP tools · MachineMail Docs](/content/docs/reference/mcp-tools/index.html): The tools, resources and triage prompt of MachineMail's remote MCP server at /mcp, with its transport, authentication, permissions and errors. (3,583 words)
- [docs/cli/commands/mail-md.html](/content/docs/cli/commands/mail-md.html) (1,163 words)
- [docs/cli/commands/trusted-domains-md.html](/content/docs/cli/commands/trusted-domains-md.html) (1,016 words)
- [docs/guides/multi-tenant-with-pods-md.html](/content/docs/guides/multi-tenant-with-pods-md.html) (1,090 words)
- [docs/trust/using-trust-in-agents-md.html](/content/docs/trust/using-trust-in-agents-md.html) (1,627 words)
- [docs/cli/commands/threads-md.html](/content/docs/cli/commands/threads-md.html) (938 words)
- [docs/cli/output-and-scripting-md.html](/content/docs/cli/output-and-scripting-md.html) (1,251 words)
- [Webhook events · MachineMail Docs](/content/docs/reference/webhook-events/index.html): Every MachineMail webhook event type and its payload, the event envelope, delivery retries and replay, and how to verify the signature on each delivery. (2,694 words)
- [docs/guides/reply-in-thread-md.html](/content/docs/guides/reply-in-thread-md.html) (904 words)
- [Metrics · MachineMail Docs](/content/docs/reference/api/metrics/index.html): Query MachineMail metrics for the organization, a pod or an inbox: event counts over a time range, rolling bounce and complaint rates, and current usage. (1,446 words)
- [docs/concepts/inboxes-md.html](/content/docs/concepts/inboxes-md.html) (1,074 words)
- [docs/guides/team-and-security-md.html](/content/docs/guides/team-and-security-md.html) (1,014 words)
- [docs/trust/authentication-md.html](/content/docs/trust/authentication-md.html) (1,288 words)
- [docs/concepts/trusted-domains-md.html](/content/docs/concepts/trusted-domains-md.html) (1,092 words)
- [docs/guides/otp-and-signups-md.html](/content/docs/guides/otp-and-signups-md.html) (993 words)
- [docs/cli/commands/lists-md.html](/content/docs/cli/commands/lists-md.html) (794 words)
- [docs/trust/content-md.html](/content/docs/trust/content-md.html) (1,523 words)
- [docs/trust/links-md.html](/content/docs/trust/links-md.html) (1,119 words)
- [docs/cli/authentication-md.html](/content/docs/cli/authentication-md.html) (1,216 words)
- [docs/cli/commands/events-md.html](/content/docs/cli/commands/events-md.html) (842 words)
- [docs/concepts/sending-md.html](/content/docs/concepts/sending-md.html) (878 words)
- [docs/reference/pagination-md.html](/content/docs/reference/pagination-md.html) (558 words)
- [docs/cli/troubleshooting-md.html](/content/docs/cli/troubleshooting-md.html) (1,072 words)
- [docs/reference/webhook-events-md.html](/content/docs/reference/webhook-events-md.html) (457 words)
- [docs/getting-started/agent-quickstart-md.html](/content/docs/getting-started/agent-quickstart-md.html) (870 words)
- [docs/reference/api/agent-registrations-md.html](/content/docs/reference/api/agent-registrations-md.html) (464 words)
- [docs/cli/commands/metrics-md.html](/content/docs/cli/commands/metrics-md.html) (685 words)
- [docs/cli/commands/pods-md.html](/content/docs/cli/commands/pods-md.html) (368 words)
- [docs/concepts/lists-and-suppressions-md.html](/content/docs/concepts/lists-and-suppressions-md.html) (818 words)
- [docs/guides/search-and-export-md.html](/content/docs/guides/search-and-export-md.html) (797 words)
- [docs/agents/claiming-md.html](/content/docs/agents/claiming-md.html) (872 words)
- [docs/guides/api-key-for-an-agent-md.html](/content/docs/guides/api-key-for-an-agent-md.html) (697 words)
- [docs/trust-md.html](/content/docs/trust-md.html) (863 words)
- [docs/reference-md.html](/content/docs/reference-md.html) (813 words)
- [docs/concepts/drafts-md.html](/content/docs/concepts/drafts-md.html) (561 words)
- [docs/cli/commands/setup-md.html](/content/docs/cli/commands/setup-md.html) (540 words)
- [docs/cli/commands/suppressions-md.html](/content/docs/cli/commands/suppressions-md.html) (397 words)
- [docs/reference/api/export-md.html](/content/docs/reference/api/export-md.html) (327 words)
- [docs/guides/approve-drafts-md.html](/content/docs/guides/approve-drafts-md.html) (744 words)
- [docs/cli/configuration-md.html](/content/docs/cli/configuration-md.html) (752 words)
- [docs/cli/commands/auth-md.html](/content/docs/cli/commands/auth-md.html) (594 words)
- [docs/cli/installation-md.html](/content/docs/cli/installation-md.html) (669 words)
- [compare/index-md.html](/content/compare/index-md.html) (114 words)
- [docs/getting-started-md.html](/content/docs/getting-started-md.html) (775 words)
- [docs/guides/connect-an-agent-md.html](/content/docs/guides/connect-an-agent-md.html) (938 words)
- [Errors · MachineMail Docs](/content/docs/reference/errors/index.html): The MachineMail API error envelope, every error type and the messages each area returns, plus agent onboarding and MCP errors and how to handle them. (2,009 words)
- [docs/guides/review-quarantine-md.html](/content/docs/guides/review-quarantine-md.html) (900 words)
- [docs/agents-md.html](/content/docs/agents-md.html) (577 words)
- [docs/cli/commands/config-md.html](/content/docs/cli/commands/config-md.html) (416 words)
- [docs/cli/commands/org-md.html](/content/docs/cli/commands/org-md.html) (577 words)
- [docs/trust/attachments-md.html](/content/docs/trust/attachments-md.html) (729 words)
- [docs/cli/commands/agent-registrations-md.html](/content/docs/cli/commands/agent-registrations-md.html) (299 words)
- [docs/cli-md.html](/content/docs/cli-md.html) (521 words)
- [docs/reference/api/auth-md.html](/content/docs/reference/api/auth-md.html) (308 words)
- [docs/cli/commands/import-md.html](/content/docs/cli/commands/import-md.html) (554 words)
- [docs/index-md.html](/content/docs/index-md.html) (515 words)
- [docs/reference/api/objects-md.html](/content/docs/reference/api/objects-md.html) (15,442 words)
- [docs/reference/api/dashboard-auth-md.html](/content/docs/reference/api/dashboard-auth-md.html) (9,034 words)
- [docs/reference/api/health-md.html](/content/docs/reference/api/health-md.html) (192 words)
- [webhooks · MachineMail Docs](/content/docs/cli/commands/webhooks/index.html): Webhook endpoints, deliveries and replay. The `machinemail webhooks` commands: arguments, flags, examples and the API routes they call. (1,952 words)
- [docs/cli/commands/utilities-md.html](/content/docs/cli/commands/utilities-md.html) (281 words)
- [docs/cli/commands/connected-apps-md.html](/content/docs/cli/commands/connected-apps-md.html) (211 words)
- [docs/cli/commands/inbound-md.html](/content/docs/cli/commands/inbound-md.html) (275 words)
- [docs/reference/api/api-keys-md.html](/content/docs/reference/api/api-keys-md.html) (2,905 words)
- [docs/cli/commands/profiles-md.html](/content/docs/cli/commands/profiles-md.html) (192 words)
- [docs/reference/api/openapi-md.html](/content/docs/reference/api/openapi-md.html) (102 words)
- [Pods · MachineMail Docs](/content/docs/reference/api/pods/index.html): Create, list, update and delete pods: groups of inboxes, domains and webhooks that keep each tenant separate inside one MachineMail organization. (918 words)
- [docs/cli/commands/health-md.html](/content/docs/cli/commands/health-md.html) (146 words)
- [Events · MachineMail Docs](/content/docs/reference/api/events/index.html): Read MachineMail's replayable event log for the organization, a pod or an inbox, or follow events live over Server-Sent Events or a WebSocket. (1,217 words)
- [Limits · MachineMail Docs](/content/docs/reference/limits/index.html): Plan limits and how they are enforced, and inbox, address, TTL, message, attachment, batch, sandbox and retention limits. (2,371 words)
- [Agent Auth · MachineMail Docs](/content/docs/reference/api/agent-auth/index.html): MachineMail's authorization server: OAuth sign-in with PKCE and client registration for apps and MCP clients, and the auth.md agent onboarding endpoints. (1,372 words)
- [messages · MachineMail Docs](/content/docs/cli/commands/messages/index.html): Send, receive, search and manage messages. The `machinemail messages` commands: arguments, flags, examples and the API routes they call. (1,086 words)
- [docs/reference/api/trusted-domains-md.html](/content/docs/reference/api/trusted-domains-md.html) (3,159 words)
- [docs/reference/api/domains-md.html](/content/docs/reference/api/domains-md.html) (2,715 words)
- [docs/reference/api/webhooks-md.html](/content/docs/reference/api/webhooks-md.html) (4,328 words)
- [docs/reference/api/drafts-md.html](/content/docs/reference/api/drafts-md.html) (3,287 words)
- [docs/reference/api/messages-md.html](/content/docs/reference/api/messages-md.html) (6,199 words)
- [docs/reference/api/threads-md.html](/content/docs/reference/api/threads-md.html) (3,657 words)
- [docs/reference/api/inboxes-md.html](/content/docs/reference/api/inboxes-md.html) (2,285 words)
- [docs/llms-txt.html](/content/docs/llms-txt.html) (1,934 words)
- [auth.md registration · MachineMail Docs](/content/docs/agents/auth-md/index.html): How an AI agent registers itself with MachineMail through auth.md: discovery, the three registration types, tokens and scopes, sandbox limits and revocation. (2,257 words)
- [inboxes · MachineMail Docs](/content/docs/cli/commands/inboxes/index.html): Inboxes (an inbox id is its email address). The `machinemail inboxes` commands: arguments, flags, examples and the API routes they call. (1,211 words)
- [Quickstart · MachineMail Docs](/content/docs/getting-started/quickstart/index.html): Sign up with a magic link, get an API key, create an inbox, send an email and receive replies by polling, webhook and Server-Sent Events. (1,539 words)
- [MachineMail vs AgentMail · MachineMail](/content/compare/agentmail/index.html): Both give AI agents email addresses and serve the same /v0 API. MachineMail checks every inbound message before the agent sees it. AgentMail has the broader product. Here is where each one is ahead, with a source for every claim. (2,040 words)
- [API keys · MachineMail Docs](/content/docs/concepts/api-keys/index.html): How MachineMail API keys work, how to scope them to a pod or a single inbox, and how to limit them to specific permissions. (1,452 words)
- [Suppressions · MachineMail Docs](/content/docs/reference/api/suppressions/index.html): List, add, check and remove the addresses MachineMail will not send to. Permanent bounces and complaints add an address to the suppression list automatically. (779 words)
- [Switching from AgentMail · MachineMail Docs](/content/docs/getting-started/from-agentmail/index.html): MachineMail serves AgentMail's /v0 API. Change the base URL and API key, keep your code and SDKs, and gain trust reports, catch-all and ephemeral inboxes. (2,323 words)
- [CLI Auth · MachineMail Docs](/content/docs/reference/api/cli-auth/index.html): The device authorization endpoints (RFC 8628) behind CLI sign-in: start a sign-in, approve or deny it in the browser, and poll until the CLI receives its key. (1,307 words)
- [auth-md.html](/content/auth-md.html) (704 words)
- [MachineMail vs OpenMail · MachineMail](/content/compare/openmail/index.html): Both give AI agents their own inboxes through an API. MachineMail checks every inbound message before the agent reads it and includes a free custom domain. OpenMail keeps data in the EU on every plan. Where each is ahead, with sources. (2,278 words)
- [Privacy Policy · MachineMail](/content/privacy/index.html): What MachineMail collects, why, who processes it, how long we keep it and how to get it deleted. We don't sell your data or train models on your mail. (3,182 words)
- [Rate limits · MachineMail Docs](/content/docs/reference/rate-limits/index.html): Which MachineMail endpoints are rate limited (sign-in, agent registration, claims, sandbox sends, MCP feedback), their limits and the 429 response. (1,520 words)
- [Use a custom domain · MachineMail Docs](/content/docs/guides/custom-domain/index.html): Add your own domain to MachineMail: publish MX, SPF, DKIM and DMARC records by hand, from a zone file or with Domain Connect, verify it and turn on catch-all. (2,061 words)
- [Webhooks · MachineMail Docs](/content/docs/concepts/webhooks/index.html): MachineMail webhooks POST signed events to your HTTPS endpoint, filtered by event type, pod or inbox, with retries for five days and a replayable delivery log. (1,217 words)
- [MCP server · MachineMail Docs](/content/docs/agents/mcp/index.html): The hosted MachineMail MCP server - endpoint, stateless Streamable HTTP transport, OAuth sign-in or an API key, and the tools, resources and prompt it exposes. (2,300 words)
- [Client setup · MachineMail Docs](/content/docs/agents/clients/index.html): Connect ChatGPT, Claude, Cursor, VS Code, Codex, Gemini CLI and other MCP clients to the hosted MachineMail MCP server, signing in with OAuth or an API key. (2,031 words)
- [Command reference · MachineMail Docs](/content/docs/cli/commands/index.html): Every machinemail command, generated from the CLI's own command tree: usage, arguments, flags with types and defaults, examples and the API routes they call. (975 words)
- [Inbound · MachineMail Docs](/content/docs/reference/api/inbound/index.html): Store a raw RFC 5322 message in your inboxes as if it had been received. Requires the inbound_raw permission; authentication results in the message are ignored. (641 words)
- [MCP · MachineMail Docs](/content/docs/reference/api/mcp/index.html): The remote MCP server endpoint (stateless JSON-RPC over Streamable HTTP), its description document and signed attachment links, with API key or OAuth auth. (816 words)
- [Realtime events · MachineMail Docs](/content/docs/guides/realtime-events/index.html): Consume MachineMail events live over Server-Sent Events or WebSocket: filters, keepalives, reconnection, backfill from the event log and dedupe by event_id. (1,483 words)
- [Threads and messages · MachineMail Docs](/content/docs/concepts/threads-and-messages/index.html): How MachineMail groups messages into threads, labels and read state, what extracted_text and the trust report give your agent, and attachments and raw MIME. (1,240 words)
- [Organizations and pods · MachineMail Docs](/content/docs/concepts/organizations-and-pods/index.html): How MachineMail groups resources. An organization owns everything; pods split it into isolated groups, such as one per end customer. (1,876 words)
- [drafts · MachineMail Docs](/content/docs/cli/commands/drafts/index.html): Drafts, and sends scheduled for later. The `machinemail drafts` commands: arguments, flags, examples and the API routes they call. (1,190 words)
- [domains · MachineMail Docs](/content/docs/cli/commands/domains/index.html): Custom domains, DNS records, catch-all. The `machinemail domains` commands: arguments, flags, examples and the API routes they call. (887 words)
- [Trust · MachineMail Docs](/content/docs/reference/api/trust/index.html): Fetch the trust report for an inbound message: trust level and score, authentication results, sender, content, link and attachment checks and classification. (89 words)
- [Give an agent an inbox · MachineMail Docs](/content/docs/guides/give-an-agent-an-inbox/index.html): Build the full loop for an email-driven agent. Create an inbox, wait for mail, read the trust report, act, reply in the same thread and mark the message read. (1,091 words)
- [blog/one-pixel-font-md.html](/content/blog/one-pixel-font-md.html) (977 words)
- [trusted-domains · MachineMail Docs](/content/docs/cli/commands/trusted-domains/index.html): Manage the domains and addresses whose signed mail is never quarantined, for the organization, a pod or an inbox, from the MachineMail CLI: flags and examples. (1,164 words)
- [Mail workflow · MachineMail Docs](/content/docs/cli/commands/mail/index.html): The MachineMail CLI mail commands: send a message, read one with its trust verdict, wait for a message or a verification code, and tail events live. (883 words)
- [Attachments · MachineMail Docs](/content/docs/trust/attachments/index.html): How MachineMail rates inbound attachments low, medium or high risk from their extension, declared type and actual bytes, and which ones get extracted text. (657 words)
- [api-keys · MachineMail Docs](/content/docs/cli/commands/api-keys/index.html): Organization, pod and inbox scoped keys. The `machinemail api-keys` commands: arguments, flags, examples and the API routes they call. (645 words)
- [Pagination · MachineMail Docs](/content/docs/reference/pagination/index.html): How MachineMail list endpoints page with limit, page_token and next_page_token: walking every page, sort order, and the endpoints that page differently. (539 words)
- [Multi-tenant apps with pods · MachineMail Docs](/content/docs/guides/multi-tenant-with-pods/index.html): Isolate each customer in its own pod with its own inboxes, domains, webhooks, lists, events and pod-scoped API keys, all in one MachineMail organization. (1,045 words)
- [Output and scripting · MachineMail Docs](/content/docs/cli/output-and-scripting/index.html): How the MachineMail CLI picks tables or JSON, NDJSON streams, --json, --fields and --all, errors and exit codes, CI behavior and scripting patterns with jq. (1,235 words)
- [Using trust in agents · MachineMail Docs](/content/docs/trust/using-trust-in-agents/index.html): Patterns for agents that read email: gate tool use on the trust level, respect quarantine, feed the model only agent-safe text and wrap email as untrusted data. (1,494 words)
- [Domains · MachineMail Docs](/content/docs/concepts/domains/index.html): Add your own domain to MachineMail for custom addresses and catch-all: DNS records, verification states, DNS host detection, Domain Connect and the zone file. (1,242 words)
- [mcp/index.html](/content/mcp/index.html) (43 words)
- [AgentMail compatibility · MachineMail Docs](/content/docs/reference/agentmail-compatibility/index.html): How MachineMail's /v0 API compares with AgentMail's: what works the same, what differs, what is missing, how to switch and what MachineMail adds. (961 words)
- [Connected Apps · MachineMail Docs](/content/docs/reference/api/connected-apps/index.html): List the apps and MCP clients people in your organization connected to MachineMail with OAuth, and disconnect one to revoke its tokens immediately. (516 words)
- [Events · MachineMail Docs](/content/docs/concepts/events/index.html): Everything that happens in MachineMail is recorded as an event. Read the event log, stream events over SSE or WebSocket, or receive them as webhooks. (1,140 words)
- [Agent workflows · MachineMail Docs](/content/docs/cli/agent-workflows/index.html): MachineMail CLI commands built for agents: throwaway inboxes and wait --otp for sign-ups, read with trust verdicts, send, tail live mail, register and claim. (1,343 words)
- [Reply in thread · MachineMail Docs](/content/docs/guides/reply-in-thread/index.html): Reply, reply-all and forward from an inbox, keep conversations threaded with In-Reply-To and References, prepare replies as drafts, and label whole threads. (831 words)
- [lists · MachineMail Docs](/content/docs/cli/commands/lists/index.html): Manage allow and block lists for the organization, a pod or an inbox from the MachineMail CLI: create, get, list and delete entries, with flags and examples. (741 words)
- [OTP codes and sign-up flows · MachineMail Docs](/content/docs/guides/otp-and-signups/index.html): Receive sign-up verification codes and magic links in ephemeral or catch-all inboxes, extract them safely using the trust report, and let the inbox expire. (1,005 words)
- [Lists · MachineMail Docs](/content/docs/reference/api/lists/index.html): Allow and block lists for the organization, a pod or an inbox. A non-empty allow list is allow-only: it blocks mail from every sender not on it. (138 words)
- [Authentication · MachineMail Docs](/content/docs/cli/authentication/index.html): Sign the MachineMail CLI in through the browser or with an API key in CI, keep several keys in profiles, log out and revoke, and see where the key is stored. (1,214 words)
- [Inboxes · MachineMail Docs](/content/docs/concepts/inboxes/index.html): The addresses your agents own: named, generated, ephemeral and catch-all inboxes, the shared machinemail.dev domain, custom domains, pausing and deletion. (983 words)
- [Authentication · MachineMail Docs](/content/docs/trust/authentication/index.html): How MachineMail gets SPF, DKIM and DMARC results for inbound mail without trusting forgeable headers, checks From alignment and feeds the trust level and score. (1,262 words)
- [Search and export · MachineMail Docs](/content/docs/guides/search-and-export/index.html): Find messages, threads and inboxes with full-text search and filters, fetch messages in batches, and export an inbox as mbox or JSON lines. (751 words)
- [Verify webhooks · MachineMail Docs](/content/docs/guides/verify-webhooks/index.html): Verify the X-MachineMail-Signature header on webhook deliveries in TypeScript, Python and Go, reject replays, dedupe retries, and test or replay deliveries. (889 words)
- [Terms of Service · MachineMail](/content/terms/index.html): The rules for using MachineMail: acceptable use, sending limits, your agents, plans, termination and liability. (1,846 words)
- [Trusted domains · MachineMail Docs](/content/docs/concepts/trusted-domains/index.html): Mark the domains and addresses you work with as trusted, so their genuinely signed mail is never quarantined or withheld from your agents. (1,061 words)
- [metrics · MachineMail Docs](/content/docs/cli/commands/metrics/index.html): Counts and rates. The `machinemail metrics` commands: arguments, flags, examples and the API routes they call. (570 words)
- [Installation · MachineMail Docs](/content/docs/cli/installation/index.html): Install the machinemail CLI on macOS, Linux or Windows, pin a version, and set up shell completions for bash, zsh and fish. (627 words)
- [Invite your team and secure your account · MachineMail Docs](/content/docs/guides/team-and-security/index.html): Invite people to a MachineMail organization, set roles, add passkeys, turn off email codes, sign out other sessions, and switch, create or delete organizations. (974 words)
- [Acceptable Use Policy · MachineMail](/content/acceptable-use/index.html): What you and your agents may send with MachineMail: permitted use, banned content, rules for agents, sending standards, enforcement and how to report abuse. (1,636 words)
- [Drafts · MachineMail Docs](/content/docs/concepts/drafts/index.html): Drafts let an agent prepare a message without sending it, for human review or for scheduled sending with send_at. (704 words)
- [Classifier · MachineMail Docs](/content/docs/trust/classifier/index.html): How MachineMail's two-stage classifier scores inbound mail for injection and phishing, rules first and a hosted model second, and what each output field means. (1,316 words)
- [Troubleshooting · MachineMail Docs](/content/docs/cli/troubleshooting/index.html): Diagnose MachineMail CLI problems with doctor and --verbose, and fix common errors: missing or rejected keys, an unreachable API, broken config and timeouts. (988 words)
- [MachineMail: email API for AI agents](/content/signup/index.html): Every agent gets its own email address, for free, and nothing in the inbox can hijack it. A trust report on every message, AgentMail-compatible API. (33 words)
- [Connect an agent without code · MachineMail Docs](/content/docs/guides/connect-an-agent/index.html): Give an AI agent a MachineMail inbox from the dashboard: claim it with the agent prompt, approve an MCP app or approve the CLI, then manage access in Settings. (910 words)
- [Auth · MachineMail Docs](/content/docs/reference/api/auth/index.html): GET /v0/auth/me returns the credential making the request: its organization, pod and inbox and its permissions. Use it to discover what a key can reach. (68 words)
- [Sending · MachineMail Docs](/content/docs/concepts/sending/index.html): Sending from a MachineMail inbox: from addresses, display names, recipients, reply-to, text and HTML bodies, headers, attachments, replies, forwards and limits. (831 words)
- [Trust report · MachineMail Docs](/content/docs/trust/trust-report/index.html): Every field of the trust report attached to inbound messages, how level and score are computed, and a full JSON example. (949 words)
- [Sign-in and setup · MachineMail Docs](/content/docs/cli/commands/setup/index.html): MachineMail CLI commands to sign in and out, show and check the credential in use with whoami and doctor, and register or claim an agent without a human. (947 words)
- [Claiming an agent · MachineMail Docs](/content/docs/agents/claiming/index.html): How a human claims an agent that registered through auth.md: entering the 6-digit code on the dashboard, what the claim changes, expiry, and revoking agents. (815 words)
- [OpenAPI · MachineMail Docs](/content/docs/reference/api/openapi/index.html): Fetch the MachineMail OpenAPI 3.1 document as JSON from GET /v0/openapi.json, with no authentication, to generate clients or load the API into your tools. (50 words)
- [Links · MachineMail Docs](/content/docs/trust/links/index.html): How MachineMail checks every link in inbound mail for mismatched text, lookalike and punycode domains, raw IPs, shorteners and brand impersonation. (1,028 words)
- [Configuration · MachineMail Docs](/content/docs/cli/configuration/index.html): Where the CLI keeps its config file and what is in it, profiles, the config keys, the base URL and every environment variable it reads. (716 words)
- [Lists and suppressions · MachineMail Docs](/content/docs/concepts/lists-and-suppressions/index.html): Allow and block lists control who can email your inboxes and who they can send to. Suppressions stop sending to addresses that bounced or complained. (790 words)
- [Webhooks · MachineMail Docs](/content/docs/reference/api/webhooks/index.html): Create and manage webhook endpoints for the organization, a pod or an inbox: set custom headers, send test events, list deliveries and replay failed ones. (8,445 words)
- [Health · MachineMail Docs](/content/docs/reference/api/health/index.html): Liveness and readiness checks for the MachineMail API, with no authentication: /health while the process serves requests, /health/ready when storage answers. (135 words)
- [Agent quickstart · MachineMail Docs](/content/docs/getting-started/agent-quickstart/index.html): Paste one prompt into Claude Code, Cursor, Codex or OpenCode and the agent signs itself up through auth.md, gets a sandbox inbox and asks you to claim it. (773 words)
- [Trusted Domains · MachineMail Docs](/content/docs/reference/api/trusted-domains/index.html): Domains and addresses the organization, a pod or an inbox trusts: mail they genuinely sign is never quarantined or withheld from agents. Preview an entry first. (7,316 words)
- [Attachments · MachineMail Docs](/content/docs/guides/attachments/index.html): Send files as base64 or from a URL, embed inline images, download attachments from received mail, and check their trust risk before an agent opens one. (618 words)
- [Review quarantined mail · MachineMail Docs](/content/docs/guides/review-quarantine/index.html): Find quarantined threads in the MachineMail dashboard, read the trust report, compare agent-safe and raw views, then release it or block the sender's domain. (842 words)
- [Threads · MachineMail Docs](/content/docs/reference/api/threads/index.html): List, search, read, update and delete conversation threads in MachineMail, across the whole organization, within a pod or in a single inbox. (8,271 words)
- [What is MachineMail · MachineMail Docs](/content/docs/getting-started/index.html): An email API for AI agents: each agent gets its own address, every inbound message carries a trust report, and the /v0 API is wire-compatible with AgentMail. (693 words)
- [auth · MachineMail Docs](/content/docs/cli/commands/auth/index.html): Sign in with an API key and inspect the credential. The `machinemail auth` commands: arguments, flags, examples and the API routes they call. (566 words)
- [suppressions · MachineMail Docs](/content/docs/cli/commands/suppressions/index.html): Addresses we will not send to. The `machinemail suppressions` commands: arguments, flags, examples and the API routes they call. (344 words)
- [CLI · MachineMail Docs](/content/docs/cli/index.html): The machinemail command line tool - what it covers, how to install it and sign in, and the first commands to run, from a terminal or a script. (465 words)
- [agent-registrations · MachineMail Docs](/content/docs/cli/commands/agent-registrations/index.html): Agent registrations bound to the organization. The `machinemail agent-registrations` commands: arguments, flags, examples and the API routes they call. (225 words)
- [Objects · MachineMail Docs](/content/docs/reference/api/objects/index.html): Every object the MachineMail API accepts or returns, field by field, with types and required fields. Endpoint pages link here for nested objects. (14,341 words)
- [Create a key for an agent · MachineMail Docs](/content/docs/guides/api-key-for-an-agent/index.html): Create a narrow MachineMail API key for one agent from the dashboard or the API: pick its scope and permissions, copy it once, hand it over, revoke it later. (622 words)
- [API overview · MachineMail Docs](/content/docs/reference/index.html): MachineMail API conventions: the base URL, /v0 versioning, authentication, requests and responses, pagination, idempotency, request IDs, CORS and scoped routes. (792 words)
- [Messages · MachineMail Docs](/content/docs/reference/api/messages/index.html): Send, reply to, forward, list, search, read and update messages in a MachineMail inbox, one at a time or in batches, and download attachments and raw MIME. (10,840 words)
- [config · MachineMail Docs](/content/docs/cli/commands/config/index.html): Read and change CLI settings (config file, keys masked). The `machinemail config` commands: arguments, flags, examples and the API routes they call. (351 words)
- [Trust layer · MachineMail Docs](/content/docs/trust/index.html): Why email is a prompt-injection vector for AI agents, what MachineMail checks on every inbound message, and where the resulting trust report shows up. (822 words)
- [events · MachineMail Docs](/content/docs/cli/commands/events/index.html): Replayable event log and live streams. The `machinemail events` commands: arguments, flags, examples and the API routes they call. (351 words)
- [org · MachineMail Docs](/content/docs/cli/commands/org/index.html): The authenticated organization. The `machinemail org` commands: arguments, flags, examples and the API routes they call. (489 words)
- [Approve drafts before they send · MachineMail Docs](/content/docs/guides/approve-drafts/index.html): Review the drafts your agents save in the MachineMail dashboard: edit them, send now or retry a failed send, undo a send in the first seconds, or delete them. (673 words)
- [import · MachineMail Docs](/content/docs/cli/commands/import/index.html): Copy pods, domains, inboxes, webhooks and allow and block lists from AgentMail into MachineMail with the import agentmail command: flags and examples. (543 words)
- [Drafts · MachineMail Docs](/content/docs/reference/api/drafts/index.html): Create, update, send and delete drafts: unsent messages a person or agent can review before they go out, including sends scheduled for later with send_at. (6,340 words)
- [Domains · MachineMail Docs](/content/docs/reference/api/domains/index.html): Add custom domains to MachineMail, get their DNS records, zone file and Domain Connect setup, verify them and turn on catch-all, for the organization or a pod. (6,649 words)
- [Pricing · MachineMail](/content/pricing/index.html): Every inbox is free. Free covers 3,000 messages a month; Pro is $9, Team $49 and Scale $199 a month, metered per message and per stored GB. (513 words)
- [Utilities · MachineMail Docs](/content/docs/cli/commands/utilities/index.html): MachineMail CLI utility commands: open the dashboard in a browser, print a shell completion script for bash, zsh or fish, and print the CLI version. (232 words)
- [Dashboard Auth · MachineMail Docs](/content/docs/reference/api/dashboard-auth/index.html): Cookie-session endpoints behind the MachineMail dashboard: sign-in codes, magic links, passkeys, invitations, organizations and sessions. Not for integrations. (9,908 words)
- [Agents · MachineMail Docs](/content/docs/agents/index.html): The three ways an AI agent uses MachineMail - the REST API, the hosted MCP server, and self-registration through auth.md - and how to choose between them. (519 words)
- [MachineMail Docs](/content/docs/index.html): Email for AI agents. Every agent gets its own address for free, and every inbound message arrives with a trust report so nothing in the inbox can hijack it. (366 words)
- [Agent Registrations · MachineMail Docs](/content/docs/reference/api/agent-registrations/index.html): List, inspect and revoke the agents that registered themselves through auth.md and are bound to your MachineMail organization. Needs an organization key. (95 words)
- [connected-apps · MachineMail Docs](/content/docs/cli/commands/connected-apps/index.html): Apps and MCP clients connected with OAuth. The `machinemail connected-apps` commands: arguments, flags, examples and the API routes they call. (166 words)
- [inbound · MachineMail Docs](/content/docs/cli/commands/inbound/index.html): Inject raw RFC 5322 messages (needs the inbound_raw permission). The `machinemail inbound` commands: arguments, flags, examples and the API routes they call. (223 words)
- [profiles · MachineMail Docs](/content/docs/cli/commands/profiles/index.html): Named sets of API key and base URL; switch between them. The `machinemail profiles` commands: arguments, flags, examples and the API routes they call. (122 words)
- [health · MachineMail Docs](/content/docs/cli/commands/health/index.html): Liveness and readiness. The `machinemail health` commands: arguments, flags, examples and the API routes they call. (108 words)
- [pricing-md.html](/content/pricing-md.html) (513 words)
- [Content scrubbing · MachineMail Docs](/content/docs/trust/content/index.html): How MachineMail turns inbound mail into agent-safe text by stripping hidden text, invisible Unicode, HTML tricks, quoted history and boilerplate. (173 words)
- [MachineMail compared · MachineMail](/content/compare/index.html): How MachineMail compares with other email services for AI agents, claim by claim, with a source for each one. (118 words)
- [MachineMail Blog](/content/blog/index.html): Notes from the team building MachineMail: email for AI agents, and the trust layer that keeps the inbox from hijacking them. (51 words)
- [API Keys · MachineMail Docs](/content/docs/reference/api/api-keys/index.html): Create, list, update and delete MachineMail API keys scoped to the whole organization, to one pod or to a single inbox, each with its own permissions. (6,438 words)
- [A 1px font hid a whole password reset · MachineMail Blog](/content/blog/one-pixel-font/index.html): An agent asked X for a reset code. The email passed every check, and our trust layer showed the agent an empty message. Here is why, and what we changed. (961 words, 2026-10-19)

## About Pages

- [About MachineMail](/content/about/index.html): MachineMail is an email API for AI agents. Free inboxes, a trust report on every inbound message, and an AgentMail-compatible API. (422 words)
- [Contact MachineMail](/content/contact/index.html): How to reach MachineMail: email support for account and API help, report abuse, check service status, and find the docs, OpenAPI document and source. (185 words)

## Resources

- [Full Page Index](/index.html): Browse all cached pages with rich metadata
- [About This Cache](/about.html): Methodology, technical details, and usage guidelines
- [XML Sitemap](/sitemap.xml): Machine-readable sitemap for crawler discovery
- [Robots.txt](/robots.txt): Crawler directives
- [Agentsite Network](https://agentsite.network/network.html): Public index of Agentsites and their machine-readable resources