groundmail-mcp 0.6.3 → 0.7.1

package/dist/index.js

@@ -118,6 +118,17 @@ function pagedOutput(key, item, description) {
     [key]
   );
 }
+function heldBackItem() {
+  return object(
+    {
+      email: string("The held-back address"),
+      reason: string(
+        "Why: invalid_address (cannot exist), no_mail_server (domain takes no email), previously_bounced (hard-bounced for a Groundmail sender in the last 90 days) or mailbox_not_found"
+      )
+    },
+    ["email", "reason"]
+  );
+}
 var emailItem = object(
   {
     id: string("Email id (msg_\u2026)"),
@@ -130,6 +141,15 @@ var emailItem = object(
     status: string("Current delivery status, for example sent, delivered or bounced"),
     last_event: nullableString("Most recent delivery event, if any"),
     bounce_reason: nullableString("Reason reported when the email bounced"),
+    bounce_type: {
+      type: ["string", "null"],
+      enum: ["hard", "block", null],
+      description: "Why it bounced: hard (address cannot receive; suppressed) or block (the receiving server refused the sender for reputation or policy; address not suppressed, safe to retry later). Null if it did not bounce"
+    },
+    held_back: arrayOf(
+      heldBackItem(),
+      "Recipients Groundmail validation held back before sending, with why; empty when none were"
+    ),
     tags: { description: "Tags attached to the email" },
     scheduled_at: nullableString("When the email is scheduled to send (ISO 8601)"),
     cancelled_at: nullableString("When the scheduled email was cancelled (ISO 8601)"),
@@ -243,10 +263,32 @@ var bucketProperties = {
 var sendEmailOutput = object(
   {
     id: string("Email id (msg_\u2026)"),
-    status: string("Status after the request, for example queued or scheduled")
+    status: string("Status after the request, for example queued or scheduled"),
+    held_back: arrayOf(
+      heldBackItem(),
+      "Present when Groundmail validation held some recipients back; the email went to the rest"
+    )
   },
   ["id", "status"]
 );
+var validateEmailOutput = object(
+  {
+    email: string("The address as checked (trimmed, lowercased)"),
+    domain: nullableString("Domain part of the address; null when there is none"),
+    verdict: {
+      type: "string",
+      enum: ["valid", "risky", "invalid"],
+      description: "valid: safe to send; risky: deliverable but worth a second look; invalid: cannot receive email"
+    },
+    reasons: stringArray(
+      "What was found: syntax, no_mail_server, mailbox_not_found, previously_bounced (invalid); disposable, catch_all, possible_typo (risky); role (informational)"
+    ),
+    suggestion: nullableString("The address with a likely-mistyped domain corrected, for example ada@gmail.com for ada@gmial.com"),
+    disposable: boolean("A throwaway-inbox service"),
+    role: boolean("A team or queue mailbox such as info@ or support@")
+  },
+  ["email", "verdict", "reasons", "suggestion", "disposable", "role"]
+);
 var getEmailOutput = object({ email: described(emailItem, "The email") }, ["email"]);
 var domainWithRecordsOutput = object(
   {
@@ -539,6 +581,11 @@ async function callMcpTool(client, name, args) {
           })
         );
       }
+      case "validate_email": {
+        const email = optString(args, "email");
+        if (!email) return textResult("Missing required argument: email", true);
+        return textResult(await client.validate(email));
+      }
       case "add_suppression": {
         const email = optString(args, "email");
         if (!email) return textResult("Missing required argument: email", true);
@@ -881,6 +928,19 @@ var MCP_TOOLS = [
     outputSchema: pagedOutput("data", suppressionItem, "Suppressed addresses on this page"),
     annotations: readOnly("List suppressions")
   },
+  {
+    name: "validate_email",
+    description: "Check one email address with Groundmail validation before accepting it (for example at signup): verdict valid | risky | invalid, reasons, a typo suggestion, and disposable / role flags. Free; sends nothing.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        email: { type: "string", description: "Email address to check" }
+      },
+      required: ["email"]
+    },
+    outputSchema: validateEmailOutput,
+    annotations: readOnly("Validate email address")
+  },
   {
     name: "add_suppression",
     description: "Add an address to the suppression list.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "groundmail-mcp",
-  "version": "0.6.3",
+  "version": "0.7.1",
   "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.14.7"
+    "groundmail": "0.15.1"
   },
   "devDependencies": {
     "tsup": "^8.5.0",