AgentMail

AgentMail is an API-first email platform that gives AI agents their own email inboxes to autonomously send, receive, reply to, and act on email. Unlike traditional transactional email APIs built for one-way notifications, AgentMail is designed for two-way threaded conversations: agents create inboxes on demand, read and semantically search messages, manage threads and drafts for human-in-the-loop review, apply labels and allow/block lists, and react to inbound mail in real time over webhooks or WebSockets. It ships a REST API (OpenAPI 3.1), an AsyncAPI 2.6 WebSocket surface, Python/Node/Go SDKs, a CLI, a hosted MCP server, and IMAP/SMTP bridges, with API-key permissions, idempotency, multi-tenant pods, custom domains, and SOC 2 Type I/II compliance.

AgentMail publishes 1 API on the APIs.io network. Tagged areas include Company, Ai, Email, API, and AI Agents.

The AgentMail catalog on APIs.io includes 1 event-driven AsyncAPI specification.

AgentMail’s developer surface includes documentation, API reference, getting-started guide, engineering blog, pricing, signup flow, support, and 27 more developer resources.

🌐 Visit website 📡 Source on GitHub

46.4/100 developing Agent 84/100 agent native Full breakdown ↓
scored 2026-07-20 · rubric v0.4

1 APIs 1 MCP Servers 0 Features

CompanyAiEmailAPIAI AgentsInboxMessagingWebhooksWebSocketsSMTPIMAPMCPAgenticDeveloper Tools

API Rating

API Evangelist Rating How this is scored →
scored 2026-07-20 · rubric v0.4

Composite quality — 46.4/100 · developing

Contract Quality 9.4 / 25

Developer Ergonomics 16.1 / 20

Commercial Clarity 7.9 / 20

Operational Transparency 3.8 / 13

Governance 0.0 / 12

Discoverability 9.3 / 10

Agent readiness — 84/100 · agent native

Machine-Readable Contract 18 / 18

Agentic Access Contract 15 / 15

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 9 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 0 / 7

Typed Event Surface 6 / 6

Agent Skills 5 / 5

Well-Known Catalog 4 / 4

Consent & Bot Identity 0 / 3

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/agentmail: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

Get Started 3

Portal, sign-up, and the first successful call

DeveloperPortal

DeveloperPortal

GettingStarted

GettingStarted

SignUp

SignUp

Documentation 4

Reference material describing how the API behaves

Documentation

APIReference

OpenAPI

AsyncAPI

Agent Surfaces 5

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

MCPServer

LLMsTxt

WellKnown

AgentSkill

Design & Contract 7

Pagination, idempotency, versioning, errors, and events

Webhooks

Conformance

ErrorCatalog

Lifecycle

Conventions

Idempotency

DataModel

Scroll for all 7

Build 4

SDKs, sample code, and the tooling you integrate with

GitHubOrganization

Packages

SDKs

CLI

Access & Security 4

Authentication, authorization, and security posture

Authentication

DomainSecurity

Compliance

TrustCenter

Operate 3

Status, limits, changes, and where to get help

Support

Support

ChangeLog

ChangeLog

ChangeLog

ChangeLog

Commercial 1

Pricing, plans, and the legal terms of use

Pricing

Pricing

Company 1

The organization behind the API

Blog

Blog

Other 2

Properties that don't map to a standard resource type

Overlay

Overlay

APICatalog

APICatalog

Source (apis.yml)

aid: agentmail
name: AgentMail
description: 'AgentMail is an API-first email platform that gives AI agents their own email inboxes to autonomously send,
  receive, reply to, and act on email. Unlike traditional transactional email APIs built for one-way notifications, AgentMail
  is designed for two-way threaded conversations: agents create inboxes on demand, read and semantically search messages,
  manage threads and drafts for human-in-the-loop review, apply labels and allow/block lists, and react to inbound mail in
  real time over webhooks or WebSockets. It ships a REST API (OpenAPI 3.1), an AsyncAPI 2.6 WebSocket surface, Python/Node/Go
  SDKs, a CLI, a hosted MCP server, and IMAP/SMTP bridges, with API-key permissions, idempotency, multi-tenant pods, custom
  domains, and SOC 2 Type I/II compliance.'
