Postmark MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Postmark MCP or direct API to send transactional emails, fetch delivery analytics, manage message streams, and troubleshoot deliverability—all through natural language.

Postmark logoPostmark
Api Key

Postmark is an email delivery service for sending transactional emails with reliable deliverability. It delivers detailed analytics and fast, secure email delivery for developers.

46 Tools

Try Postmark now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Postmark
Try asking
TOOLS

Supported Tools

Every Postmark action and event your agent gets out of the box.

Archive Message Stream

Tool to archive a message stream (soft delete).

Check Spam Score

Tool to assess the spam score of a raw email via the SpamCheck API.

Create Inbound Rule

Tool to create a new inbound rule trigger to block email from a specific sender or domain.

Create Message Stream

Tool to create a new message stream.

Create Suppressions

Tool to add email addresses to the suppression list for a message stream.

Create Template

Tool to create a new email template.

Create Webhook

Tool to create a new webhook configuration for Postmark.

Delete Inbound Rule

Tool to delete a specific inbound rule trigger.

Delete Suppressions

Tool to remove email addresses from the suppression list for a message stream.

Delete Template

Tool to delete a template by its ID or alias.

Delete Webhook

Tool to delete a specific webhook.

Edit Server

Tool to update settings for the current Postmark server.

Edit Template

Tool to update an existing Postmark template by its ID.

Edit Webhook

Tool to update an existing webhook’s URL or triggers.

Get Bounce Counts

Tool to get total counts of emails that have been returned as bounced.

Get Bounces

Tool to retrieve a list of bounces for a server with optional filters.

Get Browser Platform Usage

Tool to retrieve browser platform usage statistics for clicked links.

Get Browser Usage

Tool to retrieve browser usage statistics for clicked links.

Get Click Counts

Tool to retrieve total click counts across all links in emails.

Get Clicks By Browser Family

Tool to retrieve click statistics grouped by browser family.

Get Clicks by Location

Tool to get an overview of which part of the email links were clicked from (HTML or Text).

Get Delivery Stats

Tool to retrieve delivery statistics.

Get Email Client Usage

Tool to retrieve statistics on email clients used to open emails.

Get Email Open Counts

Tool to retrieve counts of opened emails.

Get Message Stream

Tool to retrieve details of a specific message stream by its ID.

Get Opens by Platform

Tool to retrieve email open statistics by platform type.

Get Outbound Overview

Tool to retrieve outbound email statistics overview.

Get Sent Counts

Tool to retrieve total count of emails sent out.

Get Server

Tool to retrieve details of the current Postmark server.

Get Spam Complaints

Tool to retrieve counts of spam complaints.

Get Template

Tool to retrieve details of a specific template by its ID.

Get Tracked Email Counts

Tool to retrieve counts of emails with tracking enabled.

Get Webhook

Tool to retrieve details of a specific webhook by its ID.

List Inbound Rules

Tool to list all inbound rules (triggers) configured for blocking senders.

List Message Streams

Tool to list all message streams for a Postmark server with optional type and archive filtering.

List Outbound Message Clicks

Tool to list clicks for outbound messages with filtering options.

List Outbound Message Opens

Tool to retrieve opens for outbound messages with filtering options.

List Suppressions

Tool to retrieve the suppression list for a message stream with optional filtering.

List Templates

Tool to list all templates for a Postmark server.

List Webhooks

Tool to list all webhooks configured for your Postmark account.

Search Inbound Messages

Tool to search inbound messages received with optional filtering.

Search Outbound Messages

Tool to search outbound messages with filtering by recipient, tag, status, and date range.

Send Batch Templated Emails

Tool to send multiple templated emails in a single batch API call.

Unarchive Message Stream

Tool to unarchive a previously archived message stream.

Update Message Stream

Tool to update a message stream configuration in Postmark.

Validate Template

Tool to validate a Postmark template.

SETUP GUIDE

Connect Postmark MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK and Claude Agent SDK
2

Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
Initialize the Composio client and create a Tool Router session
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'Send a password reset email to user@example.com using the default template' }],
  stopWhen: stepCountIs( 5 )
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent
SETUP GUIDE

Connect Postmark API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Postmark Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Send a password reset email to user@example.com using the default template'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Postmark actions with your Agent

Why Use Composio?

AI Native Postmark Integration

  • Supports both Postmark MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for sending, tracking, and querying your Postmark email activity

Managed Auth

  • Built-in API key management with secure storage
  • Central place to manage, scope, and revoke Postmark access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Postmark
  • Scoped, least privilege access to Postmark resources
  • Full audit trail of agent actions to support review and compliance
FAQ

Frequently asked questions

Yes, Postmark requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Postmark.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Postmark tool your agent needs.Free to start.

Start building