groundmail-mcp 0.30.4 → 0.31.1

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 (2) hide show
  1. package/dist/index.js +45 -4
  2. package/package.json +2 -2
package/dist/index.js CHANGED
@@ -306,7 +306,10 @@ var emailItem = object(
306
306
  clicked_at: nullableString("First tracked-link click (ISO 8601); needs click tracking on the sending domain"),
307
307
  batch_id: nullableString("The batch send it came from (batch_\u2026), for get_batch and cancel_batch; null for a single send"),
308
308
  tenant: nullableString("External id of the tenant the email was sent as. Present only when it was sent as a tenant"),
309
- stream: string("Mail stream it went out on: transactional, product or newsletter (each sends from its own IPs)")
309
+ stream: string("Mail stream it went out on: transactional, product or newsletter (each sends from its own IPs)"),
310
+ detected_category: nullableString(
311
+ "What Groundmail decided the email is: transactional or product. Null while it is being checked, when its template was not settled yet, and for mail Groundmail does not check (newsletter, tests)"
312
+ )
310
313
  },
311
314
  ["id", "from", "to", "subject", "status"]
312
315
  );
@@ -454,7 +457,7 @@ var templateItem = object(
454
457
  description: "Variable names the template uses"
455
458
  },
456
459
  unsubscribe_enabled: boolean("Whether managed unsubscribe is on for sends using this template"),
457
- category: string("transactional or product"),
460
+ category: string("Deprecated and ignored: Groundmail decides the category from the published content"),
458
461
  folder: nullableString("Folder the template is filed in, or null"),
459
462
  sender_id: nullableString("Sender the template goes out as when a send sets neither from nor sender; null uses the default sender"),
460
463
  published_version_id: nullableString("Id of the version sends currently use"),
@@ -516,6 +519,18 @@ var validateEmailOutput = object(
516
519
  },
517
520
  ["email", "verdict", "reasons", "suggestion", "disposable", "role"]
518
521
  );
522
+ var verifyEmailOutput = object(
523
+ {
524
+ ...validateEmailOutput.properties,
525
+ mailbox: {
526
+ type: "string",
527
+ enum: ["exists", "not_found", "catch_all", "disposable", "unknown"],
528
+ description: "Whether the mailbox exists. catch_all: the domain accepts every address, so it cannot be confirmed"
529
+ },
530
+ billed: boolean("This answer is charged ($0.01). Catch-all, unknown and already-known answers are not")
531
+ },
532
+ ["email", "verdict", "reasons", "suggestion", "disposable", "role", "mailbox", "billed"]
533
+ );
519
534
  var getEmailOutput = object({ email: described(emailItem, "The email") }, ["email"]);
520
535
  var batchOutput = object(
521
536
  {
@@ -1470,6 +1485,12 @@ async function callMcpTool(client, name, args) {
1470
1485
  if (!email) return textResult("Missing required argument: email", true);
1471
1486
  return textResult(await client.validate(email));
1472
1487
  }
1488
+ case "verify_email": {
1489
+ const email = optString(args, "email");
1490
+ if (!email) return textResult("Missing required argument: email", true);
1491
+ const tenant = optString(args, "tenant");
1492
+ return textResult(await client.validate(email, { mailboxCheck: true, ...tenant ? { tenant } : {} }));
1493
+ }
1473
1494
  case "add_suppression": {
1474
1495
  const email = optString(args, "email");
1475
1496
  if (!email) return textResult("Missing required argument: email", true);
@@ -2048,7 +2069,7 @@ var MCP_TOOLS = [
2048
2069
  category: {
2049
2070
  type: "string",
2050
2071
  enum: ["transactional", "product", "newsletter"],
2051
- 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"
2072
+ description: "Usually omit it: Groundmail decides whether each email is transactional or product, and ignores those two values here (see detected_category on the email). Set newsletter only for opt-in newsletters on an account approved for them (otherwise the send fails with newsletter_not_enabled); they go from separate IPs with one-click unsubscribe"
2052
2073
  },
2053
2074
  tenant: tenantProp(
2054
2075
  "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"
@@ -2443,6 +2464,26 @@ var MCP_TOOLS = [
2443
2464
  outputSchema: validateEmailOutput,
2444
2465
  annotations: { ...readOnly("Validate email address"), openWorldHint: true }
2445
2466
  },
2467
+ {
2468
+ name: "verify_email",
2469
+ description: "Confirm that one email address has a mailbox that exists. Returns mailbox: exists | not_found | catch_all | disposable | unknown and billed, plus the free validation result (verdict, reasons, typo suggestion, disposable and role flags). Costs $0.01 when billed is true; catch_all, unknown and answers Groundmail already knows are free. Needs a paid Groundmail plan. Sends nothing to the address.",
2470
+ inputSchema: {
2471
+ type: "object",
2472
+ properties: {
2473
+ email: { type: "string", description: "Email address to check" },
2474
+ tenant: tenantProp("Count the check toward this tenant")
2475
+ },
2476
+ required: ["email"]
2477
+ },
2478
+ outputSchema: verifyEmailOutput,
2479
+ annotations: {
2480
+ title: "Verify email address",
2481
+ readOnlyHint: false,
2482
+ destructiveHint: false,
2483
+ idempotentHint: false,
2484
+ openWorldHint: true
2485
+ }
2486
+ },
2446
2487
  {
2447
2488
  name: "add_suppression",
2448
2489
  description: "Add an address to the suppression list.",
@@ -3238,7 +3279,7 @@ function resolveApiKey() {
3238
3279
  }
3239
3280
 
3240
3281
  // src/server.ts
3241
- var MCP_SERVER_VERSION = "0.30.4";
3282
+ var MCP_SERVER_VERSION = "0.31.1";
3242
3283
  var MCP_SERVER_INSTRUCTIONS = [
3243
3284
  "Groundmail sends and receives email for apps and AI agents, from domains the user has verified.",
3244
3285
  'To test before a domain is verified, call send_email with from "noreply@mail.groundmail.dev" and to set to the Groundmail account email; sandbox sends to any other address are rejected.',
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "groundmail-mcp",
3
- "version": "0.30.4",
3
+ "version": "0.31.1",
4
4
  "mcpName": "io.github.Groundmail/groundmail",
5
5
  "description": "Groundmail MCP server: send and receive email, give agents mailboxes, manage domains, templates, webhooks and suppressions from Claude, Cursor, ChatGPT and other MCP clients",
6
6
  "license": "MIT",
@@ -41,7 +41,7 @@
41
41
  },
42
42
  "dependencies": {
43
43
  "@modelcontextprotocol/sdk": "^1.32.2",
44
- "groundmail": "0.55.0"
44
+ "groundmail": "0.57.0"
45
45
  },
46
46
  "devDependencies": {
47
47
  "tsup": "^9.0.0",