shipmail-mcp 0.7.2 → 0.7.3

package/dist/capabilities.d.ts

@@ -1,9 +1,9 @@
 import { ApiKeyScope } from 'shipmail/api-key-scopes';
 
 declare const MCP_CAPABILITY_VERSION = "1.0.0";
-declare const MCP_PERMISSION_GROUP_NAMES: readonly ["account_status", "mail_read", "drafts", "mail_organize", "send_mail", "calendar_read", "calendar_write", "booking_pages", "forwarding", "mailbox_rules", "webhooks", "credentials", "mailbox_export", "domain_admin", "mailbox_admin", "newsletters", "audiences", "suppressions", "partner_admin"];
+declare const MCP_PERMISSION_GROUP_NAMES: readonly ["account_status", "automations", "mail_read", "drafts", "mail_organize", "send_mail", "calendar_read", "calendar_write", "booking_pages", "forwarding", "mailbox_rules", "webhooks", "credentials", "mailbox_export", "domain_admin", "mailbox_admin", "newsletters", "audiences", "suppressions", "partner_admin"];
 type McpPermissionGroupName = (typeof MCP_PERMISSION_GROUP_NAMES)[number];
-declare const MCP_MEMBER_PERMISSION_GROUP_NAMES: readonly ["account_status", "mail_read", "drafts", "mail_organize", "mailbox_rules", "send_mail", "calendar_read", "calendar_write"];
+declare const MCP_MEMBER_PERMISSION_GROUP_NAMES: readonly ["account_status", "mail_read", "drafts", "mail_organize", "mailbox_rules", "send_mail", "calendar_read", "calendar_write", "automations"];
 type McpRole = "owner" | "member";
 type McpCapabilityEffect = "read" | "local_write" | "external_write" | "destructive";
 type McpRecipientControl = "none" | "server_derived" | "caller_supplied";
