← Back to AgentMail

Documentation

AgentMail docs

AgentMail gives AI agents real inboxes with REST APIs, threaded messaging, MCP tools, and search. Use this page as the 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 or GET /api/v1/inboxes/:id/wait.
  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
  • DELETE /api/v1/inboxes/:id/messages — purge inbox

Messaging

  • POST /api/v1/inboxes/:id/send — send email
  • 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)
  • POST /mcp — native MCP server for coding agents
  • GET /api/v1/account/stats — account usage stats