@postilon/mcp
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@postilon/mcp Send jane@example.com a note that her invoice is attached, and tell me when it's delivered."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@postilon/mcp
Model Context Protocol server for the Postilon transactional email API. It lets AI assistants such as Claude Desktop, Claude Code and Cursor send email, follow its delivery, read inbound email and manage templates and domains in your Postilon workspace.
Full documentation: postilon.com/docs/mcp. Needs Node.js 18 or later.
Get an API key
In the Postilon dashboard, open API Keys and create a key.
Start with a
ps_test_…key: emails are accepted and reported like real ones, but nothing is delivered and no credits are used.A
ps_live_…key sends real mail from a verified domain. Your assistant can then send email to anyone, so review what it sends.A key with sending access can only use the email tools; the domain, inbound and template tools need full access.
Related MCP server: agentisend
Configuration
Environment variable | Description |
| Your API key (required). |
| Sender used when the assistant gives none, such as |
| Reply-to address used when the assistant gives none. |
| API base URL; defaults to |
Claude Desktop
Open Settings → Developer → Edit Config and add:
{
"mcpServers": {
"postilon": {
"command": "npx",
"args": ["-y", "@postilon/mcp"],
"env": {
"POSTILON_API_KEY": "ps_test_…",
"POSTILON_FROM": "Acme <hello@acme.com>"
}
}
}
}Restart Claude Desktop to load it.
Cursor
Add the same entry to ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project):
{
"mcpServers": {
"postilon": {
"command": "npx",
"args": ["-y", "@postilon/mcp"],
"env": {
"POSTILON_API_KEY": "ps_test_…",
"POSTILON_FROM": "Acme <hello@acme.com>"
}
}
}
}Claude Code
claude mcp add postilon -e POSTILON_API_KEY=ps_test_… -e POSTILON_FROM="Acme <hello@acme.com>" -- npx -y @postilon/mcpTools
Tool | Description |
| Send one email: HTML and/or text, or a template with variables; cc, bcc, reply-to, scheduling and an idempotency key. |
| Send up to 100 emails in one request, each with its own recipient and variables. |
| Get an email with its status and events. |
| List emails, filtered by status, search text, source or age. |
| Cancel a queued or scheduled email. |
| List sending domains and their verification status. |
| Get a domain with its DNS records. |
| Add a sending domain. |
| Check a domain's DNS records now. |
| List received email. |
| Get a received email with its headers and authentication results. |
| List templates. |
| Get a template. |
| Create a template with |
| Change a template. |
| Delete a template. |
Lists return 20 items unless the assistant asks for more. Every tool answers with the API's JSON response, or with the API's error (403 domain_not_verified: …) so the assistant can explain or fix it.
Example prompts
Send jane@example.com a short note saying the invoice is attached to her account, and tell me when it's delivered.
Did any email bounce in the last 7 days? Show me who and why.
Create a welcome template with a first_name variable, then send it to these three addresses.
Add the domain mail.acme.com and tell me which DNS records to create.
Use it in your own server
The package also exports createServer, which builds the MCP server around a client of @postilon/node:
import { createServer } from "@postilon/mcp";
import { Postilon } from "@postilon/node";
const server = createServer(new Postilon(process.env.POSTILON_API_KEY!), { defaultFrom: "hello@acme.com" });
// await server.connect(transport);License
MIT
Available Tools
16 toolsadd_domainAdd domainA
Add a sending domain. The response lists the DNS records to create before calling verify_domain.
Inputs: domain_name (required).
cancel_emailCancel emailADestructiveIdempotent
Cancel a queued or scheduled email before it is sent. Fails with cannot_cancel once delivery started.
Inputs: id (required).
create_templateCreate templateB
Create a template to send with send_email's template_id. Placeholders are written {{ name }}.
Inputs: name (required), variables, html_template, text_template, +1 more.
delete_templateDelete templateADestructiveIdempotent
Delete a template. Emails that use its ID can no longer be sent.
Inputs: id (required).
get_domainGet domainBRead-only
Get one domain with the DNS records it needs and whether each was found.
Inputs: id (required).
get_emailGet emailARead-only
Get one sent email with its status and events (sent, delivered, opened, bounced, …).
Inputs: id (required).
get_inboundGet inbound emailARead-only
Get one received email with its headers, content, attachments list and SPF/DKIM/DMARC results.
Inputs: id (required).
get_templateGet templateARead-only
Get one template with its subject, HTML and text.
Inputs: id (required).
list_domainsList domainsARead-only
List the workspace's sending domains with their verification status.
Inputs: limit, offset.
list_emailsList emailsARead-only
List sent emails, newest first, optionally filtered by status, search text, source or age.
Inputs: q, days, limit, offset, +2 more.
list_inboundList inbound emailARead-only
List email received on the workspace's inbound domains, newest first.
Inputs: q, limit, offset.
list_templatesList templatesCRead-only
List stored email templates.
Inputs: limit, offset.
send_batchSend batchA
Send the same email to up to 100 recipients, one email each, with per-recipient variables. All or nothing: if one is rejected, none is sent.
Inputs: batch (required), from, html, text, +2 more.
send_emailSend emailA
Send one email through Postilon. Give subject with html and/or text, or a template_id with variables. A ps_test_ key accepts and reports the email without delivering it.
Inputs: to (required), cc, bcc, from, +8 more.
update_templateUpdate templateBDestructiveIdempotent
Change a template. Fields left out keep their current value.
Inputs: id (required), name, variables, html_template, +2 more.
verify_domainVerify domainAIdempotent
Check a domain's DNS records now, and mark it verified once the required ones are found.
Inputs: id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
Each tool targets a distinct resource+action pair, and the resource is explicit in the name (email, inbound, template, domain). Overlaps like send_email vs send_batch or get_email vs get_inbound are disambiguated by the descriptions (single vs up to 100 recipients, sent vs received). No two tools appear to do the same thing.
All 16 tools follow a strict snake_case verb_noun pattern (list_/get_/create_/update_/delete_/send_/cancel_/verify_ + resource). The only slight oddity is send_batch naming the shape rather than the object, but it still reads naturally alongside send_email.
16 tools sits at the upper end of comfortable but is justified by four distinct sub-domains (templates, sending, sent-mail inspection, domains, inbound). Each tool maps to a real workflow step, with no filler. Just slightly heavier than ideal.
Templates have full CRUD, emails cover send/get/list/cancel, and domains cover add/list/get/verify. The notable gap is domain lifecycle teardown (no delete_domain or update_domain), and inbound/email data is read-only, but core transactional workflows have no dead ends.
Maintenance
Related MCP Connectors
Send email, manage domains, templates, webhooks and broadcasts from your AI agent.
Send email, manage domains, templates, webhooks and broadcasts from your AI agent.
Transactional email for AI agents: templates, domain verify, and sends.
Send, track, and manage transactional and bulk email delivery
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI agents to send transactional email, authenticate sending domains, track delivery, and diagnose deliverability issues programmatically.1374 npmMIT
- AlicenseAqualityBmaintenanceEnables AI agents to send transactional emails and manage email infrastructure through the AgentiSend API, including domain verification, budgeted keys, and message logs.46MIT

ZapSMTP MCP serverofficial
AlicenseNot gradedqualityBmaintenanceEnables MCP clients to send, receive, and track email and manage templates, domains, webhooks, and other email API operations from AI assistants.122 npmMIT- AlicenseNot gradedqualityBmaintenanceEnables AI agents to inspect verified sending domains and submit transactional emails through hosted tool discovery, schema validation, and policy-governed execution using a single gateway API key.MIT