image: https://www.agentmail.to/logo.png
url: https://raw.githubusercontent.com/api-evangelist/agentmail/refs/heads/main/apis.yml
x-type: company
x-source: general-catalyst-portfolio
x-tier: stub
x-tier-reason: portfolio-lead
specificationVersion: '0.20'
created: '2026-07-17'
modified: '2026-07-17'
tags:
- Company
- Ai
- Email
- API
- AI Agents
- Inbox
- Messaging
- Webhooks
- WebSockets
- SMTP
- IMAP
- MCP
- Agentic
- Developer Tools
apis:
- name: AgentMail API
  description: REST API for creating inboxes and sending, receiving, searching, and managing threaded email for AI agents.
    OpenAPI 3.1; Bearer API-key auth.
  humanURL: https://docs.agentmail.to
  baseURL: https://api.agentmail.to
  properties:
  - type: OpenAPI
    url: openapi/agentmail-openapi-original.yml
  - type: AsyncAPI
    url: asyncapi/agentmail-websockets-asyncapi.yml
  - type: Documentation
    url: https://docs.agentmail.to
  - type: APIReference
    url: https://docs.agentmail.to/api-reference
  - type: Overlay
    url: overlays/agentmail-openapi-overlay.yaml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: DeveloperPortal
  url: https://docs.agentmail.to
- type: Documentation
  url: https://docs.agentmail.to
- type: APIReference
  url: https://docs.agentmail.to/api-reference
- type: GettingStarted
  url: https://docs.agentmail.to/quickstart
- type: Blog
  url: https://www.agentmail.to/blog
- type: Pricing
  url: https://www.agentmail.to/pricing
- type: SignUp
  url: https://console.agentmail.to
- type: Support
  url: https://docs.agentmail.to/support
- type: GitHubOrganization
  url: https://github.com/agentmail-to
- type: ChangeLog
  url: https://docs.agentmail.to/changelog
- type: OpenAPI
  url: openapi/agentmail-openapi-original.yml
- type: AsyncAPI
  url: asyncapi/agentmail-websockets-asyncapi.yml
- type: Webhooks
  url: https://docs.agentmail.to/webhooks-overview
- type: Overlay
  url: overlays/agentmail-openapi-overlay.yaml
- type: Authentication
  url: authentication/agentmail-authentication.yml
- type: AgenticAccess
  url: agentic-access/agentmail-agentic-access.yml
- type: DomainSecurity
  url: security/agentmail-domain-security.yml
- type: Packages
  url: packages/agentmail-packages.yml
- type: SDKs
  url: packages/agentmail-packages.yml
- type: CLI
  url: cli/agentmail-cli.yml
- type: MCPServer
  url: mcp/agentmail-mcp.yml
- type: LLMsTxt
  url: llms/agentmail-llms.txt
- type: WellKnown
  url: well-known/agentmail-well-known.yml
- type: APICatalog
  url: well-known/agentmail-api-catalog.json
- type: Conformance
  url: conformance/agentmail-conformance.yml
- type: Compliance
  url: https://docs.agentmail.to/documentation/resources/security-privacy/soc-2-compliance
- type: TrustCenter
  url: security/agentmail-trust-center.yml
- type: ErrorCatalog
  url: errors/agentmail-error-codes.yml
- type: Lifecycle
  url: lifecycle/agentmail-lifecycle.yml
- type: Conventions
  url: conventions/agentmail-conventions.yml
- type: Idempotency
  url: conventions/agentmail-conventions.yml
- type: ChangeLog
  url: changelog/agentmail-changelog.yml
- type: DataModel
  url: data-model/agentmail-data-model.yml
- type: AgentSkill
  url: skills/_index.yml
x-enrichment:
  date: '2026-07-19'
  status: backfilled
  pass: local-v1
  note: backfilled from .gitignore signal + verified work evidence

AgentMail

API Rating

APIs

AgentMail API

MCP Servers

agentmail-mcp.yml

Event Specifications

API Reference

Resources