Postmark MCP server for your AI

Bounces by type per day: { Days: [ { Date, HardBounce, SoftBounce, SMTPApiError, Transient } ], HardBounce, SoftBounce, SMTPApiError, Transient }.

Link clicks: { Days: [ { Date, Clicks, Unique } ], Clicks, Unique }.

Opens: { Days: [ { Date, Opens, Unique } ], Opens, Unique }.

Headline sending stats for a date range: { Sent, Bounced, SMTPApiErrors, BounceRate, SpamComplaints, SpamComplaintsRate, Opens, UniqueOpens, Tracked, WithOpenTracking, WithLinkTracking, TotalTrackedLinksSent, UniqueLinksClicked, TotalClicks, WithClientRecorded, WithPlatformRecorded }.

One inbound email in full: headers, TextBody, HtmlBody, StrippedTextReply, attachments metadata, BlockedReason and processing history.

Everything about one sent email, including its body and MessageEvents (Delivered, Bounced, Opened, LinkClicked, SubscriptionChanged, Transient) with timestamps and details.

Search email received on the server's inbound address.

Search sent email (Postmark keeps it for the account's retention period, 45 days by default).

List sending domains in the account (needs the Account API token): { TotalCount, Domains: [ { ID, Name, DKIMVerified, ReturnPathDomainVerified, … } ] }.

Create a template (Mustachio syntax: {{var}}, {{#each items}}…{{/each}}).

Subscribe a URL to delivery events (Delivery, Bounce, SpamComplaint, Open, Click, SubscriptionChange) on one message stream.

Status of a bulk send: { Id, SubmittedAt, Status (Accepted | Processing | Completed | …), TotalMessages, PercentageCompleted, ReleasedCount, FailedCount, Subject }.

One template with its full content: { TemplateId, Name, Alias, Subject, HtmlBody, TextBody, TemplateType, LayoutTemplate, Active, AssociatedServerId }.

List templates on this server: { TotalCount, Templates: [ { TemplateId, Name, Alias, TemplateType (Standard | Layout), LayoutTemplate, Active } ] }.

List event webhooks on the server: { Webhooks: [ { ID, Url, MessageStream, Status (verified | unverified), HttpAuth, HttpHeaders, Triggers } ] }.

Broadcast one message to many recipients (newsletters, announcements) on a broadcast stream.

Send one email (transactional by default).

Send up to 500 different emails in one call (each with its own recipients/content).

Send up to 500 templated emails in one call.

Send one email rendered from a stored Postmark template: give TemplateAlias (or TemplateId) plus TemplateModel (the variables).

Edit a template.

Check template syntax and preview the render without saving anything.

List message streams on the server: { MessageStreams: [ { ID, Name, Description, MessageStreamType (Transactional | Broadcasts | Inbound), CreatedAt, ArchivedAt, SubscriptionManagementConfiguration } ], TotalCount }.

List sender signatures (individually confirmed From addresses) in the account (needs the Account API token): { TotalCount, SenderSignatures: [ { ID, Domain, EmailAddress, ReplyToEmailAddress, Name, Confirmed } ] }.

Reactivate an address Postmark deactivated after a bounce so you can send to it again (only when the bounce's CanActivate is true; hard bounces usually mean the address is dead).

One bounce with its full details (Type, Description, Details, Email, BouncedAt, Inactive, CanActivate, Content when available).

Bounce summary for the server: { InactiveMails, Bounces: [ { Type, Name, Count } ] } (counts per bounce type, plus how many addresses are deactivated).

Search bounces.

List every server in the Postmark account (needs the Account API token): { TotalCount, Servers: [ { ID, Name, Color, DeliveryType, ServerLink, InboundAddress, … } ] }.

Stop sending to up to 50 addresses on a stream (ManualSuppression).

Allow sending again to up to 50 suppressed addresses on a stream.

Addresses Postmark will not send to on a stream: { Suppressions: [ { EmailAddress, SuppressionReason (HardBounce | SpamComplaint | ManualSuppression), Origin (Recipient | Customer | Admin), CreatedAt } ] }.

Settings of the connected Postmark server: { ID, Name, Color, DeliveryType (Live | Sandbox), ServerLink, InboundAddress, InboundHash, SmtpApiActivated, TrackOpens, TrackLinks, InboundHookUrl, InboundSpamThreshold, … }.

Diagnose why an address is or isn't receiving email: checks the recent messages sent to it, its bounces, and whether the message stream suppresses it, then says what's wrong and which tool fixes it.

Clicks by browser family (Chrome, Safari, …): { Days: [ { Date, <browser>: count } ], <browser>: total }.

Whether clicks came from the HTML or the text part: { Days: [ { Date, HTML, Text } ], HTML, Text }.

Clicks by platform: { Days: [ { Date, Desktop, Mobile, Unknown } ], Desktop, Mobile, Unknown }.

Opens by email client (Apple Mail, Gmail, Outlook, …): { Days: [ { Date, <client>: count } ], <client>: total }.

Opens by platform: { Days: [ { Date, Desktop, Mobile, WebMail, Unknown } ], Desktop, Mobile, WebMail, Unknown }.

How long recipients kept emails open, bucketed by seconds: { Days: [ { Date, 0, 1, …, 20+ } ], … }.

Emails sent: { Days: [ { Date, Sent } ], Sent }.

Spam complaints: { Days: [ { Date, SpamComplaint } ], SpamComplaint }.

Emails sent with open or link tracking: { Days: [ { Date, Tracked } ], Tracked }.

Let a blocked inbound message (status blocked, e.g. by an inbound rule or spam threshold) through to your inbound webhook.

The raw MIME source of a sent email: { Body }.

Link-click events for one sent message: { TotalCount, Clicks: [ … ] }.

Open events for one sent message: { TotalCount, Opens: [ … ] }.

Retry delivering a failed inbound message to your inbound webhook (after fixing the webhook).

Link-click events across messages: { TotalCount, Clicks: [ { RecordType, MessageID, Recipient, ReceivedAt, OriginalLink, ClickLocation (HTML | Text), Client, OS, Platform, Geo, Tag } ] }.

Open events across messages: { TotalCount, Opens: [ { RecordType, MessageID, Recipient, ReceivedAt, FirstOpen, Client, OS, Platform, Geo, UserAgent, Tag, MessageStream } ] }.

Add a sending domain (needs the Account API token).

Remove a sending domain from the account.

One domain with the DNS records to publish.

Start a DKIM key rotation: Postmark issues a new key (DKIMPendingHost/DKIMPendingTextValue) that the user must publish; the old key keeps working until the new one verifies.

Change a domain's custom Return-Path.

Re-check the domain's DKIM TXT record now (after the user has published it).

Re-check the domain's Return-Path CNAME now.

Delete a template (a layout cannot be deleted while templates still use it).

Delete a webhook.

One webhook by ID.

Delivery health of one webhook over the last 24 hours: { Statuses, TimeRange, Metrics: { TotalRequests, SuccessCount, FailureCount, RetryCount, SuccessRate, SlowCount, AverageTerminalResponseTimeMs, … }, MetricsByTrigger }.

List bulk sends on this server, newest first: { Requests: [status objects], PaginationKey }.

Copy templates (matched by Alias) from one server to another, creating or updating them on the destination.

Change a webhook's URL, auth, headers or triggers.

Send a test event for every enabled trigger to the webhook URL.

Archive a stream: sending stops and its data is purged after 45 days (ExpectedPurgeDate).

Create a message stream.

Add a From address.

Remove a sender signature; that From address stops working.

One message stream by ID.

One sender signature with its confirmation and DNS status.

Email the confirmation link for an unconfirmed sender signature again.

Restore an archived stream before its purge date.

Rename a stream or change its description / unsubscribe handling.

Change a sender signature's name, reply-to, Return-Path or confirmation note.

Create a server (needs the Account API token).

Permanently delete a server and everything in it (needs the Account API token; Postmark must have enabled server deletion for the account, otherwise ErrorCode 604).

The raw SMTP source of the bounce message: { Body }.

One server's settings by ID (needs the Account API token).

Change any server's settings by ID (needs the Account API token).

Block inbound mail from a sender address or a whole domain.

Remove an inbound blocking rule.

List inbound blocking rules: { TotalCount, InboundRules: [ { ID, Rule } ] } (each Rule is a sender address or domain whose inbound mail is blocked).

GDPR/privacy request: permanently delete everything Postmark stores about one recipient address across the account (needs the Account API token).

Status of a data removal request: { ID, Status }.

Change settings of the connected server (name, color, tracking defaults, inbound webhook URL/domain, spam threshold, SMTP).