Agents overview — Drin Docs

An agent can reach every Drin capability four ways — same account, same key. Pick whatever fits the stack you're building in.

MCP servernpx @drin00/mcp exposes 54 tools over the Model Context Protocol — drop it into Claude, Cursor, or any MCP client.CLInpx @drin00/cli — full mutation surface with --json output, ideal for tool-using agents and CI. It can also launch the MCP server (drin mcp).TypeScript SDKnpm install @drin00/sdk — a typed client for agents written in TS/JS, with retries and webhook verification.

Framework adaptersReady-made tools for LangChain, CrewAI, AutoGen, the Vercel AI SDK, and n8n — wired to the same key.

01 The agent inbox loop

Receiving is what turns Drin from a send-only API into a two-way channel an agent can live in. The loop is four moves: give a domain an inbox, read the conversation, reply, and (in development) test the whole thing without DNS.

1
Give a domain an inbox
Enable receiving on a verified domain, then create an inbox address (support@yourdomain.com). Publish the one MX record Drin returns and inbound mail starts flowing.
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 always sees the full conversation.
3
Reply in one call
POST /v1/emails/{id}/reply threads automatically — From, To, the Re: subject, and the 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.

Knowledge plus toolsThe four surfaces above give an agent the tools. Pair them with Agent Skills — instruction packs that give the agent the knowledge of how to use them well.

02 Agent Skills

Drin ships Agent Skills — self-contained instruction packs that teach an agent a whole workflow, not just a single tool call. They're tool-agnostic: the same skill works whether the agent reaches Drin through MCP, the CLI, the SDK, or raw HTTPS.

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.

03 Where to start

Set up the MCP serverThe fastest way to give an agent email — one command, one key, 54 tools.Drive it from the CLIEvery tool is also a command — scriptable, with --json for machine-readable output.Install Agent SkillsTeach the agent the workflows, not just the tools.Build with the SDKA typed client for agents written in TypeScript or JavaScript.