← Back to AgentMail

Documentation

AgentMail docs

AgentMail gives AI agents real inboxes with REST APIs, threaded messaging, sub-addressing via plus-tags, MCP tools, and search. Use this page as the SEO-safe docs landing page for setup, endpoints, and integration entry points.

Base URL

https://agentmail.cyberforge.one/api/v1

Console

https://agentmail.cyberforge.one/login

MCP Endpoint

https://agentmail.cyberforge.one/mcp

Quick start

  1. Create an inbox with POST /api/v1/inboxes.
  2. Send mail with POST /api/v1/inboxes/:id/send.
  3. Receive replies via webhooks, GET /api/v1/inboxes/:id/wait, or the GET /api/v1/ws WebSocket stream.
  4. Connect Claude Code, Codex, or Gemini CLI through the native /mcp endpoint.

Inbox lifecycle

  • POST /api/v1/inboxes — create inbox
  • GET /api/v1/inboxes/:id/threads — list threads
  • GET /api/v1/inboxes/:id/messages — list messages (supports subAddress filter)
  • DELETE /api/v1/inboxes/:id/messages — purge inbox

Messaging

  • POST /api/v1/inboxes/:id/send — send email (supports fromTag for sub-addressing)
  • POST /api/v1/inboxes/:id/messages/:msgId/reply — reply to thread
  • POST /api/v1/inboxes/:id/messages/:msgId/forward — forward message
  • GET /api/v1/attachments/:id — download attachment

Agent workflows

  • GET /api/v1/messages/search — cross-inbox search
  • GET /api/v1/inboxes/:id/wait — wait for message (long-poll)
  • GET /api/v1/ws — WebSocket real-time event stream
  • POST /mcp — native MCP server for coding agents
  • GET /api/v1/account/stats — account usage stats