groundmail-mcp 0.30.3 → 0.31.0

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 +39 -1
  2. package/package.json +2 -2
package/dist/index.js CHANGED
@@ -516,6 +516,18 @@ var validateEmailOutput = object(
516
516
  },
517
517
  ["email", "verdict", "reasons", "suggestion", "disposable", "role"]
518
518
  );
519
+ var verifyEmailOutput = object(
520
+ {
521
+ ...validateEmailOutput.properties,
522
+ mailbox: {
523
+ type: "string",
524
+ enum: ["exists", "not_found", "catch_all", "disposable", "unknown"],
525
+ description: "Whether the mailbox exists. catch_all: the domain accepts every address, so it cannot be confirmed"
526
+ },
527
+ billed: boolean("This answer is charged ($0.01). Catch-all, unknown and already-known answers are not")
528
+ },
529
+ ["email", "verdict", "reasons", "suggestion", "disposable", "role", "mailbox", "billed"]
530
+ );
519
531
  var getEmailOutput = object({ email: described(emailItem, "The email") }, ["email"]);
520
532
  var batchOutput = object(
521
533
  {
@@ -1470,6 +1482,12 @@ async function callMcpTool(client, name, args) {
1470
1482
  if (!email) return textResult("Missing required argument: email", true);
1471
1483
  return textResult(await client.validate(email));
1472
1484
  }
1485
+ case "verify_email": {
1486
+ const email = optString(args, "email");
1487
+ if (!email) return textResult("Missing required argument: email", true);
1488
+ const tenant = optString(args, "tenant");
1489
+ return textResult(await client.validate(email, { mailboxCheck: true, ...tenant ? { tenant } : {} }));
1490
+ }
1473
1491
  case "add_suppression": {
1474
1492
  const email = optString(args, "email");
1475
1493
  if (!email) return textResult("Missing required argument: email", true);
@@ -2443,6 +2461,26 @@ var MCP_TOOLS = [
2443
2461
  outputSchema: validateEmailOutput,
2444
2462
  annotations: { ...readOnly("Validate email address"), openWorldHint: true }
2445
2463
  },
2464
+ {
2465
+ name: "verify_email",
2466
+ 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.",
2467
+ inputSchema: {
2468
+ type: "object",
2469
+ properties: {
2470
+ email: { type: "string", description: "Email address to check" },
2471
+ tenant: tenantProp("Count the check toward this tenant")
2472
+ },
2473
+ required: ["email"]
2474
+ },
2475
+ outputSchema: verifyEmailOutput,
2476
+ annotations: {
2477
+ title: "Verify email address",
2478
+ readOnlyHint: false,
2479
+ destructiveHint: false,
2480
+ idempotentHint: false,
2481
+ openWorldHint: true
2482
+ }
2483
+ },
2446
2484
  {
2447
2485
  name: "add_suppression",
2448
2486
  description: "Add an address to the suppression list.",
@@ -3238,7 +3276,7 @@ function resolveApiKey() {
3238
3276
  }
3239
3277
 
3240
3278
  // src/server.ts
3241
- var MCP_SERVER_VERSION = "0.30.3";
3279
+ var MCP_SERVER_VERSION = "0.31.0";
3242
3280
  var MCP_SERVER_INSTRUCTIONS = [
3243
3281
  "Groundmail sends and receives email for apps and AI agents, from domains the user has verified.",
3244
3282
  '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.3",
3
+ "version": "0.31.0",
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.54.0"
44
+ "groundmail": "0.56.0"
45
45
  },
46
46
  "devDependencies": {
47
47
  "tsup": "^9.0.0",