Postmark
Getting Started

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.

Which one do you need?

SkillsMCP server
What it doesTeaches your agent how to write Postmark codeLets your agent act on your Postmark account
Best forBuilding Postmark into your appSending, managing and checking email from a chat
Needs your tokenNoYes
Works withClaude Code, Cursor, GitHub Copilot, OpenAI Codex, Gemini CLI, and other tools that read Markdown filesClaude 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

TerminalCode
npx skills add ActiveCampaign/postmark-skills

To install just one:

TerminalCode
npx skills add ActiveCampaign/postmark-skills --skill postmark-send-email

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:

Try askingSend a welcome email using Postmark
Try askingSet up inbound email processing for a support ticket system
Try askingAdd bounce and delivery webhooks to track email status

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

  1. 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.
  2. Add this to your client's MCP settings. It's the same block for Claude Desktop, Cursor, Windsurf and others.
JSONCode
{ "mcpServers": { "postmark": { "command": "npx", "args": ["-y", "@activecampaign/postmark-mcp"], "env": { "POSTMARK_SERVER_TOKEN": "your-postmark-server-token", "DEFAULT_SENDER_EMAIL": "your-sender@example.com", "DEFAULT_MESSAGE_STREAM": "outbound" } } } }
  1. Restart your client and just... ask!
Try askingSend an email to joe@example.com, tell them their order has shipped
Try askingShow me yesterday's email performance

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

Last modified on