Build with AI
Give your AI coding assistant what it needs to build with Postmark: the knowledge to write correct code, and, if you want, a direct line to your account.
- Skills teach your agent how to buildInstall Postmark Skills so your coding agent writes sending code correctly the first time.Install the skills
- Connect your account to mcpAdd the Postmark MCP server so your assistant can send email, manage templates and check delivery for you.Connect the server
Which one do you need?
| Skills | MCP server | |
|---|---|---|
| What it does | Teaches your agent how to write Postmark code | Lets your agent act on your Postmark account |
| Best for | Building Postmark into your app | Sending, managing and checking email from a chat |
| Needs your token | No | Yes |
| Works with | Claude Code, Cursor, GitHub Copilot, OpenAI Codex, Gemini CLI, and other tools that read Markdown files | Claude Desktop, Cursor, Windsurf, and other MCP clients |
Most people use both: Skills while building the integration, the MCP server for day-to-day work.
Teach your agent with Skills
Postmark Skills are open source Agent Skills that teach AI coding agents to write Postmark code correctly. They help stop outdated endpoints, missing Message Stream handling and methods that don't exist. Each skill is a folder with a SKILL.md file of best practices, code examples, API details and common mistakes, which your agent reads before it writes code.
What they cover
- Sending email. Single, batch and template sends, the Bulk API, Message Streams, error handling and retries, attachments.
- Inbound email. Reply threading, email-to-ticket systems, attachment extraction, MailboxHash routing.
- Templates. Handlebars templates, layouts, validation, moving templates between servers.
- Webhooks. Delivery, bounce, open, click, spam complaint and subscription change events, and their payloads.
- Email best practices. SPF, DKIM and DMARC, compliance, list management, sending reliability.
Install them
Code
To install just one:
Code
Once they're installed, your agent uses them when they're relevant. You don't need to mention them. It also detects your project's language and uses the matching library.
Then ask for things in plain words:
The skills are on GitHub at ActiveCampaign/postmark-skills. Spotted a gap? Open an issue or a pull request.
Let your agent act with the MCP server
The Postmark MCP server gives your assistant 24 tools to send email, manage templates, look at bounces and suppressions, and check delivery stats, from inside the chat.
Connect it in three steps
- Get your details. A Postmark server token (open your server, then API Tokens) and a verified sender address. You'll also need Node.js 22 or newer.
- Add this to your client's MCP settings. It's the same block for Claude Desktop, Cursor, Windsurf and others.
Code
- Restart your client and just... ask!
The server can do everything its token can, so use a dedicated Postmark server for it, and don't auto-approve tools that send or delete. The MCP server docs have the full guide, every tool, and where each client keeps its settings.
More for AI tools
- MCP server docsThe full connection guide and all 24 tools.
- AI promptsReady-made prompts for working with Postmark in your AI tool.
- llms.txtPostmark's documentation in a format AI tools can read.
- Postmark Skills on GitHubThe source, the full list of skills and how to contribute.
- Postmark MCP server on GitHubThe source for the official server, with setup details and releases.