# Postmark MCP

> Postmark MCP manages transactional email delivery directly through your AI client. Use this connector to send high-volume emails in batches or individually, manage all templates, and track real-time bounce rates without leaving your chat interface. It lets you audit sender domains, check performance statistics, and monitor account health programmatically.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** transactional-email, email-delivery, template-management, bounce-tracking, api-integration

## Description

Connecting Postmark gives your agent full control over transactional email operations. You stop logging into dashboards to check send metrics or look up failed messages. Instead, you just ask your AI client for what you need: 'Show me all bounces from last week' or 'List the current marketing templates.' The MCP lets you manage template content and verify domains used for sending. It handles everything from single-message sends to large batches of emails, ensuring consistent messaging every time. Because this entire catalog lives within Vinkius, connecting your agent means gaining instant access to all these vital email tools in one place.

## Tools

### get_delivery_stats
Retrieves a report detailing overall email delivery statistics for a specific period.

### get_outbound_stats
Gets delivery metrics specifically related to emails sent out from your account.

### get_template
Fetches the full content and details for a single, specified email template.

### list_bounces
Retrieves a list of recently failed or bounced emails so you can track deliverability issues.

### list_domains
Lists all verified sending domains that your Postmark account is authorized to use.

### list_outbound_messages
Retrieves a list of messages that have been successfully sent from your account.

### list_account_servers
Provides an overview and listing of all active servers associated with your Postmark account.

### list_email_templates
Generates a comprehensive list of every email template available in your catalog.

### send_batch_email
Sends multiple emails to a group of recipients simultaneously using defined templates.

### send_email
Sends a single, immediate transactional email to one or more recipients.

### get_server_info
Retrieves specific configuration details and status information for your connected Postmark server.

## Prompt Examples

**Prompt:** 
```
Send a transactional email from support@example.com to john@doe.com with subject 'Reset Password'.
```

**Response:** 
```
I've sent the email. The message ID is '123-abc-456' and it was successfully accepted by Postmark.
```

**Prompt:** 
```
Show me all email bounces from the last 7 days and identify the main failure patterns.
```

**Response:** 
```
47 bounces in the last 7 days (1.2% bounce rate). Hard bounces: 28 (invalid addresses), Soft bounces: 14 (mailbox full), Spam complaints: 5. Top offending domain: outlook.com with 12 bounces. 8 addresses were auto-suppressed after repeated failures. Your sender reputation score remains healthy at 97/100. Recommendation: clean 28 invalid addresses from your mailing list to maintain deliverability.
```

**Prompt:** 
```
Send a transactional welcome email to new user sarah@meridian.io using the onboarding template.
```

**Response:** 
```
Welcome email sent successfully via Postmark. Recipient: sarah@meridian.io. Template: "Onboarding Welcome v3" (ID: tpl_2847). Subject: "Welcome to the platform, Sarah!". Message ID: msg_9f3a2b. Delivery confirmed in 0.8 seconds. The template automatically personalized the greeting, included the quickstart guide link, and set the first follow-up email to trigger in 24 hours.
```

## Capabilities

### Send transactional messages
Your agent sends single or bulk emails using verified signatures and defined templates.

### Monitor delivery performance
You retrieve detailed statistics on email delivery, including sent volume and open rates.

### Track bounces and failures
The MCP pulls a history of bounced emails, allowing you to identify failure patterns.

### Manage templates and domains
You can query and get details on existing email templates or list all verified sending domains for audit purposes.

### Audit account settings
Your agent provides information about your entire Postmark server configuration, including listing available servers.

## Use Cases

### The welcome sequence failed to send.
A new user reports they never got the onboarding email. You ask your agent, and it uses `list_outbound_messages` to confirm if an attempt was made, then checks `get_template` to verify the content used. It quickly determines if the problem is sending or template-related.

### We suspect a bad sender domain.
Marketing runs a big campaign and sees poor performance. You ask your agent to run `list_domains` and compare that list against recent bounce data from `list_bounces`. This helps isolate if the issue is with an unverified sending source.

### We need to send 50 personalized emails quickly.
Instead of writing a loop, you simply ask your agent to execute `send_batch_email` using the appropriate template ID. The system sends all messages at once and provides confirmation metrics.

### Audit our entire email setup for compliance.
You tell your agent to run a full audit: check `list_account_servers`, verify templates with `list_email_templates`, and finally pull current performance numbers using `get_delivery_stats`.

## Benefits

- You stop manually compiling reports. Need to know how many emails bounced? Just ask your agent; it uses the `list_bounces` tool to pull a real-time history for you.
- Forget logging into multiple dashboards. You can manage everything—from checking domain status with `list_domains` to reviewing template content using `get_template`—all in one chat window.
- When sending emails, you don't need separate code snippets. Use the dedicated `send_batch_email` tool to handle large campaigns reliably and quickly.
- Debugging delivery issues becomes immediate. If a campaign is underperforming, your agent can run both `get_delivery_stats` and `get_outbound_stats` to pinpoint exactly where the failure happened.
- You gain full control over your infrastructure. You can check the health of your entire setup by running `list_account_servers` or getting granular details using `get_server_info`.

## How It Works

The bottom line is that you manage complex email infrastructure through simple conversational prompts.

1. First, you subscribe to this MCP and provide your unique Postmark Server Token (and optional Account Token) in the Vinkius interface.
2. Next, you trigger a request from your AI client—for example, asking it to 'list recent bounces' or 'send an email.'
3. Finally, the MCP executes the command using your credentials and returns structured data directly back to your conversation.

## Frequently Asked Questions

**How do I find out if my domain is authorized for sending using Postmark MCP?**
You run the `list_domains` tool. This instantly shows you every verified sending domain linked to your account, so you know exactly what domains are safe to use.

**Can I list all templates available in my account with Postmark MCP?**
Yes, the `list_email_templates` tool pulls a full catalog of every template ID and name. This is useful for auditing which versions your team uses.

**What's the difference between sending one email and using Postmark MCP?**
Sending one email uses `send_email`. If you need to send many emails, like a newsletter blast, use `send_batch_email` for efficiency.

**I need to check the history of failed sends using Postmark MCP.**
Use the `list_bounces` tool. It collects and reports on all recent bounces, allowing you to pinpoint invalid addresses or systemic failure patterns.