shipmail-mcp 0.8.3 → 0.8.7

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "shipmail",
-  "version": "0.8.3",
+  "version": "0.8.7",
   "description": "Operate secure custom-domain business email, calendars, and agent inboxes with Shipmail.",
   "author": {
     "name": "Shipmail",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "shipmail",
-  "version": "0.8.3",
+  "version": "0.8.7",
   "description": "Operate secure custom-domain business email, calendars, and agent inboxes with Shipmail.",
   "author": {
     "name": "Shipmail",

package/.plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "shipmail",
-  "version": "0.8.3",
+  "version": "0.8.7",
   "description": "Operate secure custom-domain business email, calendars, and agent inboxes with Shipmail.",
   "author": {
     "name": "Shipmail",

package/README.md

@@ -261,7 +261,7 @@ All tools are namespaced with `shipmail_` to avoid collisions with peer MCP serv
 | Status                                  | `shipmail_status`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
 | Domains                                 | `shipmail_list_domains`, `shipmail_get_domain`, `shipmail_get_domain_dns_records`, `shipmail_create_domain`, `shipmail_update_domain`, `shipmail_delete_domain`, `shipmail_verify_domain`, `shipmail_search_domains`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
 | Mailboxes                               | `shipmail_list_mailboxes`, `shipmail_get_mailbox`, `shipmail_create_mailbox`, `shipmail_update_mailbox`, `shipmail_delete_mailbox`, `shipmail_suspend_mailbox`, `shipmail_resume_mailbox`, `shipmail_list_mailbox_app_passwords`, `shipmail_create_mailbox_app_password`, `shipmail_revoke_mailbox_app_password`, `shipmail_list_mailbox_forwarding`, `shipmail_create_mailbox_forwarding`, `shipmail_delete_mailbox_forwarding`, `shipmail_list_mailbox_folders`, `shipmail_create_mailbox_folder`, `shipmail_update_mailbox_folder`, `shipmail_delete_mailbox_folder`, `shipmail_list_mailbox_rules`, `shipmail_get_mailbox_rule`, `shipmail_create_mailbox_rule`, `shipmail_update_mailbox_rule`, `shipmail_delete_mailbox_rule`, `shipmail_list_mailbox_identities`, `shipmail_reset_mailbox_password`, `shipmail_set_auto_reply`, `shipmail_inject_sandbox_inbound` |
-| Mailbox inbox                           | `shipmail_list_mailbox_inbox_messages`, `shipmail_get_mailbox_inbox_message`, `shipmail_read_mailbox_inbox_attachment`, `shipmail_get_mailbox_inbox_thread`, `shipmail_list_mailbox_inbox_threads`, `shipmail_update_inbox_thread_attention`, `shipmail_create_inbox_reply_draft`, `shipmail_send_inbox_reply_draft`, `shipmail_update_inbox_message`, `shipmail_move_inbox_message`, `shipmail_delete_inbox_message`                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| Mailbox inbox                           | `shipmail_list_mailbox_inbox_messages`, `shipmail_get_mailbox_inbox_message`, `shipmail_read_mailbox_inbox_attachment`, `shipmail_get_mailbox_inbox_thread`, `shipmail_list_mailbox_inbox_threads`, `shipmail_update_inbox_thread_attention`, `shipmail_create_draft`, `shipmail_create_inbox_reply_draft`, `shipmail_send_inbox_reply_draft`, `shipmail_update_inbox_message`, `shipmail_move_inbox_message`, `shipmail_delete_inbox_message`                                                                                                                                                                                                                                                                                                                                                                                                                           |
 | Reply scans                             | `shipmail_create_reply_scan`, `shipmail_get_reply_scan`, `shipmail_list_reply_scan_results`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | Messages and threads                    | `shipmail_list_messages`, `shipmail_list_message_analytics`, `shipmail_get_message`, `shipmail_compose_message_with_file` (hosted MCP Apps), `shipmail_prepare_staged_attachment_upload`, `shipmail_send_message`, `shipmail_list_scheduled_messages`, `shipmail_get_scheduled_message`, `shipmail_update_scheduled_message`, `shipmail_cancel_scheduled_message`, `shipmail_reply_to_message`, `shipmail_list_threads`, `shipmail_get_thread`, `shipmail_reply_to_thread`, `shipmail_reply_to_inbox_message`, `shipmail_reply_to_inbox_thread`                                                                                                                                                                                                                                                                                                                          |
 | Webhooks                                | `shipmail_list_webhooks`, `shipmail_get_webhook`, `shipmail_create_webhook`, `shipmail_update_webhook`, `shipmail_delete_webhook`, `shipmail_rotate_webhook_secret`, `shipmail_test_webhook`, `shipmail_list_webhook_deliveries`, `shipmail_get_webhook_delivery`, `shipmail_replay_webhook_delivery`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
@@ -321,6 +321,10 @@ thread version used to create the draft. `shipmail_send_inbox_reply_draft` rejec
 the conversation changed before approval. The direct reply tools remain available as lower-level
 operations for callers that already provide their own review and concurrency controls.
 
+To start a new conversation without send access, use `shipmail_create_draft`. It saves the message
+to the mailbox's Drafts folder and sends nothing; the user reviews, edits, and sends it from Drafts
+in Shipmail or any mail client. It needs only the `drafts:compose` scope.
+
 With an `sm_test_...` API key, send and reply tools accept `sandbox_outcome` and the sandbox inbound tool creates fake inbound mail. The API keeps test storage and events isolated and never delivers sandbox mail to real recipients.
 
 App-password creation, revocation, and partner grant consumption are destructive/high-risk tools.
@@ -387,7 +391,7 @@ Shipmail generates the primary credential and never returns it to the partner.
 - **Input sanitization**: Email content, addresses, and error text are stripped of ASCII control characters, DEL, and Unicode directional or BiDi markers (U+061C, U+200E/F, U+202A-E, U+2066-9). Long strings are truncated.
 - **Error redaction**: 5xx and unexpected Shipmail errors are redacted to a generic message; the original `request_id` is preserved for support. Generic `Error` thrown values (network errors, deserialization) are redacted to "Internal MCP error" before reaching the LLM. Detail lands on stderr.
 - **Circuit breaker**: Each session enforces per-tool rate limits and a hard total-call ceiling as a runaway-agent guard. These are not abuse controls. Real abuse limits live at the API per API key. Restart the server to reset.
-- **Least-privilege reply workflow**: Use `messages:read` for discovery, add `drafts:write` for reviewable draft creation, and grant `messages:send` only to agents that are allowed to transmit approved mail. A review-only agent does not need send access.
+- **Least-privilege draft workflow**: Use `messages:read` for discovery, add `drafts:write` for reviewable reply drafts and `drafts:compose` for new-message drafts saved to Drafts, and grant `messages:send` only to agents that are allowed to transmit approved mail. A review-only agent does not need send access: `drafts:compose` saves a draft but can never send it.
 - **Webhook URL validation**: Webhook URLs must be public https endpoints. Localhost, RFC1918, link-local, ULA, IPv4-mapped IPv6, `0.0.0.0`, decimal-int IPs, `.local`, and `.internal` hosts are rejected at input time.
 - **Destructive annotations**: Tools that delete, retarget, change persistent rules, rotate, reset credentials, or create automatic outbound responses are annotated with `destructiveHint`. Hosts that gate on this annotation will prompt the user. Annotated tools include `shipmail_update_domain`, `shipmail_update_webhook`, `shipmail_rotate_webhook_secret`, `shipmail_delete_mailbox_rule`, `shipmail_delete_mailbox_folder`, `shipmail_reset_mailbox_password`, and `shipmail_set_auto_reply` in addition to obvious deletes.
 

package/dist/capabilities.d.ts

@@ -1,9 +1,9 @@
 import { ApiKeyScope } from 'shipmail/api-key-scopes';
 
 declare const MCP_CAPABILITY_VERSION = "1.1.0";
-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", "members", "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", "compose_drafts", "mail_organize", "send_mail", "calendar_read", "calendar_write", "booking_pages", "forwarding", "mailbox_rules", "members", "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", "automations"];
+declare const MCP_MEMBER_PERMISSION_GROUP_NAMES: readonly ["account_status", "mail_read", "drafts", "compose_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";
@@ -40,6 +40,12 @@ declare const MCP_PERMISSION_GROUPS: readonly [{
     readonly description: "Create reply drafts whose recipients are derived by Shipmail.";
     readonly scopes: readonly ["drafts:write"];
     readonly persistent: false;
+}, {
+    readonly name: "compose_drafts";
+    readonly label: "Compose drafts";
+    readonly description: "Save new messages to Drafts for review. Cannot send.";
+    readonly scopes: readonly ["drafts:compose"];
+    readonly persistent: false;
 }, {
     readonly name: "mail_organize";
     readonly label: "Organize mail";
@@ -143,7 +149,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_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_create_mailbox_folder", "createMailboxFolder", "messages:write"], readonly ["shipmail_update_mailbox_folder", "updateMailboxFolder", "messages:write"], readonly ["shipmail_delete_mailbox_folder", "deleteMailboxFolder", "messages:write"], readonly ["shipmail_list_mailbox_rules", "getMailboxRules", "mailbox_rules:read"], readonly ["shipmail_get_mailbox_rule", "getMailboxRules", "mailbox_rules:read"], readonly ["shipmail_create_mailbox_rule", "updateMailboxRules", "mailbox_rules:write"], readonly ["shipmail_update_mailbox_rule", "updateMailboxRules", "mailbox_rules:write"], readonly ["shipmail_delete_mailbox_rule", "updateMailboxRules", "mailbox_rules: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_read_mailbox_inbox_attachment", "downloadMailboxInboxAttachment", "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_attention", "updateMailboxInboxThreadAttention", "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_get_mailbox_delivery_routing", "getMailboxDeliveryRouting", "mailboxes:read"], readonly ["shipmail_update_mailbox_delivery_routing", "updateMailboxDeliveryRouting", "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_resume_mailbox_import", "resumeMailboxImport", "mailboxes:write"], readonly ["shipmail_restore_mailbox_import", "restoreMailboxImport", "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_list_members", "listMembers", "members:read"], readonly ["shipmail_get_member", "getMember", "members: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_upload_newsletter_asset_with_file", "prepareNewsletterAssetUpload", "newsletters:write"], readonly ["shipmail_prepare_newsletter_asset_upload", "prepareNewsletterAssetUpload", "newsletters:write"], 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_create_mailbox_folder", "createMailboxFolder", "messages:write"], readonly ["shipmail_update_mailbox_folder", "updateMailboxFolder", "messages:write"], readonly ["shipmail_delete_mailbox_folder", "deleteMailboxFolder", "messages:write"], readonly ["shipmail_list_mailbox_rules", "getMailboxRules", "mailbox_rules:read"], readonly ["shipmail_get_mailbox_rule", "getMailboxRules", "mailbox_rules:read"], readonly ["shipmail_create_mailbox_rule", "updateMailboxRules", "mailbox_rules:write"], readonly ["shipmail_update_mailbox_rule", "updateMailboxRules", "mailbox_rules:write"], readonly ["shipmail_delete_mailbox_rule", "updateMailboxRules", "mailbox_rules: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_read_mailbox_inbox_attachment", "downloadMailboxInboxAttachment", "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_attention", "updateMailboxInboxThreadAttention", "messages:write"], readonly ["shipmail_create_draft", "createMailboxInboxDraft", "drafts:compose"], 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_get_mailbox_delivery_routing", "getMailboxDeliveryRouting", "mailboxes:read"], readonly ["shipmail_update_mailbox_delivery_routing", "updateMailboxDeliveryRouting", "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_resume_mailbox_import", "resumeMailboxImport", "mailboxes:write"], readonly ["shipmail_restore_mailbox_import", "restoreMailboxImport", "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_list_members", "listMembers", "members:read"], readonly ["shipmail_get_member", "getMember", "members: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_upload_newsletter_asset_with_file", "prepareNewsletterAssetUpload", "newsletters:write"], readonly ["shipmail_prepare_newsletter_asset_upload", "prepareNewsletterAssetUpload", "newsletters:write"], 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

@@ -6,6 +6,7 @@ var MCP_PERMISSION_GROUP_NAMES = [
   "automations",
   "mail_read",
   "drafts",
+  "compose_drafts",
   "mail_organize",
   "send_mail",
   "calendar_read",
@@ -28,6 +29,7 @@ var MCP_MEMBER_PERMISSION_GROUP_NAMES = [
   "account_status",
   "mail_read",
   "drafts",
+  "compose_drafts",
   "mail_organize",
   "mailbox_rules",
   "send_mail",
@@ -64,6 +66,13 @@ var MCP_PERMISSION_GROUPS = [
     scopes: ["drafts:write"],
     persistent: false
   },
+  {
+    name: "compose_drafts",
+    label: "Compose drafts",
+    description: "Save new messages to Drafts for review. Cannot send.",
+    scopes: ["drafts:compose"],
+    persistent: false
+  },
   {
     name: "mail_organize",
     label: "Organize mail",
@@ -233,6 +242,7 @@ var CAPABILITY_ROWS = [
   ["shipmail_list_mailbox_inbox_threads", "listMailboxInboxThreads", "messages:read"],
   ["shipmail_get_mailbox_inbox_thread", "getMailboxInboxThread", "messages:read"],
   ["shipmail_update_inbox_thread_attention", "updateMailboxInboxThreadAttention", "messages:write"],
+  ["shipmail_create_draft", "createMailboxInboxDraft", "drafts:compose"],
   ["shipmail_create_inbox_reply_draft", "createMailboxInboxReplyDraft", "drafts:write"],
   ["shipmail_send_inbox_reply_draft", "sendMailboxInboxReplyDraft", "messages:send"],
   ["shipmail_reply_to_inbox_message", "replyToMailboxInboxMessage", "messages:send"],
@@ -433,6 +443,7 @@ var SERVER_DERIVED_RECIPIENT_TOOLS = /* @__PURE__ */ new Set([
 ]);
 var CALLER_SUPPLIED_RECIPIENT_TOOLS = /* @__PURE__ */ new Set([
   "shipmail_send_message",
+  "shipmail_create_draft",
   "shipmail_create_mailbox_forwarding",
   "shipmail_create_webhook",
   "shipmail_update_webhook",
@@ -455,6 +466,7 @@ function permissionGroupFor(toolName, requiredScope) {
   if (requiredScope.startsWith("mailbox_rules:")) return "mailbox_rules";
   if (requiredScope === "mailboxes:export") return "mailbox_export";
   if (requiredScope === "drafts:write") return "drafts";
+  if (requiredScope === "drafts:compose") return "compose_drafts";
   if (requiredScope === "messages:send") return "send_mail";
   if (requiredScope === "messages:write") return "mail_organize";
   if (requiredScope === "messages:read" || requiredScope === "threads:read") return "mail_read";

package/dist/index.js

@@ -111,6 +111,7 @@ var MCP_MEMBER_PERMISSION_GROUP_NAMES = [
   "account_status",
   "mail_read",
   "drafts",
+  "compose_drafts",
   "mail_organize",
   "mailbox_rules",
   "send_mail",
@@ -147,6 +148,13 @@ var MCP_PERMISSION_GROUPS = [
     scopes: ["drafts:write"],
     persistent: false
   },
+  {
+    name: "compose_drafts",
+    label: "Compose drafts",
+    description: "Save new messages to Drafts for review. Cannot send.",
+    scopes: ["drafts:compose"],
+    persistent: false
+  },
   {
     name: "mail_organize",
     label: "Organize mail",
@@ -316,6 +324,7 @@ var CAPABILITY_ROWS = [
   ["shipmail_list_mailbox_inbox_threads", "listMailboxInboxThreads", "messages:read"],
   ["shipmail_get_mailbox_inbox_thread", "getMailboxInboxThread", "messages:read"],
   ["shipmail_update_inbox_thread_attention", "updateMailboxInboxThreadAttention", "messages:write"],
+  ["shipmail_create_draft", "createMailboxInboxDraft", "drafts:compose"],
   ["shipmail_create_inbox_reply_draft", "createMailboxInboxReplyDraft", "drafts:write"],
   ["shipmail_send_inbox_reply_draft", "sendMailboxInboxReplyDraft", "messages:send"],
   ["shipmail_reply_to_inbox_message", "replyToMailboxInboxMessage", "messages:send"],
@@ -516,6 +525,7 @@ var SERVER_DERIVED_RECIPIENT_TOOLS = /* @__PURE__ */ new Set([
 ]);
 var CALLER_SUPPLIED_RECIPIENT_TOOLS = /* @__PURE__ */ new Set([
   "shipmail_send_message",
+  "shipmail_create_draft",
   "shipmail_create_mailbox_forwarding",
   "shipmail_create_webhook",
   "shipmail_update_webhook",
@@ -538,6 +548,7 @@ function permissionGroupFor(toolName, requiredScope) {
   if (requiredScope.startsWith("mailbox_rules:")) return "mailbox_rules";
   if (requiredScope === "mailboxes:export") return "mailbox_export";
   if (requiredScope === "drafts:write") return "drafts";
+  if (requiredScope === "drafts:compose") return "compose_drafts";
   if (requiredScope === "messages:send") return "send_mail";
   if (requiredScope === "messages:write") return "mail_organize";
   if (requiredScope === "messages:read" || requiredScope === "threads:read") return "mail_read";
@@ -661,6 +672,15 @@ var CLOSING_KEYWORDS = /* @__PURE__ */ new Set(["additionalProperties", "unevalu
 function isSchemaNode(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function isStringTyped(node) {
+  const type = node["type"];
+  if (type === void 0) return true;
+  if (Array.isArray(type)) return type.includes("string");
+  return type === "string";
+}
+function isStringEnum(value) {
+  return Array.isArray(value) && value.length > 0 && value.every((entry) => typeof entry === "string");
+}
 function openSchemaValue(value) {
   if (Array.isArray(value)) return value.map((entry) => openSchemaValue(entry));
   return isSchemaNode(value) ? openSchemaNode(value) : value;
@@ -675,15 +695,25 @@ function openSchemaRecord(value) {
 }
 function openSchemaNode(node) {
   const opened = {};
+  const stringTyped = isStringTyped(node);
+  const mergeUnion = Object.hasOwn(node, "oneOf");
+  const union = [];
   for (const keyword of Object.getOwnPropertyNames(node)) {
     const value = node[keyword];
     if (value === false && CLOSING_KEYWORDS.has(keyword)) continue;
+    if (stringTyped && keyword === "enum" && isStringEnum(value)) continue;
+    if (stringTyped && keyword === "const" && typeof value === "string") continue;
+    if (mergeUnion && (keyword === "oneOf" || keyword === "anyOf") && Array.isArray(value)) {
+      union.push(...value.map((branch) => openSchemaValue(branch)));
+      continue;
+    }
     if (SCHEMA_RECORD_KEYWORDS.has(keyword)) {
       opened[keyword] = openSchemaRecord(value);
       continue;
     }
     opened[keyword] = SCHEMA_KEYWORDS.has(keyword) ? openSchemaValue(value) : value;
   }
+  if (union.length > 0) opened["anyOf"] = union;
   return opened;
 }
 function openJsonSchemaObjects(schema) {
@@ -1518,6 +1548,19 @@ var inboxReplyDraftSchema = z.object({
   cc: z.array(replyDraftRecipientSchema),
   created_at: z.string()
 });
+var inboxDraftSchema = z.object({
+  object: z.literal("inbox_draft"),
+  id: z.string().describe(
+    "Inbox message ID of the saved draft. Read it with shipmail_get_mailbox_inbox_message."
+  ),
+  mailbox_id: z.string(),
+  from: replyDraftRecipientSchema,
+  to: z.array(replyDraftRecipientSchema),
+  cc: z.array(replyDraftRecipientSchema),
+  bcc: z.array(replyDraftRecipientSchema),
+  subject: z.string(),
+  created_at: z.string()
+});
 var inboxReplyDraftSendSchema = z.object({
   object: z.literal("inbox_reply_draft_send"),
   draft_id: z.string(),
@@ -1890,6 +1933,7 @@ var inboxThreadOutputSchema = z.object({ inbox_thread: inboxThreadSchema });
 var inboxThreadAttentionOutputSchema = z.object({
   inbox_thread_attention: inboxThreadAttentionResultSchema
 });
+var inboxDraftOutputSchema = z.object({ inbox_draft: inboxDraftSchema });
 var inboxReplyDraftOutputSchema = z.object({ inbox_reply_draft: inboxReplyDraftSchema });
 var inboxReplyDraftSendOutputSchema = z.object({
   inbox_reply_draft_send: inboxReplyDraftSendSchema
@@ -2032,7 +2076,8 @@ var importFolderSchema = z.object({
   source_folder: z.string(),
   target_folder: z.string().nullable(),
   role: z.string().nullable(),
-  state: z.enum(["pending", "importing", "completed", "failed"]),
+  // "skipped": the source server refused the folder; the import finished without it.
+  state: z.enum(["pending", "importing", "completed", "failed", "skipped"]),
   found: z.number(),
   imported: z.number(),
   duplicates: z.number(),
@@ -2300,6 +2345,20 @@ var updateInboxThreadAttentionInputSchema = z.object({
 }).refine((value) => value.done !== void 0 || value.follow_up_at !== void 0, {
   message: "Provide done or follow_up_at."
 });
+var createInboxDraftInputSchema = z.object({
+  id: idSchema.describe("Mailbox ID whose Drafts folder receives the draft."),
+  to: z.array(recipientInputSchema).min(1).max(50),
+  cc: z.array(recipientInputSchema).max(50).optional(),
+  bcc: z.array(recipientInputSchema).max(50).optional(),
+  subject: noControlString(998, "subject").optional(),
+  text: z.string().max(256e3).optional(),
+  html: z.string().max(512e3).optional(),
+  idempotency_key: idempotencyKeySchema
+}).strict().refine((value) => Boolean(value.text || value.html), {
+  message: "At least one of html or text is required."
+}).refine((value) => value.to.length + (value.cc?.length ?? 0) + (value.bcc?.length ?? 0) <= 50, {
+  message: "Total recipients (to + cc + bcc) must not exceed 50."
+});
 var createInboxReplyDraftInputSchema = z.object({
   id: idSchema.describe("Mailbox ID."),
   thread_id: noControlString(256, "thread_id").min(1),
@@ -2510,9 +2569,12 @@ var updateScheduledMessageInputSchema = z.object({
   staged_attachment_ids: z.array(z.string().regex(/^sat_[0-9a-z]+$/, "Invalid staged attachment ID.")).max(20).optional(),
   scheduled_at: z.iso.datetime(),
   idempotency_key: idempotencyKeySchema
-}).strict().refine((value) => Boolean(value.html || value.text), {
-  message: "At least one of html or text is required."
-});
+}).strict().refine(
+  (value) => value.html === void 0 && value.text === void 0 || Boolean(value.html) || Boolean(value.text),
+  {
+    message: "Provide a non-empty html or text, or omit both to keep the stored body."
+  }
+);
 var replyToMessageInputSchema = z.object({
   id: idSchema.describe("Message ID to reply to."),
   to: z.array(recipientInputSchema).min(1).max(50),
@@ -5129,6 +5191,7 @@ var SESSION_LIMITS = {
   shipmail_reply_to_thread: 10,
   shipmail_reply_to_inbox_message: 10,
   shipmail_reply_to_inbox_thread: 10,
+  shipmail_create_draft: 20,
   shipmail_create_inbox_reply_draft: 20,
   shipmail_send_inbox_reply_draft: 10,
   shipmail_update_inbox_thread_attention: 50,
@@ -6379,6 +6442,29 @@ function registerTools(rawServer, client, allowedTools, grantedOrganizations = [
       )
     );
   });
+  registerIfAllowed("shipmail_create_draft", () => {
+    server.registerTool(
+      "shipmail_create_draft",
+      {
+        title: "Save New Email Draft",
+        description: "Save a new email (not a reply) to the mailbox's Drafts folder. This only saves a draft: it sends nothing, and there is no tool to send it. The user reviews, edits, and sends it from Drafts in Shipmail or any mail client. Use shipmail_create_inbox_reply_draft to reply to an existing conversation.",
+        inputSchema: createInboxDraftInputSchema,
+        outputSchema: inboxDraftOutputSchema,
+        annotations: {
+          readOnlyHint: false,
+          destructiveHint: false,
+          idempotentHint: true,
+          openWorldHint: false
+        }
+      },
+      async (args) => runTool("shipmail_create_draft", inboxDraftOutputSchema, async () => {
+        const { id, ...params } = stripIdempotencyKey(args);
+        return {
+          inbox_draft: await client.mailboxes.createInboxDraft(id, params, mutationOptions(args))
+        };
+      })
+    );
+  });
   registerIfAllowed("shipmail_create_inbox_reply_draft", () => {
     server.registerTool(
       "shipmail_create_inbox_reply_draft",
@@ -8727,7 +8813,7 @@ function registerTools(rawServer, client, allowedTools, grantedOrganizations = [
 }
 
 // src/version.ts
-var VERSION = "0.8.3";
+var VERSION = "0.8.7";
 
 // 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

@@ -14,6 +14,7 @@ var MCP_MEMBER_PERMISSION_GROUP_NAMES = [
   "account_status",
   "mail_read",
   "drafts",
+  "compose_drafts",
   "mail_organize",
   "mailbox_rules",
   "send_mail",
@@ -50,6 +51,13 @@ var MCP_PERMISSION_GROUPS = [
     scopes: ["drafts:write"],
     persistent: false
   },
+  {
+    name: "compose_drafts",
+    label: "Compose drafts",
+    description: "Save new messages to Drafts for review. Cannot send.",
+    scopes: ["drafts:compose"],
+    persistent: false
+  },
   {
     name: "mail_organize",
     label: "Organize mail",
@@ -219,6 +227,7 @@ var CAPABILITY_ROWS = [
   ["shipmail_list_mailbox_inbox_threads", "listMailboxInboxThreads", "messages:read"],
   ["shipmail_get_mailbox_inbox_thread", "getMailboxInboxThread", "messages:read"],
   ["shipmail_update_inbox_thread_attention", "updateMailboxInboxThreadAttention", "messages:write"],
+  ["shipmail_create_draft", "createMailboxInboxDraft", "drafts:compose"],
   ["shipmail_create_inbox_reply_draft", "createMailboxInboxReplyDraft", "drafts:write"],
   ["shipmail_send_inbox_reply_draft", "sendMailboxInboxReplyDraft", "messages:send"],
   ["shipmail_reply_to_inbox_message", "replyToMailboxInboxMessage", "messages:send"],
@@ -419,6 +428,7 @@ var SERVER_DERIVED_RECIPIENT_TOOLS = /* @__PURE__ */ new Set([
 ]);
 var CALLER_SUPPLIED_RECIPIENT_TOOLS = /* @__PURE__ */ new Set([
   "shipmail_send_message",
+  "shipmail_create_draft",
   "shipmail_create_mailbox_forwarding",
   "shipmail_create_webhook",
   "shipmail_update_webhook",
@@ -441,6 +451,7 @@ function permissionGroupFor(toolName, requiredScope) {
   if (requiredScope.startsWith("mailbox_rules:")) return "mailbox_rules";
   if (requiredScope === "mailboxes:export") return "mailbox_export";
   if (requiredScope === "drafts:write") return "drafts";
+  if (requiredScope === "drafts:compose") return "compose_drafts";
   if (requiredScope === "messages:send") return "send_mail";
   if (requiredScope === "messages:write") return "mail_organize";
   if (requiredScope === "messages:read" || requiredScope === "threads:read") return "mail_read";
@@ -564,6 +575,15 @@ var CLOSING_KEYWORDS = /* @__PURE__ */ new Set(["additionalProperties", "unevalu
 function isSchemaNode(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function isStringTyped(node) {
+  const type = node["type"];
+  if (type === void 0) return true;
+  if (Array.isArray(type)) return type.includes("string");
+  return type === "string";
+}
+function isStringEnum(value) {
+  return Array.isArray(value) && value.length > 0 && value.every((entry) => typeof entry === "string");
+}
 function openSchemaValue(value) {
   if (Array.isArray(value)) return value.map((entry) => openSchemaValue(entry));
   return isSchemaNode(value) ? openSchemaNode(value) : value;
@@ -578,15 +598,25 @@ function openSchemaRecord(value) {
 }
 function openSchemaNode(node) {
   const opened = {};
+  const stringTyped = isStringTyped(node);
+  const mergeUnion = Object.hasOwn(node, "oneOf");
+  const union = [];
   for (const keyword of Object.getOwnPropertyNames(node)) {
     const value = node[keyword];
     if (value === false && CLOSING_KEYWORDS.has(keyword)) continue;
+    if (stringTyped && keyword === "enum" && isStringEnum(value)) continue;
+    if (stringTyped && keyword === "const" && typeof value === "string") continue;
+    if (mergeUnion && (keyword === "oneOf" || keyword === "anyOf") && Array.isArray(value)) {
+      union.push(...value.map((branch) => openSchemaValue(branch)));
+      continue;
+    }
     if (SCHEMA_RECORD_KEYWORDS.has(keyword)) {
       opened[keyword] = openSchemaRecord(value);
       continue;
     }
     opened[keyword] = SCHEMA_KEYWORDS.has(keyword) ? openSchemaValue(value) : value;
   }
+  if (union.length > 0) opened["anyOf"] = union;
   return opened;
 }
 function openJsonSchemaObjects(schema) {
@@ -1421,6 +1451,19 @@ var inboxReplyDraftSchema = z.object({
   cc: z.array(replyDraftRecipientSchema),
   created_at: z.string()
 });
+var inboxDraftSchema = z.object({
+  object: z.literal("inbox_draft"),
+  id: z.string().describe(
+    "Inbox message ID of the saved draft. Read it with shipmail_get_mailbox_inbox_message."
+  ),
+  mailbox_id: z.string(),
+  from: replyDraftRecipientSchema,
+  to: z.array(replyDraftRecipientSchema),
+  cc: z.array(replyDraftRecipientSchema),
+  bcc: z.array(replyDraftRecipientSchema),
+  subject: z.string(),
+  created_at: z.string()
+});
 var inboxReplyDraftSendSchema = z.object({
   object: z.literal("inbox_reply_draft_send"),
   draft_id: z.string(),
@@ -1793,6 +1836,7 @@ var inboxThreadOutputSchema = z.object({ inbox_thread: inboxThreadSchema });
 var inboxThreadAttentionOutputSchema = z.object({
   inbox_thread_attention: inboxThreadAttentionResultSchema
 });
+var inboxDraftOutputSchema = z.object({ inbox_draft: inboxDraftSchema });
 var inboxReplyDraftOutputSchema = z.object({ inbox_reply_draft: inboxReplyDraftSchema });
 var inboxReplyDraftSendOutputSchema = z.object({
   inbox_reply_draft_send: inboxReplyDraftSendSchema
@@ -1935,7 +1979,8 @@ var importFolderSchema = z.object({
   source_folder: z.string(),
   target_folder: z.string().nullable(),
   role: z.string().nullable(),
-  state: z.enum(["pending", "importing", "completed", "failed"]),
+  // "skipped": the source server refused the folder; the import finished without it.
+  state: z.enum(["pending", "importing", "completed", "failed", "skipped"]),
   found: z.number(),
   imported: z.number(),
   duplicates: z.number(),
@@ -2203,6 +2248,20 @@ var updateInboxThreadAttentionInputSchema = z.object({
 }).refine((value) => value.done !== void 0 || value.follow_up_at !== void 0, {
   message: "Provide done or follow_up_at."
 });
+var createInboxDraftInputSchema = z.object({
+  id: idSchema.describe("Mailbox ID whose Drafts folder receives the draft."),
+  to: z.array(recipientInputSchema).min(1).max(50),
+  cc: z.array(recipientInputSchema).max(50).optional(),
+  bcc: z.array(recipientInputSchema).max(50).optional(),
+  subject: noControlString(998, "subject").optional(),
+  text: z.string().max(256e3).optional(),
+  html: z.string().max(512e3).optional(),
+  idempotency_key: idempotencyKeySchema
+}).strict().refine((value) => Boolean(value.text || value.html), {
+  message: "At least one of html or text is required."
+}).refine((value) => value.to.length + (value.cc?.length ?? 0) + (value.bcc?.length ?? 0) <= 50, {
+  message: "Total recipients (to + cc + bcc) must not exceed 50."
+});
 var createInboxReplyDraftInputSchema = z.object({
   id: idSchema.describe("Mailbox ID."),
   thread_id: noControlString(256, "thread_id").min(1),
@@ -2413,9 +2472,12 @@ var updateScheduledMessageInputSchema = z.object({
   staged_attachment_ids: z.array(z.string().regex(/^sat_[0-9a-z]+$/, "Invalid staged attachment ID.")).max(20).optional(),
   scheduled_at: z.iso.datetime(),
   idempotency_key: idempotencyKeySchema
-}).strict().refine((value) => Boolean(value.html || value.text), {
-  message: "At least one of html or text is required."
-});
+}).strict().refine(
+  (value) => value.html === void 0 && value.text === void 0 || Boolean(value.html) || Boolean(value.text),
+  {
+    message: "Provide a non-empty html or text, or omit both to keep the stored body."
+  }
+);
 var replyToMessageInputSchema = z.object({
   id: idSchema.describe("Message ID to reply to."),
   to: z.array(recipientInputSchema).min(1).max(50),
@@ -5039,6 +5101,7 @@ var SESSION_LIMITS = {
   shipmail_reply_to_thread: 10,
   shipmail_reply_to_inbox_message: 10,
   shipmail_reply_to_inbox_thread: 10,
+  shipmail_create_draft: 20,
   shipmail_create_inbox_reply_draft: 20,
   shipmail_send_inbox_reply_draft: 10,
   shipmail_update_inbox_thread_attention: 50,
@@ -6289,6 +6352,29 @@ function registerTools(rawServer, client, allowedTools, grantedOrganizations = [
       )
     );
   });
+  registerIfAllowed("shipmail_create_draft", () => {
+    server.registerTool(
+      "shipmail_create_draft",
+      {
+        title: "Save New Email Draft",
+        description: "Save a new email (not a reply) to the mailbox's Drafts folder. This only saves a draft: it sends nothing, and there is no tool to send it. The user reviews, edits, and sends it from Drafts in Shipmail or any mail client. Use shipmail_create_inbox_reply_draft to reply to an existing conversation.",
+        inputSchema: createInboxDraftInputSchema,
+        outputSchema: inboxDraftOutputSchema,
+        annotations: {
+          readOnlyHint: false,
+          destructiveHint: false,
+          idempotentHint: true,
+          openWorldHint: false
+        }
+      },
+      async (args) => runTool("shipmail_create_draft", inboxDraftOutputSchema, async () => {
+        const { id, ...params } = stripIdempotencyKey(args);
+        return {
+          inbox_draft: await client.mailboxes.createInboxDraft(id, params, mutationOptions(args))
+        };
+      })
+    );
+  });
   registerIfAllowed("shipmail_create_inbox_reply_draft", () => {
     server.registerTool(
       "shipmail_create_inbox_reply_draft",
@@ -8637,7 +8723,7 @@ function registerTools(rawServer, client, allowedTools, grantedOrganizations = [
 }
 
 // src/version.ts
-var VERSION = "0.8.3";
+var VERSION = "0.8.7";
 
 // 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.8.3",
+  "version": "0.8.7",
   "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.5.3",
+    "shipmail": "0.5.8",
     "zod": "4.4.3"
   },
   "devDependencies": {

package/server.json

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

package/skills/shipmail/SKILL.md

@@ -30,7 +30,7 @@ Use Shipmail's hosted MCP server at `https://shipmail.to/api/mcp`. Prefer the na
 
 For inbox replies, prefer `shipmail_create_inbox_reply_draft`. Present the draft to the user and stop. After explicit approval, use `shipmail_send_inbox_reply_draft`.
 
-For a new message, assemble the sender identity, To/Cc/Bcc recipients, subject, text or HTML body, and attachments. Present those fields for approval before `shipmail_send_message`. Use `shipmail_reply_to_inbox_message`, `shipmail_reply_to_inbox_thread`, `shipmail_reply_to_message`, or `shipmail_reply_to_thread` only after the user approves the exact reply.
+For a new message, assemble the sender identity, To/Cc/Bcc recipients, subject, text or HTML body, and attachments. Present those fields for approval before `shipmail_send_message`. When the user wants a new message to review and send themselves, or the connection cannot send, use `shipmail_create_draft`: it saves the message to the mailbox's Drafts folder and sends nothing. Use `shipmail_reply_to_inbox_message`, `shipmail_reply_to_inbox_thread`, `shipmail_reply_to_message`, or `shipmail_reply_to_thread` only after the user approves the exact reply.
 
 When the user asks to schedule a message, state the exact delivery time and timezone before approval.
 

package/smithery.yaml

@@ -1,6 +1,6 @@
 # Smithery configuration file: https://smithery.ai/docs/build/project-config/smithery-yaml
 name: shipmail-mcp
-version: 0.8.3
+version: 0.8.7
 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