Welcome to AgentPost
Self-hosted email infrastructure built for AI agents
AgentPost is a self-hosted email infrastructure platform designed specifically for AI agents. It gives your agents the ability to create inboxes, send and receive email, manage conversations, and integrate with your existing AI workflows -- all through a powerful REST API, TypeScript and Python SDKs, or the MCP server.
Why AgentPost?
Traditional email services were built for humans. They charge per-inbox, require manual configuration, and weren't designed for programmatic access at scale. AgentPost changes that.
No per-inbox costs. Create as many inboxes as your agents need. A support agent that spins up a dedicated inbox per customer? A deployment bot with separate alert channels per service? No problem -- there are no artificial limits on inbox creation.
Self-hosted and open source. Run AgentPost on your own infrastructure. Your email data stays on your servers. No vendor lock-in, no surprise pricing changes, no third-party access to sensitive communications.
API-first design. Every feature is accessible through the REST API. There is no admin panel action that cannot be automated. The TypeScript and Python SDKs provide typed wrappers, and the MCP server lets AI coding assistants manage email directly.
Real-time event delivery. Webhooks and WebSocket streaming notify your agents the moment an email arrives. No polling, no delays -- your agents react to email in real time.
Production-grade infrastructure. Built on AWS SES for sending, PostgreSQL for storage, and S3-compatible object storage for attachments. SMTP and IMAP protocol servers provide standard email client access when you need it.
What can you build?
AgentPost powers any workflow where AI agents need email:
- Customer support agents that receive, classify, and respond to support tickets
- Deployment notification bots with per-service alert inboxes
- Sales outreach agents that send personalized emails and track replies
- Document processing pipelines that receive email attachments and extract data
- Multi-tenant SaaS platforms where each tenant gets isolated email infrastructure
- Internal workflow automation with email-triggered actions and responses
Platform overview
| Component | Purpose |
|---|---|
| REST API | Full CRUD access to all resources (inboxes, messages, threads, drafts, domains, and more) |
| TypeScript SDK | Typed client library for Node.js and browser environments |
| Python SDK | Client library for Python agent frameworks (LangChain, CrewAI, AutoGen) |
| MCP Server | Model Context Protocol server for AI coding assistants (Claude Code, Cursor) |
| SMTP/IMAP | Standard protocol access for email clients and legacy integrations |
| Webhooks | Real-time event delivery to your endpoints |
| WebSockets | Streaming event subscriptions for live dashboards and agents |
| Web Console | Browser-based management UI for human operators |
Next steps
- Introduction -- Understand the architecture, core concepts, and authentication model
- Quickstart -- Create your first inbox and send an email in under 5 minutes
- Core Concepts -- Deep dive into inboxes, messages, threads, and other resources
- API Reference -- Complete endpoint documentation with request/response examples