AgentMail | Email Inbox API for AI Agents

# AgentMail: Email for AI Agents # # If you are an AI agent and need email, follow these steps in order: # # Step 0: Check if AGENTMAIL_API_KEY is already set in your environment. # If it is, skip to "Connect" below. You're ready to go. # # Step 1: If you do NOT have an API key, sign up by calling: # # curl -X POST https://api.agentmail.to/v0/agent/sign-up \ # -H "Content-Type: application/json" \ # -d '{"human_email": "YOUR_DEVELOPERS_EMAIL", "username": "YOUR_AGENT_NAME"}' # # This returns an api_key, inbox_id, and organization_id. # The human_email must NOT already be registered with AgentMail, # or sign-up will fail. An OTP will be sent to that email. # # Then verify with the OTP: # # curl -X POST https://api.agentmail.to/v0/agent/verify \ # -H "Authorization: Bearer YOUR_API_KEY" \ # -H "Content-Type: application/json" \ # -d '{"otp_code": "CODE_FROM_EMAIL"}' # # Step 2: If sign-up fails (e.g. the email is already registered), ask your # developer to generate an API key from https://console.agentmail.to # and set it as AGENTMAIL_API_KEY in your environment. # # Step 3 (Connect): You now have two ways to use AgentMail — pick one: # # MCP — if your client speaks MCP (Claude Code, Claude Desktop, Cursor, # Windsurf, etc.), connect directly to the first-party hosted server: # # claude mcp add --transport http agentmail https://mcp.agentmail.to/mcp # # Clients that support MCP OAuth (Claude Desktop, Claude.ai, Claude Code) # authenticate automatically — OAuth clients need no API key, so steps # 1-2 are optional for them. Clients configured with an API key pass it # through the supported request header: # # endpoint: https://mcp.agentmail.to/mcp # header: x-api-key: YOUR_API_KEY # # REST — call the API directly (see Quick Start below) if you're not #

{ "openapi": "3.0.1", "info": { "title": "api", "version": "" }, "paths": { "/v0/inboxes": { "get": { "operationId": "inboxes_list", "tags": [ "Inboxes" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/Limit", "nullable": true } }, { "na