Agents overview

Give an AI agent its own email address — to send, receive, read threads, and reply.

Most email APIs assume a human wrote the app. Drin assumes an agent might be the one sending and receiving. The same account and key that power your app’s transactional email can give an autonomous agent a real inbox.

An agent can reach every Drin capability four ways — pick whatever fits your stack:

MCP server

npx @drin/mcp exposes 54 tools over the Model Context Protocol — drop it into Claude, Cursor, or any MCP client.

CLI

npx @drin/cli — 51 commands with --json output, ideal for tool-using agents and CI. It can also launch the MCP server (drin mcp).

TypeScript SDK

npm install drin — a typed client for agents written in TS/JS.

Framework adapters

Ready-made tools for LangChain, CrewAI, AutoGen, the Vercel AI SDK, and n8n.

The agent inbox loop

Receiving turns Drin from a send-only API into a two-way channel an agent can live in:

1. Give a domain an inbox

   Enable receiving on a domain, then create an inbox address ([e-mail]). Publish the one MX record Drin returns.

2. Read the conversation

   Poll GET /v1/threads (or subscribe to the inbound_received webhook). A thread joins inbound and outbound messages oldest → newest, so the agent sees the full conversation.

3. Reply in one call

   POST /v1/emails/{id}/reply threads automatically — From, To, Re: subject, and In-Reply-To/References headers are all set for you.

4. Test without DNS

   POST /v1/inbound/simulate runs the full ingest pipeline and fires your webhook, flagged test_mode so it never touches metrics or billing.

Agent Skills

Drin ships Agent Skills — self-contained instruction packs that teach an agent a whole workflow, not just a tool:

Skill	What it teaches
drin-send-email	Pick a verified domain, compose, send, and handle every error path.
drin-build-template	Build cross-client HTML email (Gmail, Outlook, dark mode) with {{merge}} variables.
drin-agent-inbox	Run an autonomous inbox: receive → read threads → reply.
drin-email-best-practices	Deliverability and compliance: SPF/DKIM/DMARC, bounce/complaint limits, unsubscribe.

Set up the MCP server

The fastest way to give an agent email — one command, one key.