API v1Private beta. The API is stable; send limits are low while the shared domain warms up.

Integrations

Agent frameworks

send0's tools for the Vercel AI SDK, LangChain.js, LangChain for Python and MCP.

send0 ships the same nine tools for each way you build an agent. Names, arguments and output text are identical everywhere, so a prompt that works with one works with all of them.

Install

npm i @send0/ai-sdk ai zod                  # Vercel AI SDK
npm i @send0/langchain @langchain/core zod  # LangChain.js
pip install langchain-send0                 # LangChain for Python
npx -y @send0/mcp                           # MCP server over stdio

Tools

ToolWhat it doesKind
create_inboxCreate an address like signup-agent@send0.emailCreates
list_inboxesList the inboxes the API key can useRead-only
wait_for_emailBlock until a matching email arrives (or arrived in the last minute); returns the extracted code and linkRead-only
search_messagesFull-text search, or filter by sender (*@github.com) and directionRead-only
get_messageRead one message, new text only unless full_textRead-only
list_threadsList conversations, most recent firstRead-only
get_threadRead a whole conversation, oldest firstRead-only
send_emailSend a new email, starting a threadSends
replyReply in the same thread, with the right In-Reply-To and ReferencesSends

Arguments are listed in the MCP tools reference. Tools that take inbox_id fall back to the default inbox you configure.

What every integration does

  • Errors become text. An API error comes back to the model as send0 error <code>: <message>, for example send0 error recipient_not_allowed: …, so it can pick another recipient or tell you, instead of the run failing.
  • Email is untrusted. Tools that return mail wrap each body in <untrusted_email> tags with a note to treat it as data, and messages flagged for prompt injection carry a warning. Tags inside an email are neutralized, so a sender can't close the block early.
  • Sending can wait for a person. Each integration can put send_email and reply behind its framework's approval flow, or leave them out entirely. An inbox with the approval send policy turns every send into a draft on the server side too.

Give an agent an API key with read and send scopes, limited to its inbox. See API keys.

On this page