npm - shipmail-mcp - Versions diffs - 0.8.6 → 0.8.7 - Mend

shipmail-mcp 0.8.6 → 0.8.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/.claude-plugin/plugin.json +1 -1
package/.codex-plugin/plugin.json +1 -1
package/.plugin/plugin.json +1 -1
package/README.md +6 -2
package/dist/capabilities.d.ts +9 -3
package/dist/capabilities.js +12 -0
package/dist/index.js +64 -1
package/dist/server.js +64 -1
package/package.json +2 -2
package/server.json +2 -2
package/skills/shipmail/SKILL.md +1 -1
package/smithery.yaml +1 -1

package/.claude-plugin/plugin.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "shipmail",
-  "version": "0.8.6",
+  "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 CHANGED Viewed

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

package/.plugin/plugin.json CHANGED Viewed

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

package/README.md CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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";
@@ -1537,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(),
@@ -1909,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
@@ -2320,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),
@@ -5152,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,
@@ -6402,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",
@@ -8750,7 +8813,7 @@ function registerTools(rawServer, client, allowedTools, grantedOrganizations = [
 }
 // src/version.ts
-var VERSION = "0.8.6";
+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 CHANGED Viewed

@@ -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";
@@ -1440,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(),
@@ -1812,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
@@ -2223,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),
@@ -5062,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,
@@ -6312,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",
@@ -8660,7 +8723,7 @@ function registerTools(rawServer, client, allowedTools, grantedOrganizations = [
 }
 // src/version.ts
-var VERSION = "0.8.6";
+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 CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "shipmail-mcp",
-  "version": "0.8.6",
+  "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.6",
+    "shipmail": "0.5.8",
     "zod": "4.4.3"
   },
   "devDependencies": {

package/server.json CHANGED Viewed

@@ -6,7 +6,7 @@
     "url": "https://github.com/shipmail-to/shipmail-mcp",
     "source": "github"
   },
-  "version": "0.8.6",
+  "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.6",
+      "version": "0.8.7",
       "transport": {
         "type": "stdio"
       },

package/skills/shipmail/SKILL.md CHANGED Viewed

@@ -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 CHANGED Viewed

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