groundmail-mcp 0.12.1 → 0.13.0

package/dist/index.js

@@ -162,7 +162,8 @@ var emailItem = object(
     bounced_at: nullableString("When the email bounced (ISO 8601)"),
     opened_at: nullableString("First open (ISO 8601); needs open tracking on the sending domain"),
     clicked_at: nullableString("First tracked-link click (ISO 8601); needs click tracking on the sending domain"),
-    tenant: nullableString("External id of the tenant the email was sent as. Present only when it was sent as a tenant")
+    tenant: nullableString("External id of the tenant the email was sent as. Present only when it was sent as a tenant"),
+    stream: string("Mail stream it went out on: transactional, product or newsletter (each sends from its own IPs)")
   },
   ["id", "from", "to", "subject", "status"]
 );
@@ -628,6 +629,11 @@ async function callMcpTool(client, name, args) {
         if (!templateId && !subject) {
           return textResult("Provide subject, or template_id / template_alias", true);
         }
+        const categoryRaw = optString(args, "category");
+        if (categoryRaw && categoryRaw !== "transactional" && categoryRaw !== "product" && categoryRaw !== "newsletter") {
+          return textResult("category must be transactional, product or newsletter", true);
+        }
+        const category = categoryRaw;
         const variables = args.variables && typeof args.variables === "object" && !Array.isArray(args.variables) ? args.variables : void 0;
         const result = await client.emails.send({
           from,
@@ -636,17 +642,24 @@ async function callMcpTool(client, name, args) {
           html: optString(args, "html"),
           text: optString(args, "text"),
           reply_to: optString(args, "reply_to"),
+          ...category ? { category } : {},
           ...optString(args, "tenant") ? { tenant: optString(args, "tenant") } : {},
           ...templateId ? { template: { id: templateId, ...variables ? { variables } : {} } } : {}
         });
         return textResult(result);
       }
       case "list_emails": {
+        const streamRaw = optString(args, "stream");
+        if (streamRaw && streamRaw !== "transactional" && streamRaw !== "product" && streamRaw !== "newsletter") {
+          return textResult("stream must be transactional, product or newsletter", true);
+        }
+        const stream = streamRaw;
         const result = await client.emails.list({
           limit: optNumber(args, "limit"),
           cursor: optString(args, "cursor"),
           ...typeof args.test === "boolean" ? { test: args.test } : {},
-          ...optString(args, "tenant") ? { tenant: optString(args, "tenant") } : {}
+          ...optString(args, "tenant") ? { tenant: optString(args, "tenant") } : {},
+          ...stream ? { stream } : {}
         });
         return textResult(result);
       }
@@ -1007,6 +1020,11 @@ var MCP_TOOLS = [
           description: "Template variables when using template_id or template_alias",
           additionalProperties: true
         },
+        category: {
+          type: "string",
+          enum: ["transactional", "product", "newsletter"],
+          description: "transactional (default): sign-in codes, receipts, alerts. product: onboarding, lifecycle and notification email, with one-click unsubscribe. newsletter: opt-in newsletters, for approved accounts only (otherwise the send fails with newsletter_not_enabled), sent from separate IPs with one-click unsubscribe"
+        },
         tenant: tenantProp(
           "Send as this tenant: the send uses its domains, suppression list, pause switch and daily limit. Omit to send from the account as a whole"
         )
@@ -1030,7 +1048,12 @@ var MCP_TOOLS = [
       properties: {
         ...paginationProps,
         test: { type: "boolean", description: "true: only test emails; false: only live ones. Omit for both" },
-        tenant: tenantProp("Only emails sent as this tenant")
+        tenant: tenantProp("Only emails sent as this tenant"),
+        stream: {
+          type: "string",
+          enum: ["transactional", "product", "newsletter"],
+          description: "Only emails sent on this mail stream"
+        }
       }
     },
     outputSchema: pagedOutput("emails", emailItem, "Emails on this page, newest first"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "groundmail-mcp",
-  "version": "0.12.1",
+  "version": "0.13.0",
   "mcpName": "io.github.Groundmail/groundmail",
   "description": "Groundmail MCP server: send transactional email, manage domains, templates, webhooks and suppressions from Claude, Cursor, ChatGPT and other MCP clients",
   "license": "MIT",
@@ -41,7 +41,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "groundmail": "0.21.0"
+    "groundmail": "0.22.0"
   },
   "devDependencies": {
     "tsup": "^8.5.0",