# Postmark MCP for AI Agents AI Agent Connect > Postmark MCP for transactional email delivery and template management. Connect your Postmark account to your AI client to send high-deliverability emails, build and validate dynamic templates, and track recipient engagement in real-time. It handles everything from simple one-off notifications to complex bulk distributions without you having to jump back into the dashboard. ## Overview - **Category:** communication-messaging - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_0kWRWI9CKHfn2LoLRpwQevUBwFA4SoruFIdWN2E8/ai-agent-connect - **Tags:** transactional-email, email-api, template-management, postmark, email-delivery ## Description You're tired of jumping between your code editor and the Postmark dashboard just to check if a template is valid or to send a quick test email. This Connector lets your AI client handle the heavy lifting of your email infrastructure directly. It's built for people who need to move fast. Instead of manually copying variables into a template, you can just tell your agent to send a welcome email using a specific alias and let it inject the right data. It also handles the boring stuff like listing your domains, managing webhooks, and checking your bounce stats. Because it's hosted on Vinkius, you get a reliable way to connect these capabilities to your favorite tools like Claude or Cursor. You get to stay in your flow while your agent manages the delivery, tracking, and maintenance of your transactional messages. It's about removing the friction of email operations. Whether you're troubleshooting a bounce or setting up a new domain, you can do it all through a simple conversation with your agent. This means fewer tabs open, fewer errors made, and a much faster way to get your messages into the hands of your customers. From managing sender signatures to validating complex HTML, the scope of what you can automate is huge. You can even handle data removal requests for compliance without having to navigate complex forms. ## Tools ### get_outbound_message_details View the full event history for an outbound message. Use this to track a specific user's journey. ### get_outbound_opens_clients_stats See which email clients are opening your messages. This helps you optimize your designs. ### create_message_stream Create a new message stream for organizing your email traffic. This helps keep different types of notifications separate. ### create_server Set up a new server within your Postmark account. Use this to organize different types of mail sending. ### create_webhook Set up a webhook to receive automated updates on email events. This connects your email data to other apps. ### get_delivery_stats View the overall delivery and bounce statistics. This gives you a high-level view of your health. ### get_outbound_bounces_stats Check the bounce counts for your outbound messages. Use this to identify problematic addresses. ### list_message_streams See all message streams in your account. Use this to organize your email categories. ### request_data_removal Request that recipient data be removed for GDPR or CCPA compliance. This automates your privacy requests. ### create_sender_signature Add a new sender signature at the account level to verify your identity. This improves your deliverability. ### create_suppressions Add up to 50 suppressed addresses to a specific message stream. This prevents sending to invalid addresses. ### create_template Build a new email template for your transactional messages. This lets you reuse layouts for different emails. ### delete_domain Remove an existing domain from your account settings. Use this to clean up your domain list. ### delete_sender_signature Remove a sender signature from your account. Use this when you no longer need a specific signature. ### delete_server Delete a server from your account. This helps keep your account configuration clean. ### delete_suppressions Reactivate suppressed email addresses for a message stream. Use this if a previous bounce was a mistake. ### delete_template Remove a specific email template. This is useful for cleaning up old marketing assets. ### delete_webhook Remove a webhook from a message stream. Use this to stop receiving updates for a specific stream. ### edit_current_server Update the configuration of your current server. This is the fastest way to change server settings. ### edit_domain Modify the settings of an existing domain. Use this to update your domain configuration. ### edit_message_stream Update the details of a message stream. This allows you to refine how your messages are organized. ### edit_sender_signature Modify an existing sender signature. Use this to update your 'from' information. ### edit_server Change settings for an account-level server. This is used for broad configuration changes. ### edit_template Update the content or variables of an existing template. This allows for quick copy changes. ### edit_webhook Update the configuration of an existing webhook. Use this to change where your data is sent. ### get_bounce_dump Retrieve the raw SMTP dump for a specific bounce. This is great for deep technical troubleshooting. ### get_bounce Fetch the specific details for a bounced message. Use this to see why a specific email failed. ### get_bulk_request_status Check the current status of a bulk email request. This helps you monitor large distributions. ### get_current_server View the configuration for your current server. Use this to verify your active settings. ### get_data_removal_status Check the progress of a GDPR or CCPA data removal request. This helps you track compliance tasks. ### get_domain Fetch details for a specific domain in your account. Use this to check your domain status. ### get_inbound_message_details See the details of an incoming message. Use this to inspect inbound traffic. ### get_message_stream View the details of a specific message stream. This helps you check stream configurations. ### get_outbound_clicks_stats Check the click counts for your outbound messages. This helps you measure engagement. ### get_outbound_message_dump Get the raw source for a specific outbound message. This is essential for debugging content issues. ### get_outbound_opens_platforms_stats See which platforms are opening your messages. Use this to understand where your users are. ### get_outbound_opens_stats Check the total open counts for outbound messages. This is your primary engagement metric. ### get_outbound_sends_stats Check the total sent counts for outbound messages. Use this to verify your volume. ### get_outbound_spam_stats View the spam complaint counts for your outbound messages. This is critical for your reputation. ### get_outbound_stats Get a general overview of your outbound message statistics. This provides a snapshot of your performance. ### get_outbound_tracked_stats View the count of tracked emails for your outbound messages. Use this to see your reach. ### get_sender_signature Fetch the details of a specific sender signature. Use this to verify your 'from' info. ### get_server View the details of an account-level server. Use this to check your account infrastructure. ### get_template Fetch the details of a specific email template. Use this to inspect your existing content. ### get_webhook View the details of a specific webhook. This helps you manage your external integrations. ### list_domains See all domains currently in your account. Use this to manage your overall domain list. ### list_sender_signatures See all sender signatures at the account level. Use this to manage your identity options. ### list_servers See all servers in your account. Use this to check your infrastructure layout. ### list_suppressions View all suppressed addresses for a message stream. This helps you manage your bounce list. ### list_templates See all templates on your current server. This is your primary library of email layouts. ### list_webhooks See all webhooks for a specific message stream. Use this to manage your data exports. ### push_templates Move templates from one server to another. This is great for migrating your content. ### resend_sender_signature Send a new confirmation email for a sender signature. Use this to re-verify your identity. ### retry_inbound_message Re-process a failed inbound message. Use this to ensure you don't miss any incoming data. ### rotate_domain_dkim Update the DKIM keys for a specific domain. This is a key step for maintaining deliverability. ### search_bounces Find specific bounces based on your search criteria. Use this to troubleshoot delivery issues. ### search_inbound_messages Find received inbound messages using specific filters. Use this to find specific communications. ### search_outbound_clicks Find specific click events for your outbound messages. Use this to track user actions. ### search_outbound_messages Search through your sent outbound messages. Use this to find specific sent emails. ### search_outbound_opens Find specific open events for your outbound messages. Use this to see who is reading your mail. ### unarchive_message_stream Restore an archived message stream to active status. Use this to bring back old streams. ### validate_template Check your template syntax for errors before you send it. This helps you catch mistakes before they reach your customers. ### verify_domain_dkim Trigger a DKIM verification for a specific domain. Use this to confirm your setup is correct. ### verify_domain_return_path Trigger a Return-Path verification for a domain. This is another key step for deliverability. ### send_batch_emails Send a group of emails via Postmark. This is great for smaller batch updates. ### send_bulk_emails Send large-scale distributions via Postmark. Use this for your biggest mailings. ### send_email Send a single transactional email. This is perfect for one-off notifications like password resets. ### send_email_with_template Send an email using one of your pre-made Postmark templates. This ensures consistent branding. ### activate_bounce Reactivate an email address that was previously bounced. Use this if a user has fixed their issues. ### add_domain Add a new domain to your account. Use this to expand your sending reach. ### archive_message_stream Move a message stream into the archive. Use this to hide old data from your active list. ### bypass_inbound_message Ignore the rules for a specific blocked inbound message. Use this for troubleshooting specific cases. ## Prompt Examples **Prompt:** ``` Send a test email to my dev address with the subject 'Test Notification' and a body saying 'The system is live.' ``` **Response:** ``` I've sent that test email for you. **Status**: Submitted **Message ID**: `msg_88291` **Recipient**: `dev_test@example.com` Let me know if you'd like me to check the delivery status in a few minutes. ``` **Prompt:** ``` Can you check if my 'Welcome_User' template is valid? ``` **Response:** ``` I've checked the "Welcome_User" template for you. **Validation Result**: Success ✅ The syntax is correct and all required variables are properly formatted. You're good to go for sending. ``` **Prompt:** ``` Show me the bounce stats for our last outbound campaign. ``` **Response:** ``` Here are the current outbound bounce statistics: | Metric | Count | | :--- | :--- | | **Total Bounces** | 14 | | **Spam Complaints** | 0 | | **Open Rate** | 42.5% | | **Click Rate** | 8.2% | Would you like me to search for the specific bounce details for any of these? ``` ## Capabilities ### Send transactional messages Send single, batch, or bulk emails with full control over content and attachments. ### Manage email templates Create, edit, and delete templates with a built-in syntax validator. ### Track engagement metrics Monitor open counts, click events, and delivery stats for your outbound messages. ### Handle domain health Add, edit, or remove domains and rotate DKIM keys for better deliverability. ### Automate webhooks Create and list webhooks to receive real-time updates on message events. ### Manage suppressions View and manage suppressed email addresses for your message streams. ## Use Cases ### Testing new signup flows A developer needs to see if their new registration email looks right. They ask their agent to send a test message to their inbox using a specific layout. ### Updating marketing copy A marketing manager needs to change a price in a welcome email. They ask their agent to find the correct template and update the specific text field. ### Troubleshooting high bounce rates A support lead notices a spike in bounces. They ask their agent to search for the specific errors and show them the raw SMTP dumps for the failed messages. ### Handling privacy requests A customer asks to be removed from all mailing lists. The ops team tells their agent to request a data removal for that email to stay CCPA compliant. ## Benefits - Stop wasting time on manual template checks by using a syntax validator that catches errors before they reach your customers. This ensures your emails always look professional and function correctly on every device. - Speed up your development cycle by triggering notifications instantly from your code editor. You can send test emails without ever leaving your IDE to check a dashboard. - Maintain your sender reputation with ease by rotating keys and verifying domain health through natural language. This keeps your emails out of the spam folder without the manual headache. - Automate complex compliance tasks like data removal requests for GDPR or CCPA. Your agent can handle these requests for you, keeping your company compliant and your workflow moving. - Get a real-time pulse on your email performance with detailed stats on opens, clicks, and bounces. You can query these metrics instantly to see how your users are interacting with your messages. - Organize your outgoing traffic into clean streams. This allows you to manage different types of notifications separately while keeping your account configuration tidy and easy to navigate. ## How It Works The bottom line is you get to manage your entire email delivery pipeline through natural language instead of a web dashboard. 1. Subscribe to the Postmark MCP on Vinkius 2. Provide your Postmark Server Token and optional Account Token in your client settings 3. Start asking your agent to send emails, check stats, or update templates ## Frequently Asked Questions **Can the Postmark MCP help me send bulk emails?** Yes, it allows your agent to trigger bulk and batch email sending directly. You can describe the recipient list and content, and the agent handles the rest. **How do I manage my email templates with this?** You can ask your agent to list, create, edit, or delete templates. It can even validate them to make sure they won't break when you send them. **Can I use the Postmark MCP to check if my emails are getting opened?** Yes, your agent can pull data from the open and click statistics to give you a summary of how users are interacting with your messages. **Does this Connector support GDPR data removal?** Yes, you can use the request data removal tool to tell your agent to handle recipient data removal requests for you automatically. **Can I rotate my DKIM keys using this?** Absolutely. You can ask your agent to rotate the keys and then verify the domain setup to ensure everything is configured correctly. **How does this help with testing?** It lets you use the send email tool to trigger notifications instantly from your AI client. You don't have to leave your workspace to see how a message looks. **Can I send multiple emails in a single request?** Yes! You can use `send_batch_emails` to send up to 500 messages at once, or `send_bulk_emails` for larger distributions using templates and recipient variables. **How do I use my existing Postmark templates?** Use the `send_email_with_template` tool. You just need to provide the `TemplateId` or `TemplateAlias` and the `TemplateModel` containing your dynamic variables. **Can I manage my templates without leaving the chat?** Absolutely. You can use `list_templates`, `create_template`, `edit_template`, and `delete_template` to perform full CRUD operations on your Postmark server templates.