@@ -22,6 +22,12 @@ declare const MCP_PERMISSION_GROUPS: readonly [{
     readonly description: "Check whether the Shipmail API is available.";
     readonly scopes: readonly [];
     readonly persistent: false;
+}, {
+    readonly name: "automations";
+    readonly label: "Automations";
+    readonly description: "Read and manage persistent assistant automations.";
+    readonly scopes: readonly ["automations:read", "automations:write"];
+    readonly persistent: true;
 }, {
     readonly name: "mail_read";
     readonly label: "Read mail";
@@ -131,7 +137,7 @@ declare const MCP_PERMISSION_GROUPS: readonly [{
     readonly scopes: readonly ["partner:organizations:read", "partner:organizations:write", "partner:organizations:access", "partner:mailbox_credentials:issue", "partner:usage:read"];
     readonly persistent: true;
 }];
-declare const CAPABILITY_ROWS: readonly [readonly ["shipmail_status", "getStatus", "public"], readonly ["shipmail_create_domain", "createDomain", "domains:write"], readonly ["shipmail_list_domains", "listDomains", "domains:read"], readonly ["shipmail_get_domain", "getDomain", "domains:read"], readonly ["shipmail_get_domain_dns_records", "getDomainDnsRecords", "domains:read"], readonly ["shipmail_update_domain", "updateDomain", "domains:write"], readonly ["shipmail_delete_domain", "deleteDomain", "domains:write"], readonly ["shipmail_verify_domain", "verifyDomain", "domains:write"], readonly ["shipmail_search_domains", "searchDomains", "domains:read"], readonly ["shipmail_create_mailbox", "createMailbox", "mailboxes:write"], readonly ["shipmail_list_mailboxes", "listMailboxes", "mailboxes:read"], readonly ["shipmail_get_mailbox", "getMailbox", "mailboxes:read"], readonly ["shipmail_list_mailbox_app_passwords", "listMailboxAppPasswords", "mailbox_credentials:read"], readonly ["shipmail_create_mailbox_app_password", "createMailboxAppPassword", "mailbox_credentials:write"], readonly ["shipmail_revoke_mailbox_app_password", "revokeMailboxAppPassword", "mailbox_credentials:write"], readonly ["shipmail_suspend_mailbox", "suspendMailbox", "mailboxes:write"], readonly ["shipmail_resume_mailbox", "resumeMailbox", "mailboxes:write"], readonly ["shipmail_create_mailbox_export", "createMailboxExport", "mailboxes:export"], readonly ["shipmail_get_mailbox_export", "getMailboxExport", "mailboxes:export"], readonly ["shipmail_update_mailbox", "updateMailbox", "mailboxes:write"], readonly ["shipmail_delete_mailbox", "deleteMailbox", "mailboxes:write"], readonly ["shipmail_list_mailbox_folders", "listMailboxFolders", "mailboxes:read"], readonly ["shipmail_get_mailbox_rules", "getMailboxRules", "mailbox_rules:read"], readonly ["shipmail_set_mailbox_rules", "updateMailboxRules", "mailbox_rules:write"], readonly ["shipmail_create_mailbox_folder", "createMailboxFolder", "mailboxes:write"], readonly ["shipmail_update_mailbox_folder", "updateMailboxFolder", "mailboxes:write"], readonly ["shipmail_delete_mailbox_folder", "deleteMailboxFolder", "mailboxes:write"], readonly ["shipmail_list_mailbox_identities", "listMailboxIdentities", "mailboxes:read"], readonly ["shipmail_list_mailbox_inbox_messages", "listMailboxInboxMessages", "messages:read"], readonly ["shipmail_get_mailbox_inbox_message", "getMailboxInboxMessage", "messages:read"], readonly ["shipmail_list_mailbox_inbox_threads", "listMailboxInboxThreads", "messages:read"], readonly ["shipmail_get_mailbox_inbox_thread", "getMailboxInboxThread", "messages:read"], readonly ["shipmail_update_inbox_thread_reply_state", "updateMailboxInboxThreadReplyState", "messages:write"], readonly ["shipmail_create_inbox_reply_draft", "createMailboxInboxReplyDraft", "drafts:write"], readonly ["shipmail_send_inbox_reply_draft", "sendMailboxInboxReplyDraft", "messages:send"], readonly ["shipmail_reply_to_inbox_message", "replyToMailboxInboxMessage", "messages:send"], readonly ["shipmail_reply_to_inbox_thread", "replyToMailboxInboxThread", "messages:send"], readonly ["shipmail_update_inbox_message", "updateMailboxInboxMessage", "messages:write"], readonly ["shipmail_move_inbox_message", "moveMailboxInboxMessage", "messages:write"], readonly ["shipmail_delete_inbox_message", "deleteMailboxInboxMessage", "messages:write"], readonly ["shipmail_list_mailbox_forwarding", "listMailboxForwarding", "mailbox_forwarding:read"], readonly ["shipmail_create_mailbox_forwarding", "createMailboxForwarding", "mailbox_forwarding:write"], readonly ["shipmail_delete_mailbox_forwarding", "deleteMailboxForwarding", "mailbox_forwarding:write"], readonly ["shipmail_reset_mailbox_password", "resetMailboxPassword", "mailboxes:write"], readonly ["shipmail_set_auto_reply", "updateAutoReply", "mailboxes:write"], readonly ["shipmail_set_spam_filter", "updateSpamFilter", "mailboxes:write"], readonly ["shipmail_create_mailbox_import", "createMailboxImport", "mailboxes:write"], readonly ["shipmail_list_mailbox_imports", "listMailboxImports", "mailboxes:read"], readonly ["shipmail_get_mailbox_import", "getMailboxImport", "mailboxes:read"], readonly ["shipmail_cancel_mailbox_import", "cancelMailboxImport", "mailboxes:write"], readonly ["shipmail_undo_mailbox_import", "undoMailboxImport", "mailboxes:write"], readonly ["shipmail_inject_sandbox_inbound", "injectSandboxInbound", "messages:write"], readonly ["shipmail_list_messages", "listMessages", "messages:read"], readonly ["shipmail_list_message_analytics", "listMessageAnalytics", "messages:read"], readonly ["shipmail_compose_message_with_file", "prepareStagedAttachmentUpload", "messages:send"], readonly ["shipmail_prepare_staged_attachment_upload", "prepareStagedAttachmentUpload", "messages:send"], readonly ["shipmail_send_message", "sendMessage", "messages:send"], readonly ["shipmail_list_scheduled_messages", "listScheduledMessages", "messages:read"], readonly ["shipmail_get_scheduled_message", "getScheduledMessage", "messages:read"], readonly ["shipmail_update_scheduled_message", "updateScheduledMessage", "messages:send"], readonly ["shipmail_cancel_scheduled_message", "cancelScheduledMessage", "messages:send"], readonly ["shipmail_get_message", "getMessage", "messages:read"], readonly ["shipmail_reply_to_message", "replyToMessage", "messages:send"], readonly ["shipmail_list_threads", "listThreads", "threads:read"], readonly ["shipmail_get_thread", "getThread", "threads:read"], readonly ["shipmail_reply_to_thread", "replyToThread", "messages:send"], readonly ["shipmail_create_reply_scan", "createReplyScan", "messages:write"], readonly ["shipmail_get_reply_scan", "getReplyScan", "messages:read"], readonly ["shipmail_list_reply_scan_results", "listReplyScanResults", "messages:read"], readonly ["shipmail_create_webhook", "createWebhook", "webhooks:write"], readonly ["shipmail_list_webhooks", "listWebhooks", "webhooks:read"], readonly ["shipmail_get_webhook", "getWebhook", "webhooks:read"], readonly ["shipmail_update_webhook", "updateWebhook", "webhooks:write"], readonly ["shipmail_delete_webhook", "deleteWebhook", "webhooks:write"], readonly ["shipmail_rotate_webhook_secret", "rotateWebhookSecret", "webhooks:write"], readonly ["shipmail_test_webhook", "testWebhook", "webhooks:write"], readonly ["shipmail_list_webhook_deliveries", "listWebhookDeliveries", "webhooks:read"], readonly ["shipmail_get_webhook_delivery", "getWebhookDelivery", "webhooks:read"], readonly ["shipmail_replay_webhook_delivery", "replayWebhookDelivery", "webhooks:write"], readonly ["shipmail_list_suppressions", "listSuppressions", "suppressions:read"], readonly ["shipmail_remove_suppression", "removeSuppression", "suppressions:write"], readonly ["shipmail_create_audience", "createAudience", "audiences:write"], readonly ["shipmail_list_audiences", "listAudiences", "audiences:read"], readonly ["shipmail_get_audience", "getAudience", "audiences:read"], readonly ["shipmail_update_audience", "updateAudience", "audiences:write"], readonly ["shipmail_delete_audience", "deleteAudience", "audiences:write"], readonly ["shipmail_get_audience_feed", "getAudienceFeed", "audiences:read"], readonly ["shipmail_update_audience_feed", "updateAudienceFeed", "audiences:write"], readonly ["shipmail_rotate_audience_feed", "rotateAudienceFeedToken", "audiences:write"], readonly ["shipmail_revoke_audience_feed", "revokeAudienceFeedToken", "audiences:write"], readonly ["shipmail_add_subscriber", "addSubscriber", "audiences:write"], readonly ["shipmail_add_subscribers_batch", "addSubscribersBatch", "audiences:write"], readonly ["shipmail_list_subscribers", "listSubscribers", "audiences:read"], readonly ["shipmail_get_subscriber", "getSubscriber", "audiences:read"], readonly ["shipmail_get_subscriber_by_email", "getSubscriberByEmail", "audiences:read"], readonly ["shipmail_update_subscriber", "updateSubscriber", "audiences:write"], readonly ["shipmail_unsubscribe_subscriber", "unsubscribeSubscriber", "audiences:write"], readonly ["shipmail_resubscribe_subscriber", "resubscribeSubscriber", "audiences:write"], readonly ["shipmail_remove_subscriber", "removeSubscriber", "audiences:write"], readonly ["shipmail_list_newsletter_domains", "listNewsletterDomains", "newsletters:read"], readonly ["shipmail_list_newsletter_sender_identities", "listNewsletterSenderIdentities", "newsletters:read"], readonly ["shipmail_create_newsletter", "createNewsletter", "newsletters:write"], readonly ["shipmail_create_newsletter_from_changelog", "createNewsletterFromChangelog", "newsletters:write"], readonly ["shipmail_list_newsletters", "listNewsletters", "newsletters:read"], readonly ["shipmail_get_newsletter", "getNewsletter", "newsletters:read"], readonly ["shipmail_update_newsletter", "updateNewsletter", "newsletters:write"], readonly ["shipmail_list_newsletter_assets", "listNewsletterAssets", "newsletters:read"], readonly ["shipmail_register_newsletter_asset", "uploadNewsletterAsset", "newsletters:write"], readonly ["shipmail_preview_newsletter", "previewNewsletter", "newsletters:read"], readonly ["shipmail_run_newsletter_preflight", "runNewsletterPreflight", "newsletters:write"], readonly ["shipmail_send_newsletter_test", "sendNewsletterTest", "newsletters:write"], readonly ["shipmail_schedule_newsletter", "scheduleNewsletter", "newsletters:write"], readonly ["shipmail_cancel_newsletter", "cancelNewsletter", "newsletters:write"], readonly ["shipmail_resume_newsletter", "resumeNewsletter", "newsletters:write"], readonly ["shipmail_list_calendar_events", "listCalendarEvents", "calendar:read"], readonly ["shipmail_create_calendar_event", "createCalendarEvent", "calendar:write"], readonly ["shipmail_get_calendar_event", "getCalendarEvent", "calendar:read"], readonly ["shipmail_update_calendar_event", "updateCalendarEvent", "calendar:write"], readonly ["shipmail_delete_calendar_event", "deleteCalendarEvent", "calendar:write"], readonly ["shipmail_get_calendar_availability", "getCalendarAvailability", "calendar:read"], readonly ["shipmail_list_booking_pages", "listBookingPages", "booking_pages:read"], readonly ["shipmail_create_booking_page", "createBookingPage", "booking_pages:write"], readonly ["shipmail_get_booking_page", "getBookingPage", "booking_pages:read"], readonly ["shipmail_update_booking_page", "updateBookingPage", "booking_pages:write"], readonly ["shipmail_delete_booking_page", "deleteBookingPage", "booking_pages:write"], readonly ["shipmail_list_partner_organizations", "listPartnerOrganizations", "partner:organizations:read"], readonly ["shipmail_create_partner_organization", "createPartnerOrganization", "partner:organizations:write"], readonly ["shipmail_get_partner_organization", "getPartnerOrganization", "partner:organizations:read"], readonly ["shipmail_update_partner_organization", "updatePartnerOrganization", "partner:organizations:write"], readonly ["shipmail_resend_partner_ownership_invitation", "resendPartnerOwnershipInvitation", "partner:organizations:write"], readonly ["shipmail_suspend_partner_organization", "suspendPartnerOrganization", "partner:organizations:write"], readonly ["shipmail_resume_partner_organization", "resumePartnerOrganization", "partner:organizations:write"], readonly ["shipmail_offboard_partner_organization", "offboardPartnerOrganization", "partner:organizations:write"], readonly ["shipmail_list_partner_mailbox_credential_grants", "listPartnerMailboxCredentialGrants", "partner:mailbox_credentials:issue"], readonly ["shipmail_consume_partner_mailbox_credential_grant", "consumePartnerMailboxCredentialGrant", "partner:mailbox_credentials:issue"], readonly ["shipmail_get_partner_usage", "getPartnerUsage", "partner:usage:read"]];
+declare const CAPABILITY_ROWS: readonly [readonly ["shipmail_status", "getStatus", "public"], readonly ["shipmail_list_automations", "listAutomations", "automations:read"], readonly ["shipmail_create_automation", "createAutomation", "automations:write"], readonly ["shipmail_get_automation", "getAutomation", "automations:read"], readonly ["shipmail_update_automation", "updateAutomation", "automations:write"], readonly ["shipmail_run_automation", "runAutomation", "automations:write"], readonly ["shipmail_create_domain", "createDomain", "domains:write"], readonly ["shipmail_list_domains", "listDomains", "domains:read"], readonly ["shipmail_get_domain", "getDomain", "domains:read"], readonly ["shipmail_get_domain_dns_records", "getDomainDnsRecords", "domains:read"], readonly ["shipmail_update_domain", "updateDomain", "domains:write"], readonly ["shipmail_delete_domain", "deleteDomain", "domains:write"], readonly ["shipmail_verify_domain", "verifyDomain", "domains:write"], readonly ["shipmail_search_domains", "searchDomains", "domains:read"], readonly ["shipmail_create_mailbox", "createMailbox", "mailboxes:write"], readonly ["shipmail_list_mailboxes", "listMailboxes", "mailboxes:read"], readonly ["shipmail_get_mailbox", "getMailbox", "mailboxes:read"], readonly ["shipmail_list_mailbox_app_passwords", "listMailboxAppPasswords", "mailbox_credentials:read"], readonly ["shipmail_create_mailbox_app_password", "createMailboxAppPassword", "mailbox_credentials:write"], readonly ["shipmail_revoke_mailbox_app_password", "revokeMailboxAppPassword", "mailbox_credentials:write"], readonly ["shipmail_suspend_mailbox", "suspendMailbox", "mailboxes:write"], readonly ["shipmail_resume_mailbox", "resumeMailbox", "mailboxes:write"], readonly ["shipmail_create_mailbox_export", "createMailboxExport", "mailboxes:export"], readonly ["shipmail_get_mailbox_export", "getMailboxExport", "mailboxes:export"], readonly ["shipmail_update_mailbox", "updateMailbox", "mailboxes:write"], readonly ["shipmail_delete_mailbox", "deleteMailbox", "mailboxes:write"], readonly ["shipmail_list_mailbox_folders", "listMailboxFolders", "mailboxes:read"], readonly ["shipmail_get_mailbox_rules", "getMailboxRules", "mailbox_rules:read"], readonly ["shipmail_set_mailbox_rules", "updateMailboxRules", "mailbox_rules:write"], readonly ["shipmail_create_mailbox_folder", "createMailboxFolder", "mailboxes:write"], readonly ["shipmail_update_mailbox_folder", "updateMailboxFolder", "mailboxes:write"], readonly ["shipmail_delete_mailbox_folder", "deleteMailboxFolder", "mailboxes:write"], readonly ["shipmail_list_mailbox_identities", "listMailboxIdentities", "mailboxes:read"], readonly ["shipmail_list_mailbox_inbox_messages", "listMailboxInboxMessages", "messages:read"], readonly ["shipmail_get_mailbox_inbox_message", "getMailboxInboxMessage", "messages:read"], readonly ["shipmail_list_mailbox_inbox_threads", "listMailboxInboxThreads", "messages:read"], readonly ["shipmail_get_mailbox_inbox_thread", "getMailboxInboxThread", "messages:read"], readonly ["shipmail_update_inbox_thread_reply_state", "updateMailboxInboxThreadReplyState", "messages:write"], readonly ["shipmail_create_inbox_reply_draft", "createMailboxInboxReplyDraft", "drafts:write"], readonly ["shipmail_send_inbox_reply_draft", "sendMailboxInboxReplyDraft", "messages:send"], readonly ["shipmail_reply_to_inbox_message", "replyToMailboxInboxMessage", "messages:send"], readonly ["shipmail_reply_to_inbox_thread", "replyToMailboxInboxThread", "messages:send"], readonly ["shipmail_update_inbox_message", "updateMailboxInboxMessage", "messages:write"], readonly ["shipmail_move_inbox_message", "moveMailboxInboxMessage", "messages:write"], readonly ["shipmail_delete_inbox_message", "deleteMailboxInboxMessage", "messages:write"], readonly ["shipmail_list_mailbox_forwarding", "listMailboxForwarding", "mailbox_forwarding:read"], readonly ["shipmail_create_mailbox_forwarding", "createMailboxForwarding", "mailbox_forwarding:write"], readonly ["shipmail_delete_mailbox_forwarding", "deleteMailboxForwarding", "mailbox_forwarding:write"], readonly ["shipmail_reset_mailbox_password", "resetMailboxPassword", "mailboxes:write"], readonly ["shipmail_set_auto_reply", "updateAutoReply", "mailboxes:write"], readonly ["shipmail_set_spam_filter", "updateSpamFilter", "mailboxes:write"], readonly ["shipmail_create_mailbox_import", "createMailboxImport", "mailboxes:write"], readonly ["shipmail_list_mailbox_imports", "listMailboxImports", "mailboxes:read"], readonly ["shipmail_get_mailbox_import", "getMailboxImport", "mailboxes:read"], readonly ["shipmail_cancel_mailbox_import", "cancelMailboxImport", "mailboxes:write"], readonly ["shipmail_undo_mailbox_import", "undoMailboxImport", "mailboxes:write"], readonly ["shipmail_inject_sandbox_inbound", "injectSandboxInbound", "messages:write"], readonly ["shipmail_list_messages", "listMessages", "messages:read"], readonly ["shipmail_list_message_analytics", "listMessageAnalytics", "messages:read"], readonly ["shipmail_compose_message_with_file", "prepareStagedAttachmentUpload", "messages:send"], readonly ["shipmail_prepare_staged_attachment_upload", "prepareStagedAttachmentUpload", "messages:send"], readonly ["shipmail_send_message", "sendMessage", "messages:send"], readonly ["shipmail_list_scheduled_messages", "listScheduledMessages", "messages:read"], readonly ["shipmail_get_scheduled_message", "getScheduledMessage", "messages:read"], readonly ["shipmail_update_scheduled_message", "updateScheduledMessage", "messages:send"], readonly ["shipmail_cancel_scheduled_message", "cancelScheduledMessage", "messages:send"], readonly ["shipmail_get_message", "getMessage", "messages:read"], readonly ["shipmail_reply_to_message", "replyToMessage", "messages:send"], readonly ["shipmail_list_threads", "listThreads", "threads:read"], readonly ["shipmail_get_thread", "getThread", "threads:read"], readonly ["shipmail_reply_to_thread", "replyToThread", "messages:send"], readonly ["shipmail_create_reply_scan", "createReplyScan", "messages:write"], readonly ["shipmail_get_reply_scan", "getReplyScan", "messages:read"], readonly ["shipmail_list_reply_scan_results", "listReplyScanResults", "messages:read"], readonly ["shipmail_create_webhook", "createWebhook", "webhooks:write"], readonly ["shipmail_list_webhooks", "listWebhooks", "webhooks:read"], readonly ["shipmail_get_webhook", "getWebhook", "webhooks:read"], readonly ["shipmail_update_webhook", "updateWebhook", "webhooks:write"], readonly ["shipmail_delete_webhook", "deleteWebhook", "webhooks:write"], readonly ["shipmail_rotate_webhook_secret", "rotateWebhookSecret", "webhooks:write"], readonly ["shipmail_test_webhook", "testWebhook", "webhooks:write"], readonly ["shipmail_list_webhook_deliveries", "listWebhookDeliveries", "webhooks:read"], readonly ["shipmail_get_webhook_delivery", "getWebhookDelivery", "webhooks:read"], readonly ["shipmail_replay_webhook_delivery", "replayWebhookDelivery", "webhooks:write"], readonly ["shipmail_list_suppressions", "listSuppressions", "suppressions:read"], readonly ["shipmail_remove_suppression", "removeSuppression", "suppressions:write"], readonly ["shipmail_create_audience", "createAudience", "audiences:write"], readonly ["shipmail_list_audiences", "listAudiences", "audiences:read"], readonly ["shipmail_get_audience", "getAudience", "audiences:read"], readonly ["shipmail_update_audience", "updateAudience", "audiences:write"], readonly ["shipmail_delete_audience", "deleteAudience", "audiences:write"], readonly ["shipmail_get_audience_feed", "getAudienceFeed", "audiences:read"], readonly ["shipmail_update_audience_feed", "updateAudienceFeed", "audiences:write"], readonly ["shipmail_rotate_audience_feed", "rotateAudienceFeedToken", "audiences:write"], readonly ["shipmail_revoke_audience_feed", "revokeAudienceFeedToken", "audiences:write"], readonly ["shipmail_add_subscriber", "addSubscriber", "audiences:write"], readonly ["shipmail_add_subscribers_batch", "addSubscribersBatch", "audiences:write"], readonly ["shipmail_list_subscribers", "listSubscribers", "audiences:read"], readonly ["shipmail_get_subscriber", "getSubscriber", "audiences:read"], readonly ["shipmail_get_subscriber_by_email", "getSubscriberByEmail", "audiences:read"], readonly ["shipmail_update_subscriber", "updateSubscriber", "audiences:write"], readonly ["shipmail_unsubscribe_subscriber", "unsubscribeSubscriber", "audiences:write"], readonly ["shipmail_resubscribe_subscriber", "resubscribeSubscriber", "audiences:write"], readonly ["shipmail_remove_subscriber", "removeSubscriber", "audiences:write"], readonly ["shipmail_list_newsletter_domains", "listNewsletterDomains", "newsletters:read"], readonly ["shipmail_list_newsletter_sender_identities", "listNewsletterSenderIdentities", "newsletters:read"], readonly ["shipmail_create_newsletter", "createNewsletter", "newsletters:write"], readonly ["shipmail_create_newsletter_from_changelog", "createNewsletterFromChangelog", "newsletters:write"], readonly ["shipmail_list_newsletters", "listNewsletters", "newsletters:read"], readonly ["shipmail_get_newsletter", "getNewsletter", "newsletters:read"], readonly ["shipmail_update_newsletter", "updateNewsletter", "newsletters:write"], readonly ["shipmail_list_newsletter_assets", "listNewsletterAssets", "newsletters:read"], readonly ["shipmail_register_newsletter_asset", "uploadNewsletterAsset", "newsletters:write"], readonly ["shipmail_preview_newsletter", "previewNewsletter", "newsletters:read"], readonly ["shipmail_run_newsletter_preflight", "runNewsletterPreflight", "newsletters:write"], readonly ["shipmail_send_newsletter_test", "sendNewsletterTest", "newsletters:write"], readonly ["shipmail_schedule_newsletter", "scheduleNewsletter", "newsletters:write"], readonly ["shipmail_cancel_newsletter", "cancelNewsletter", "newsletters:write"], readonly ["shipmail_resume_newsletter", "resumeNewsletter", "newsletters:write"], readonly ["shipmail_list_calendar_events", "listCalendarEvents", "calendar:read"], readonly ["shipmail_create_calendar_event", "createCalendarEvent", "calendar:write"], readonly ["shipmail_get_calendar_event", "getCalendarEvent", "calendar:read"], readonly ["shipmail_update_calendar_event", "updateCalendarEvent", "calendar:write"], readonly ["shipmail_delete_calendar_event", "deleteCalendarEvent", "calendar:write"], readonly ["shipmail_get_calendar_availability", "getCalendarAvailability", "calendar:read"], readonly ["shipmail_list_booking_pages", "listBookingPages", "booking_pages:read"], readonly ["shipmail_create_booking_page", "createBookingPage", "booking_pages:write"], readonly ["shipmail_get_booking_page", "getBookingPage", "booking_pages:read"], readonly ["shipmail_update_booking_page", "updateBookingPage", "booking_pages:write"], readonly ["shipmail_delete_booking_page", "deleteBookingPage", "booking_pages:write"], readonly ["shipmail_list_partner_organizations", "listPartnerOrganizations", "partner:organizations:read"], readonly ["shipmail_create_partner_organization", "createPartnerOrganization", "partner:organizations:write"], readonly ["shipmail_get_partner_organization", "getPartnerOrganization", "partner:organizations:read"], readonly ["shipmail_update_partner_organization", "updatePartnerOrganization", "partner:organizations:write"], readonly ["shipmail_resend_partner_ownership_invitation", "resendPartnerOwnershipInvitation", "partner:organizations:write"], readonly ["shipmail_suspend_partner_organization", "suspendPartnerOrganization", "partner:organizations:write"], readonly ["shipmail_resume_partner_organization", "resumePartnerOrganization", "partner:organizations:write"], readonly ["shipmail_offboard_partner_organization", "offboardPartnerOrganization", "partner:organizations:write"], readonly ["shipmail_list_partner_mailbox_credential_grants", "listPartnerMailboxCredentialGrants", "partner:mailbox_credentials:issue"], readonly ["shipmail_consume_partner_mailbox_credential_grant", "consumePartnerMailboxCredentialGrant", "partner:mailbox_credentials:issue"], readonly ["shipmail_get_partner_usage", "getPartnerUsage", "partner:usage:read"]];
 type McpToolName = (typeof CAPABILITY_ROWS)[number][0];
 type McpCapability = {
     readonly toolName: McpToolName;

package/dist/capabilities.js

@@ -3,6 +3,7 @@ import { API_KEY_SCOPES, apiKeyScopesGrant } from "shipmail/api-key-scopes";
 var MCP_CAPABILITY_VERSION = "1.0.0";
 var MCP_PERMISSION_GROUP_NAMES = [
   "account_status",
+  "automations",
   "mail_read",
   "drafts",
   "mail_organize",
@@ -30,7 +31,8 @@ var MCP_MEMBER_PERMISSION_GROUP_NAMES = [
   "mailbox_rules",
   "send_mail",
   "calendar_read",
-  "calendar_write"
+  "calendar_write",
+  "automations"
 ];
 var MCP_PERMISSION_GROUPS = [
   {
@@ -40,6 +42,13 @@ var MCP_PERMISSION_GROUPS = [
     scopes: [],
     persistent: false
   },
+  {
+    name: "automations",
+    label: "Automations",
+    description: "Read and manage persistent assistant automations.",
+    scopes: ["automations:read", "automations:write"],
+    persistent: true
+  },
   {
     name: "mail_read",
     label: "Read mail",
@@ -175,6 +184,11 @@ var MCP_PERMISSION_GROUPS = [
 ];
 var CAPABILITY_ROWS = [
   ["shipmail_status", "getStatus", "public"],
+  ["shipmail_list_automations", "listAutomations", "automations:read"],
+  ["shipmail_create_automation", "createAutomation", "automations:write"],
+  ["shipmail_get_automation", "getAutomation", "automations:read"],
+  ["shipmail_update_automation", "updateAutomation", "automations:write"],
+  ["shipmail_run_automation", "runAutomation", "automations:write"],
   ["shipmail_create_domain", "createDomain", "domains:write"],
   ["shipmail_list_domains", "listDomains", "domains:read"],
   ["shipmail_get_domain", "getDomain", "domains:read"],
@@ -429,6 +443,7 @@ function permissionGroupFor(toolName, requiredScope) {
   if (requiredScope === "calendar:read") return "calendar_read";
   if (requiredScope === "calendar:write") return "calendar_write";
   if (requiredScope.startsWith("booking_pages:")) return "booking_pages";
+  if (requiredScope.startsWith("automations:")) return "automations";
   if (requiredScope.startsWith("webhooks:")) return "webhooks";
   if (requiredScope.startsWith("newsletters:")) return "newsletters";
   if (requiredScope.startsWith("audiences:")) return "audiences";
@@ -453,10 +468,11 @@ function recipientControlFor(toolName) {
   return "none";
 }
 function durationFor(toolName) {
+  if (toolName === "shipmail_run_automation") return "one_shot";
   if (toolName.includes("app_password") || toolName.includes("credential_grant") || toolName === "shipmail_rotate_webhook_secret") {
     return "credential";
   }
-  if (toolName.includes("forwarding") || toolName.includes("mailbox_rules") || toolName.includes("webhook") || toolName.includes("booking_page")) {
+  if (toolName.includes("forwarding") || toolName.includes("mailbox_rules") || toolName.includes("webhook") || toolName.includes("booking_page") || toolName.includes("automation")) {
     return "persistent";
   }
   if (toolName === "shipmail_send_message" || toolName.includes("schedule_") || toolName.includes("scheduled_message")) {

package/dist/index.js

@@ -115,7 +115,8 @@ var MCP_MEMBER_PERMISSION_GROUP_NAMES = [
   "mailbox_rules",
   "send_mail",
   "calendar_read",
-  "calendar_write"
+  "calendar_write",
+  "automations"
 ];
 var MCP_PERMISSION_GROUPS = [
   {
@@ -125,6 +126,13 @@ var MCP_PERMISSION_GROUPS = [
     scopes: [],
     persistent: false
   },
+  {
+    name: "automations",
+    label: "Automations",
+    description: "Read and manage persistent assistant automations.",
+    scopes: ["automations:read", "automations:write"],
+    persistent: true
+  },
   {
     name: "mail_read",
     label: "Read mail",
@@ -260,6 +268,11 @@ var MCP_PERMISSION_GROUPS = [
 ];
 var CAPABILITY_ROWS = [
   ["shipmail_status", "getStatus", "public"],
+  ["shipmail_list_automations", "listAutomations", "automations:read"],
+  ["shipmail_create_automation", "createAutomation", "automations:write"],
+  ["shipmail_get_automation", "getAutomation", "automations:read"],
+  ["shipmail_update_automation", "updateAutomation", "automations:write"],
+  ["shipmail_run_automation", "runAutomation", "automations:write"],
   ["shipmail_create_domain", "createDomain", "domains:write"],
   ["shipmail_list_domains", "listDomains", "domains:read"],
   ["shipmail_get_domain", "getDomain", "domains:read"],
@@ -514,6 +527,7 @@ function permissionGroupFor(toolName, requiredScope) {
   if (requiredScope === "calendar:read") return "calendar_read";
   if (requiredScope === "calendar:write") return "calendar_write";
   if (requiredScope.startsWith("booking_pages:")) return "booking_pages";
+  if (requiredScope.startsWith("automations:")) return "automations";
   if (requiredScope.startsWith("webhooks:")) return "webhooks";
   if (requiredScope.startsWith("newsletters:")) return "newsletters";
   if (requiredScope.startsWith("audiences:")) return "audiences";
@@ -538,10 +552,11 @@ function recipientControlFor(toolName) {
   return "none";
 }
 function durationFor(toolName) {
+  if (toolName === "shipmail_run_automation") return "one_shot";
   if (toolName.includes("app_password") || toolName.includes("credential_grant") || toolName === "shipmail_rotate_webhook_secret") {
     return "credential";
   }
-  if (toolName.includes("forwarding") || toolName.includes("mailbox_rules") || toolName.includes("webhook") || toolName.includes("booking_page")) {
+  if (toolName.includes("forwarding") || toolName.includes("mailbox_rules") || toolName.includes("webhook") || toolName.includes("booking_page") || toolName.includes("automation")) {
     return "persistent";
   }
   if (toolName === "shipmail_send_message" || toolName.includes("schedule_") || toolName.includes("scheduled_message")) {
@@ -2949,6 +2964,197 @@ var calendarAvailabilitySchema = z.object({
   timezone: z.string(),
   slots: z.array(calendarAvailabilitySlotSchema)
 });
+var automationTriggerSchema = z.discriminatedUnion("type", [
+  z.object({ type: z.literal("email_received"), mailbox_ids: z.array(idSchema).min(1).max(100) }),
+  z.object({
+    type: z.literal("scheduled"),
+    cron: noControlString(100, "cron").min(9),
+    time_zone: noControlString(100, "time zone").min(1)
+  }),
+  z.object({ type: z.literal("manual"), mailbox_ids: z.array(idSchema).min(1).max(100) }),
+  z.object({
+    type: z.literal("thread_state"),
+    mailbox_ids: z.array(idSchema).min(1).max(100),
+    state: z.literal("no_reply_after"),
+    duration_minutes: z.number().int().min(15).max(525600)
+  })
+]);
+var automationConditionSchema = z.discriminatedUnion("type", [
+  z.object({ type: z.literal("sender_address"), addresses: z.array(emailSchema).min(1).max(100) }),
+  z.object({
+    type: z.literal("sender_domain"),
+    domains: z.array(noControlString(253, "sender domain").min(1)).min(1).max(100)
+  }),
+  z.object({
+    type: z.literal("subject_contains"),
+    values: z.array(noControlString(200, "subject value").min(1)).min(1).max(100)
+  }),
+  z.object({ type: z.literal("has_attachment"), value: z.boolean() }),
+  z.object({
+    type: z.literal("semantic_positive_match"),
+    instruction: noControlString(1e3, "semantic instruction").min(1),
+    minimum_confidence: z.number().min(0.5).max(1)
+  })
+]);
+var automationActionSchema = z.discriminatedUnion("type", [
+  z.object({
+    type: z.literal("create_reply_draft"),
+    instruction: noControlString(2e3, "draft instruction").min(1)
+  }),
+  z.object({
+    type: z.literal("reply_to_trigger_sender"),
+    instruction: noControlString(2e3, "reply instruction").min(1)
+  }),
+  z.object({ type: z.literal("archive_trigger_message") }),
+  z.object({
+    type: z.literal("move_trigger_message"),
+    mailbox_id: idSchema,
+    destination_folder_id: idSchema
+  }),
+  z.object({ type: z.literal("set_trigger_read_state"), is_read: z.boolean() }),
+  z.object({ type: z.literal("set_trigger_star_state"), is_starred: z.boolean() }),
+  z.object({
+    type: z.literal("generate_mail_report"),
+    metric: z.enum(["received", "sent", "unread"]),
+    lookback_minutes: z.number().int().min(15).max(525600)
+  })
+]);
+var automationDefinitionSchema = z.object({
+  trigger: automationTriggerSchema,
+  conditions: z.array(automationConditionSchema).max(20),
+  actions: z.array(automationActionSchema).min(1).max(10),
+  mode: z.enum(["draft", "send"]),
+  scope: z.object({
+    mailbox_ids: z.array(idSchema).min(1).max(100),
+    calendar_addresses: z.array(emailSchema).max(100)
+  })
+}).superRefine((definition, context) => {
+  const semantic = definition.conditions.some(
+    (condition) => condition.type === "semantic_positive_match"
+  );
+  const placement = definition.actions.some(
+    (action) => [
+      "archive_trigger_message",
+      "move_trigger_message",
+      "set_trigger_read_state",
+      "set_trigger_star_state"
+    ].includes(action.type)
+  );
+  const messageAction = definition.actions.some(
+    (action) => [
+      "create_reply_draft",
+      "reply_to_trigger_sender",
+      "archive_trigger_message",
+      "move_trigger_message",
+      "set_trigger_read_state",
+      "set_trigger_star_state"
+    ].includes(action.type)
+  );
+  if (definition.mode === "send" && definition.trigger.type !== "email_received") {
+    context.addIssue({
+      code: "custom",
+      message: "Send mode requires email_received.",
+      path: ["mode"]
+    });
+  }
+  if (definition.mode === "send" && semantic) {
+    context.addIssue({
+      code: "custom",
+      message: "Send mode cannot use semantic conditions.",
+      path: ["conditions"]
+    });
+  }
+  if (definition.trigger.type === "email_received" && !semantic && placement) {
+    context.addIssue({
+      code: "custom",
+      message: "Deterministic placement belongs in mailbox rules unless a semantic condition gates it.",
+      path: ["actions"]
+    });
+  }
+  if (messageAction && definition.trigger.type !== "email_received" && definition.trigger.type !== "thread_state") {
+    context.addIssue({
+      code: "custom",
+      message: "Message actions need an email or thread-state trigger.",
+      path: ["actions"]
+    });
+  }
+  if (definition.trigger.type === "email_received" && definition.actions.some((action) => action.type === "generate_mail_report")) {
+    context.addIssue({
+      code: "custom",
+      message: "Mail reports need a scheduled or manual trigger.",
+      path: ["actions"]
+    });
+  }
+  if (definition.mode === "send") {
+    const replies = definition.actions.filter(
+      (action) => action.type === "reply_to_trigger_sender"
+    );
+    if (replies.length !== 1 || definition.actions.length !== 1) {
+      context.addIssue({
+        code: "custom",
+        message: "Send mode supports exactly one automatic reply action.",
+        path: ["actions"]
+      });
+    }
+  }
+});
+var automationRunSummarySchema = z.object({
+  object: z.literal("automation_run"),
+  id: z.string(),
+  status: z.enum([
+    "queued",
+    "running",
+    "completed",
+    "failed",
+    "degraded",
+    "cancelled",
+    "skipped"
+  ]),
+  error_code: z.string().nullable(),
+  created_at: z.string()
+});
+var automationRunSchema = z.object({
+  object: z.literal("automation_run"),
+  id: z.string(),
+  automation_id: z.string(),
+  status: z.literal("queued")
+});
+var automationSchema = z.object({
+  object: z.literal("automation"),
+  id: z.string(),
+  name: z.string(),
+  status: z.enum(["active", "paused", "disabled"]),
+  version_id: z.string(),
+  version: z.number().int(),
+  definition: automationDefinitionSchema,
+  last_run: automationRunSummarySchema.nullable(),
+  next_run_at: z.string().nullable(),
+  created_at: z.string(),
+  updated_at: z.string()
+});
+var automationByIdInputSchema = z.object({ id: idSchema });
+var createAutomationInputSchema = z.object({
+  name: noControlString(100, "automation name").min(1),
+  definition: automationDefinitionSchema,
+  idempotency_key: idempotencyKeySchema
+});
+var updateAutomationInputSchema = z.object({
+  id: idSchema,
+  name: noControlString(100, "automation name").min(1).optional(),
+  definition: automationDefinitionSchema.optional(),
+  status: z.enum(["active", "paused", "disabled"]).optional(),
+  idempotency_key: idempotencyKeySchema
+}).refine(
+  (value) => value.name !== void 0 || value.definition !== void 0 || value.status !== void 0,
+  "Provide name, definition, or status."
+);
+var runAutomationInputSchema = z.object({
+  id: idSchema,
+  idempotency_key: idempotencyKeySchema
+});
+var automationOutputSchema = z.object({ automation: automationSchema });
+var automationsOutputSchema = z.object({ data: z.array(automationSchema) });
+var automationRunOutputSchema = z.object({ automation_run: automationRunSchema });
 var bookingPageSchema = z.object({
   object: z.literal("booking_page"),
   id: z.string(),
@@ -4141,6 +4347,9 @@ var SESSION_LIMITS = {
   shipmail_create_booking_page: 20,
   shipmail_update_booking_page: 20,
   shipmail_delete_booking_page: 10,
+  shipmail_create_automation: 20,
+  shipmail_update_automation: 20,
+  shipmail_run_automation: 20,
   shipmail_create_partner_organization: 20,
   shipmail_update_partner_organization: 50,
   shipmail_resend_partner_ownership_invitation: 20,
@@ -6861,6 +7070,103 @@ function registerTools(rawServer, client, allowedTools, grantedOrganizations = [
       )
     );
   });
+  registerIfAllowed("shipmail_list_automations", () => {
+    server.registerTool(
+      "shipmail_list_automations",
+      {
+        title: "List Automations",
+        description: "List assistant automations visible to this API key's mailbox constraints.",
+        outputSchema: automationsOutputSchema,
+        annotations: { readOnlyHint: true, openWorldHint: false }
+      },
+      async () => runTool(
+        "shipmail_list_automations",
+        automationsOutputSchema,
+        () => client.automations.list()
+      )
+    );
+  });
+  registerIfAllowed("shipmail_get_automation", () => {
+    server.registerTool(
+      "shipmail_get_automation",
+      {
+        title: "Get Automation",
+        description: "Fetch one assistant automation by ID.",
+        inputSchema: automationByIdInputSchema,
+        outputSchema: automationOutputSchema,
+        annotations: { readOnlyHint: true, openWorldHint: false }
+      },
+      async ({ id }) => runTool("shipmail_get_automation", automationOutputSchema, async () => ({
+        automation: await client.automations.get(id)
+      }))
+    );
+  });
+  registerIfAllowed("shipmail_create_automation", () => {
+    server.registerTool(
+      "shipmail_create_automation",
+      {
+        title: "Create Automation",
+        description: "Create and activate an assistant automation from an explicit reviewed definition. This persists behavior until paused or disabled.",
+        inputSchema: createAutomationInputSchema,
+        outputSchema: automationOutputSchema,
+        annotations: {
+          readOnlyHint: false,
+          destructiveHint: false,
+          idempotentHint: true,
+          openWorldHint: false
+        }
+      },
+      async (args) => runTool("shipmail_create_automation", automationOutputSchema, async () => ({
+        automation: await client.automations.create(
+          stripIdempotencyKey(args),
+          mutationOptions(args)
+        )
+      }))
+    );
+  });
+  registerIfAllowed("shipmail_update_automation", () => {
+    server.registerTool(
+      "shipmail_update_automation",
+      {
+        title: "Update Automation",
+        description: "Change an automation's name, reviewed definition, or status. Definition changes create and activate a new immutable version.",
+        inputSchema: updateAutomationInputSchema,
+        outputSchema: automationOutputSchema,
+        annotations: {
+          readOnlyHint: false,
+          destructiveHint: false,
+          idempotentHint: true,
+          openWorldHint: false
+        }
+      },
+      async (args) => runTool("shipmail_update_automation", automationOutputSchema, async () => {
+        const { id, idempotency_key: _key, ...params } = args;
+        return {
+          automation: await client.automations.update(id, params, mutationOptions(args))
+        };
+      })
+    );
+  });
+  registerIfAllowed("shipmail_run_automation", () => {
+    server.registerTool(
+      "shipmail_run_automation",
+      {
+        title: "Run Automation",
+        description: "Queue one run of a manual automation.",
+        inputSchema: runAutomationInputSchema,
+        outputSchema: automationRunOutputSchema,
+        annotations: {
+          readOnlyHint: false,
+          destructiveHint: false,
+          idempotentHint: true,
+          openWorldHint: false
+        }
+      },
+      async (args) => runTool("shipmail_run_automation", automationRunOutputSchema, async () => ({
+        automation_run: await client.automations.run(args.id, mutationOptions(args))
+      }))
+    );
+  });
   registerIfAllowed("shipmail_list_booking_pages", () => {
     server.registerTool(
       "shipmail_list_booking_pages",
@@ -7168,7 +7474,7 @@ function registerTools(rawServer, client, allowedTools, grantedOrganizations = [
 }
 
 // src/version.ts
-var VERSION = "0.7.2";
+var VERSION = "0.7.3";
 
 // src/server.ts
 var INSTRUCTIONS = `Shipmail MCP exposes the business email and calendar tools authorized by the connection's current Shipmail permissions.

package/dist/server.js

@@ -18,7 +18,8 @@ var MCP_MEMBER_PERMISSION_GROUP_NAMES = [
   "mailbox_rules",
   "send_mail",
   "calendar_read",
-  "calendar_write"
+  "calendar_write",
+  "automations"
 ];
 var MCP_PERMISSION_GROUPS = [
   {
@@ -28,6 +29,13 @@ var MCP_PERMISSION_GROUPS = [
     scopes: [],
     persistent: false
   },
+  {
+    name: "automations",
+    label: "Automations",
+    description: "Read and manage persistent assistant automations.",
+    scopes: ["automations:read", "automations:write"],
+    persistent: true
+  },
   {
     name: "mail_read",
     label: "Read mail",
@@ -163,6 +171,11 @@ var MCP_PERMISSION_GROUPS = [
 ];
 var CAPABILITY_ROWS = [
   ["shipmail_status", "getStatus", "public"],
+  ["shipmail_list_automations", "listAutomations", "automations:read"],
+  ["shipmail_create_automation", "createAutomation", "automations:write"],
+  ["shipmail_get_automation", "getAutomation", "automations:read"],
+  ["shipmail_update_automation", "updateAutomation", "automations:write"],
+  ["shipmail_run_automation", "runAutomation", "automations:write"],
   ["shipmail_create_domain", "createDomain", "domains:write"],
   ["shipmail_list_domains", "listDomains", "domains:read"],
   ["shipmail_get_domain", "getDomain", "domains:read"],
@@ -417,6 +430,7 @@ function permissionGroupFor(toolName, requiredScope) {
   if (requiredScope === "calendar:read") return "calendar_read";
   if (requiredScope === "calendar:write") return "calendar_write";
   if (requiredScope.startsWith("booking_pages:")) return "booking_pages";
+  if (requiredScope.startsWith("automations:")) return "automations";
   if (requiredScope.startsWith("webhooks:")) return "webhooks";
   if (requiredScope.startsWith("newsletters:")) return "newsletters";
   if (requiredScope.startsWith("audiences:")) return "audiences";
@@ -441,10 +455,11 @@ function recipientControlFor(toolName) {
   return "none";
 }
 function durationFor(toolName) {
+  if (toolName === "shipmail_run_automation") return "one_shot";
   if (toolName.includes("app_password") || toolName.includes("credential_grant") || toolName === "shipmail_rotate_webhook_secret") {
     return "credential";
   }
-  if (toolName.includes("forwarding") || toolName.includes("mailbox_rules") || toolName.includes("webhook") || toolName.includes("booking_page")) {
+  if (toolName.includes("forwarding") || toolName.includes("mailbox_rules") || toolName.includes("webhook") || toolName.includes("booking_page") || toolName.includes("automation")) {
     return "persistent";
   }
   if (toolName === "shipmail_send_message" || toolName.includes("schedule_") || toolName.includes("scheduled_message")) {
@@ -2852,6 +2867,197 @@ var calendarAvailabilitySchema = z.object({
   timezone: z.string(),
   slots: z.array(calendarAvailabilitySlotSchema)
 });
+var automationTriggerSchema = z.discriminatedUnion("type", [
+  z.object({ type: z.literal("email_received"), mailbox_ids: z.array(idSchema).min(1).max(100) }),
+  z.object({
+    type: z.literal("scheduled"),
+    cron: noControlString(100, "cron").min(9),
+    time_zone: noControlString(100, "time zone").min(1)
+  }),
+  z.object({ type: z.literal("manual"), mailbox_ids: z.array(idSchema).min(1).max(100) }),
+  z.object({
+    type: z.literal("thread_state"),
+    mailbox_ids: z.array(idSchema).min(1).max(100),
+    state: z.literal("no_reply_after"),
+    duration_minutes: z.number().int().min(15).max(525600)
+  })
+]);
+var automationConditionSchema = z.discriminatedUnion("type", [
+  z.object({ type: z.literal("sender_address"), addresses: z.array(emailSchema).min(1).max(100) }),
+  z.object({
+    type: z.literal("sender_domain"),
+    domains: z.array(noControlString(253, "sender domain").min(1)).min(1).max(100)
+  }),
+  z.object({
+    type: z.literal("subject_contains"),
+    values: z.array(noControlString(200, "subject value").min(1)).min(1).max(100)
+  }),
+  z.object({ type: z.literal("has_attachment"), value: z.boolean() }),
+  z.object({
+    type: z.literal("semantic_positive_match"),
+    instruction: noControlString(1e3, "semantic instruction").min(1),
+    minimum_confidence: z.number().min(0.5).max(1)
+  })
+]);
+var automationActionSchema = z.discriminatedUnion("type", [
+  z.object({
+    type: z.literal("create_reply_draft"),
+    instruction: noControlString(2e3, "draft instruction").min(1)
+  }),
+  z.object({
+    type: z.literal("reply_to_trigger_sender"),
+    instruction: noControlString(2e3, "reply instruction").min(1)
+  }),
+  z.object({ type: z.literal("archive_trigger_message") }),
+  z.object({
+    type: z.literal("move_trigger_message"),
+    mailbox_id: idSchema,
+    destination_folder_id: idSchema
+  }),
+  z.object({ type: z.literal("set_trigger_read_state"), is_read: z.boolean() }),
+  z.object({ type: z.literal("set_trigger_star_state"), is_starred: z.boolean() }),
+  z.object({
+    type: z.literal("generate_mail_report"),
+    metric: z.enum(["received", "sent", "unread"]),
+    lookback_minutes: z.number().int().min(15).max(525600)
+  })
+]);
+var automationDefinitionSchema = z.object({
+  trigger: automationTriggerSchema,
+  conditions: z.array(automationConditionSchema).max(20),
+  actions: z.array(automationActionSchema).min(1).max(10),
+  mode: z.enum(["draft", "send"]),
+  scope: z.object({
+    mailbox_ids: z.array(idSchema).min(1).max(100),
+    calendar_addresses: z.array(emailSchema).max(100)
+  })
+}).superRefine((definition, context) => {
+  const semantic = definition.conditions.some(
+    (condition) => condition.type === "semantic_positive_match"
+  );
+  const placement = definition.actions.some(
+    (action) => [
+      "archive_trigger_message",
+      "move_trigger_message",
+      "set_trigger_read_state",
+      "set_trigger_star_state"
+    ].includes(action.type)
+  );
+  const messageAction = definition.actions.some(
+    (action) => [
+      "create_reply_draft",
+      "reply_to_trigger_sender",
+      "archive_trigger_message",
+      "move_trigger_message",
+      "set_trigger_read_state",
+      "set_trigger_star_state"
+    ].includes(action.type)
+  );
+  if (definition.mode === "send" && definition.trigger.type !== "email_received") {
+    context.addIssue({
+      code: "custom",
+      message: "Send mode requires email_received.",
+      path: ["mode"]
+    });
+  }
+  if (definition.mode === "send" && semantic) {
+    context.addIssue({
+      code: "custom",
+      message: "Send mode cannot use semantic conditions.",
+      path: ["conditions"]
+    });
+  }
+  if (definition.trigger.type === "email_received" && !semantic && placement) {
+    context.addIssue({
+      code: "custom",
+      message: "Deterministic placement belongs in mailbox rules unless a semantic condition gates it.",
+      path: ["actions"]
+    });
+  }
+  if (messageAction && definition.trigger.type !== "email_received" && definition.trigger.type !== "thread_state") {
+    context.addIssue({
+      code: "custom",
+      message: "Message actions need an email or thread-state trigger.",
+      path: ["actions"]
+    });
+  }
+  if (definition.trigger.type === "email_received" && definition.actions.some((action) => action.type === "generate_mail_report")) {
+    context.addIssue({
+      code: "custom",
+      message: "Mail reports need a scheduled or manual trigger.",
+      path: ["actions"]
+    });
+  }
+  if (definition.mode === "send") {
+    const replies = definition.actions.filter(
+      (action) => action.type === "reply_to_trigger_sender"
+    );
+    if (replies.length !== 1 || definition.actions.length !== 1) {
+      context.addIssue({
+        code: "custom",
+        message: "Send mode supports exactly one automatic reply action.",
+        path: ["actions"]
+      });
+    }
+  }
+});
+var automationRunSummarySchema = z.object({
+  object: z.literal("automation_run"),
+  id: z.string(),
+  status: z.enum([
+    "queued",
+    "running",
+    "completed",
+    "failed",
+    "degraded",
+    "cancelled",
+    "skipped"
+  ]),
+  error_code: z.string().nullable(),
+  created_at: z.string()
+});
+var automationRunSchema = z.object({
+  object: z.literal("automation_run"),
+  id: z.string(),
+  automation_id: z.string(),
+  status: z.literal("queued")
+});
+var automationSchema = z.object({
+  object: z.literal("automation"),
+  id: z.string(),
+  name: z.string(),
+  status: z.enum(["active", "paused", "disabled"]),
+  version_id: z.string(),
+  version: z.number().int(),
+  definition: automationDefinitionSchema,
+  last_run: automationRunSummarySchema.nullable(),
+  next_run_at: z.string().nullable(),
+  created_at: z.string(),
+  updated_at: z.string()
+});
+var automationByIdInputSchema = z.object({ id: idSchema });
+var createAutomationInputSchema = z.object({
+  name: noControlString(100, "automation name").min(1),
+  definition: automationDefinitionSchema,
+  idempotency_key: idempotencyKeySchema
+});
+var updateAutomationInputSchema = z.object({
+  id: idSchema,
+  name: noControlString(100, "automation name").min(1).optional(),
+  definition: automationDefinitionSchema.optional(),
+  status: z.enum(["active", "paused", "disabled"]).optional(),
+  idempotency_key: idempotencyKeySchema
+}).refine(
+  (value) => value.name !== void 0 || value.definition !== void 0 || value.status !== void 0,
+  "Provide name, definition, or status."
+);
+var runAutomationInputSchema = z.object({
+  id: idSchema,
+  idempotency_key: idempotencyKeySchema
+});
+var automationOutputSchema = z.object({ automation: automationSchema });
+var automationsOutputSchema = z.object({ data: z.array(automationSchema) });
+var automationRunOutputSchema = z.object({ automation_run: automationRunSchema });
 var bookingPageSchema = z.object({
   object: z.literal("booking_page"),
   id: z.string(),
@@ -4044,6 +4250,9 @@ var SESSION_LIMITS = {
   shipmail_create_booking_page: 20,
   shipmail_update_booking_page: 20,
   shipmail_delete_booking_page: 10,
+  shipmail_create_automation: 20,
+  shipmail_update_automation: 20,
+  shipmail_run_automation: 20,
   shipmail_create_partner_organization: 20,
   shipmail_update_partner_organization: 50,
   shipmail_resend_partner_ownership_invitation: 20,
@@ -6764,6 +6973,103 @@ function registerTools(rawServer, client, allowedTools, grantedOrganizations = [
       )
     );
   });
+  registerIfAllowed("shipmail_list_automations", () => {
+    server.registerTool(
+      "shipmail_list_automations",
+      {
+        title: "List Automations",
+        description: "List assistant automations visible to this API key's mailbox constraints.",
+        outputSchema: automationsOutputSchema,
+        annotations: { readOnlyHint: true, openWorldHint: false }
+      },
+      async () => runTool(
+        "shipmail_list_automations",
+        automationsOutputSchema,
+        () => client.automations.list()
+      )
+    );
+  });
+  registerIfAllowed("shipmail_get_automation", () => {
+    server.registerTool(
+      "shipmail_get_automation",
+      {
+        title: "Get Automation",
+        description: "Fetch one assistant automation by ID.",
+        inputSchema: automationByIdInputSchema,
+        outputSchema: automationOutputSchema,
+        annotations: { readOnlyHint: true, openWorldHint: false }
+      },
+      async ({ id }) => runTool("shipmail_get_automation", automationOutputSchema, async () => ({
+        automation: await client.automations.get(id)
+      }))
+    );
+  });
+  registerIfAllowed("shipmail_create_automation", () => {
+    server.registerTool(
+      "shipmail_create_automation",
+      {
+        title: "Create Automation",
+        description: "Create and activate an assistant automation from an explicit reviewed definition. This persists behavior until paused or disabled.",
+        inputSchema: createAutomationInputSchema,
+        outputSchema: automationOutputSchema,
+        annotations: {
+          readOnlyHint: false,
+          destructiveHint: false,
+          idempotentHint: true,
+          openWorldHint: false
+        }
+      },
+      async (args) => runTool("shipmail_create_automation", automationOutputSchema, async () => ({
+        automation: await client.automations.create(
+          stripIdempotencyKey(args),
+          mutationOptions(args)
+        )
+      }))
+    );
+  });
+  registerIfAllowed("shipmail_update_automation", () => {
+    server.registerTool(
+      "shipmail_update_automation",
+      {
+        title: "Update Automation",
+        description: "Change an automation's name, reviewed definition, or status. Definition changes create and activate a new immutable version.",
+        inputSchema: updateAutomationInputSchema,
+        outputSchema: automationOutputSchema,
+        annotations: {
+          readOnlyHint: false,
+          destructiveHint: false,
+          idempotentHint: true,
+          openWorldHint: false
+        }
+      },
+      async (args) => runTool("shipmail_update_automation", automationOutputSchema, async () => {
+        const { id, idempotency_key: _key, ...params } = args;
+        return {
+          automation: await client.automations.update(id, params, mutationOptions(args))
+        };
+      })
+    );
+  });
+  registerIfAllowed("shipmail_run_automation", () => {
+    server.registerTool(
+      "shipmail_run_automation",
+      {
+        title: "Run Automation",
+        description: "Queue one run of a manual automation.",
+        inputSchema: runAutomationInputSchema,
+        outputSchema: automationRunOutputSchema,
+        annotations: {
+          readOnlyHint: false,
+          destructiveHint: false,
+          idempotentHint: true,
+          openWorldHint: false
+        }
+      },
+      async (args) => runTool("shipmail_run_automation", automationRunOutputSchema, async () => ({
+        automation_run: await client.automations.run(args.id, mutationOptions(args))
+      }))
+    );
+  });
   registerIfAllowed("shipmail_list_booking_pages", () => {
     server.registerTool(
       "shipmail_list_booking_pages",
@@ -7071,7 +7377,7 @@ function registerTools(rawServer, client, allowedTools, grantedOrganizations = [
 }
 
 // src/version.ts
-var VERSION = "0.7.2";
+var VERSION = "0.7.3";
 
 // src/server.ts
 var INSTRUCTIONS = `Shipmail MCP exposes the business email and calendar tools authorized by the connection's current Shipmail permissions.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shipmail-mcp",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "mcpName": "io.github.shipmail-to/shipmail-mcp",
   "description": "Official Model Context Protocol (MCP) server for Shipmail, a business email provider with REST API, webhooks, and custom-domain inboxes for AI agents.",
   "type": "module",
@@ -67,7 +67,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/server": "2.0.0",
-    "shipmail": "0.4.13",
+    "shipmail": "0.4.14",
     "zod": "4.4.3"
   },
   "devDependencies": {

package/server.json

@@ -6,7 +6,7 @@
     "url": "https://github.com/shipmail-to/shipmail-mcp",
     "source": "github"
   },
-  "version": "0.7.2",
+  "version": "0.7.3",
   "websiteUrl": "https://shipmail.to/docs/mcp",
   "remotes": [
     {
@@ -27,7 +27,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "shipmail-mcp",
-      "version": "0.7.2",
+      "version": "0.7.3",
       "transport": {
         "type": "stdio"
       },

package/smithery.yaml

@@ -1,6 +1,6 @@
 # Smithery configuration file: https://smithery.ai/docs/build/project-config/smithery-yaml
 name: shipmail-mcp
-version: 0.7.2
+version: 0.7.3
 description: Official Shipmail MCP server for AI-agent custom-domain business email inboxes with REST API and webhooks.
 author: Shipmail
 repository: https://github.com/shipmail-to/shipmail-mcp