groundmail-mcp 0.12.0 → 0.13.0

package/README.md

@@ -55,7 +55,7 @@ When you connect, you choose the access: **Full**, **Send only** or **Read only*
 >
 > "How is my deliverability over the last 7 days?"
 
-Tools cover emails (send, schedule, cancel, look up), domains (add, apply DNS, verify), templates, webhooks, suppressions, deliverability and tenants (one per customer you send for: create, update, pause, resume, stats; `tenant` on sends, domains and suppressions). Each tool carries read-only and destructive annotations and an output schema. Full list: [docs.groundmail.dev/ai/mcp](https://docs.groundmail.dev/ai/mcp).
+Tools cover emails (send, list, look up), domains (add, apply DNS through Cloudflare, Vercel or GoDaddy, verify), templates, webhooks, suppressions, address validation, deliverability, DMARC monitoring, imports from other providers and tenants (one per customer you send for: create, update, pause, resume, stats; `tenant` on sends, domains and suppressions). Each tool carries read-only and destructive annotations and an output schema. Full list: [docs.groundmail.dev/ai/mcp](https://docs.groundmail.dev/ai/mcp).
 
 ## Transports
 

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"),
@@ -1082,7 +1105,7 @@ var MCP_TOOLS = [
   },
   {
     name: "apply_domain_dns",
-    description: "Apply Groundmail DNS records for a domain. Cloudflare and GoDaddy can use credentials stored in the dashboard; GoDaddy also accepts one-time credentials on the request.",
+    description: "Apply Groundmail DNS records for a domain through Cloudflare, Vercel or GoDaddy. Uses the provider connected in the dashboard (Settings \u2192 Integrations), or one-time credentials passed on the request.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1094,7 +1117,7 @@ var MCP_TOOLS = [
         },
         credentials: {
           type: "object",
-          description: "Optional inline registrar credentials (GoDaddy api key/secret)"
+          description: "Optional one-time credentials: Cloudflare apiToken (and zoneId), Vercel apiToken (and teamId), or GoDaddy apiKey and apiSecret"
         }
       },
       required: ["domain", "provider"]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "groundmail-mcp",
-  "version": "0.12.0",
+  "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",