groundmail-mcp 0.13.0 → 0.14.0

package/dist/index.js

@@ -221,6 +221,25 @@ var suppressionItem = object(
   },
   ["id", "email"]
 );
+var categoryOptOutItem = object(
+  {
+    id: string("Category opt-out id"),
+    type: string("Always category_opt_out"),
+    email: string("Address that opted out"),
+    category: string("Category the address opted out of: product or newsletter"),
+    tenant: nullableString("External id of the tenant whose email the reader left; null when account-wide"),
+    created_at: string("When the reader opted out (ISO 8601)"),
+    updated_at: string("When the opt-out was last changed (ISO 8601)")
+  },
+  ["id", "email", "category"]
+);
+var removeCategoryOptOutOutput = object(
+  {
+    ok: boolean("True when the request completed"),
+    deleted: number("How many opt-outs were removed")
+  },
+  ["ok"]
+);
 var templateItem = object(
   {
     id: string("Template id (tpl_\u2026)"),
@@ -773,6 +792,39 @@ async function callMcpTool(client, name, args) {
         const tenant = optString(args, "tenant");
         return textResult(tenant ? await client.suppressions.remove(idOrEmail, { tenant }) : await client.suppressions.remove(idOrEmail));
       }
+      case "list_category_opt_outs": {
+        const category = optString(args, "category");
+        if (category && category !== "product" && category !== "newsletter") {
+          return textResult("category must be product or newsletter", true);
+        }
+        return textResult(
+          await client.suppressions.listCategoryOptOuts({
+            limit: optNumber(args, "limit"),
+            cursor: optString(args, "cursor"),
+            email: optString(args, "email"),
+            ...category ? { category } : {},
+            ...optString(args, "tenant") ? { tenant: optString(args, "tenant") } : {},
+            ...args.include_tenants === true ? { includeTenants: true } : {}
+          })
+        );
+      }
+      case "remove_category_opt_out": {
+        const idOrEmail = optString(args, "id") ?? optString(args, "email");
+        if (!idOrEmail) {
+          return textResult("Missing required argument: id or email", true);
+        }
+        const category = optString(args, "category");
+        if (category && category !== "product" && category !== "newsletter") {
+          return textResult("category must be product or newsletter", true);
+        }
+        const tenant = optString(args, "tenant");
+        return textResult(
+          await client.suppressions.removeCategoryOptOut(idOrEmail, {
+            ...category ? { category } : {},
+            ...tenant ? { tenant } : {}
+          })
+        );
+      }
       case "list_templates": {
         const status = optString(args, "status");
         return textResult(
@@ -1280,6 +1332,50 @@ var MCP_TOOLS = [
       openWorldHint: false
     }
   },
+  {
+    name: "list_category_opt_outs",
+    description: "List category opt-outs: addresses that used a one-click unsubscribe to leave product or newsletter email. Sends in that category to them are refused until the opt-out is removed.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...paginationProps,
+        email: { type: "string", description: "Optional filter by email" },
+        category: { type: "string", enum: ["product", "newsletter"], description: "Optional filter by category" },
+        tenant: tenantProp("List this tenant's opt-outs instead of the account-wide ones"),
+        include_tenants: {
+          type: "boolean",
+          description: "Without tenant: also list every tenant's opt-outs (each entry names its tenant)"
+        }
+      }
+    },
+    outputSchema: pagedOutput("data", categoryOptOutItem, "Category opt-outs on this page"),
+    annotations: readOnly("List category opt-outs")
+  },
+  {
+    name: "remove_category_opt_out",
+    description: "Remove a category opt-out by id or email address so the address receives that category again. Use only when the reader has asked to re-subscribe.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "string", description: "Category opt-out id" },
+        email: { type: "string", description: "Email address (alternative to id)" },
+        category: {
+          type: "string",
+          enum: ["product", "newsletter"],
+          description: "Only this category; omit to remove every category for the address"
+        },
+        tenant: tenantProp("Remove from this tenant's opt-outs instead of the account-wide ones")
+      }
+    },
+    outputSchema: removeCategoryOptOutOutput,
+    annotations: {
+      title: "Remove category opt-out",
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: true,
+      openWorldHint: false
+    }
+  },
   {
     name: "list_templates",
     description: "List email templates.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "groundmail-mcp",
-  "version": "0.13.0",
+  "version": "0.14.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.22.0"
+    "groundmail": "0.24.0"
   },
   "devDependencies": {
     "tsup": "^8.5.0",