groundmail-mcp 0.23.0 → 0.24.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.
package/README.md CHANGED
@@ -55,7 +55,7 @@ When you connect, you choose the access: **Full**, **Send only** or **Read only*
55
55
  >
56
56
  > "How is my deliverability over the last 7 days?"
57
57
 
58
- Tools cover emails (send, list, look up), received emails (with replies linked to the email you sent), domains (add, apply DNS through Cloudflare, Vercel, GoDaddy, Netlify, DigitalOcean or DNSimple, verify), senders (saved names and addresses to send as), your brand (logo, colors and footer every template follows), templates, webhooks, suppressions, address validation, deliverability, DMARC monitoring, email testing (a test address per run, then wait for the email and read its code and links), 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).
58
+ Tools cover emails (send, list, look up), batch sends (status counts, cancel the scheduled emails in one call), received emails (with replies linked to the email you sent), domains (add, apply DNS through Cloudflare, Vercel, GoDaddy, Netlify, DigitalOcean or DNSimple, verify), senders (saved names and addresses to send as), your brand (logo, colors and footer every template follows), templates, webhooks, suppressions, address validation, deliverability, DMARC monitoring, email testing (a test address per run, then wait for the email and read its code and links), 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).
59
59
 
60
60
  ## Transports
61
61
 
package/dist/index.js CHANGED
@@ -181,6 +181,7 @@ var emailItem = object(
181
181
  bounced_at: nullableString("When the email bounced (ISO 8601)"),
182
182
  opened_at: nullableString("First open (ISO 8601); needs open tracking on the sending domain"),
183
183
  clicked_at: nullableString("First tracked-link click (ISO 8601); needs click tracking on the sending domain"),
184
+ batch_id: nullableString("The batch send it came from (batch_\u2026), for get_batch and cancel_batch; null for a single send"),
184
185
  tenant: nullableString("External id of the tenant the email was sent as. Present only when it was sent as a tenant"),
185
186
  stream: string("Mail stream it went out on: transactional, product or newsletter (each sends from its own IPs)")
186
187
  },
@@ -366,6 +367,28 @@ var validateEmailOutput = object(
366
367
  ["email", "verdict", "reasons", "suggestion", "disposable", "role"]
367
368
  );
368
369
  var getEmailOutput = object({ email: described(emailItem, "The email") }, ["email"]);
370
+ var batchOutput = object(
371
+ {
372
+ batch_id: string("Batch id (batch_\u2026)"),
373
+ created_at: string("When the batch's first email was created (ISO 8601)"),
374
+ total: number("Emails in the batch"),
375
+ counts: {
376
+ type: "object",
377
+ additionalProperties: { type: "number" },
378
+ description: 'Emails by current status, for example { "scheduled": 98, "sent": 2 }. Only statuses with an email appear'
379
+ }
380
+ },
381
+ ["batch_id", "created_at", "total", "counts"]
382
+ );
383
+ var cancelBatchOutput = object(
384
+ {
385
+ batch_id: string("Batch id (batch_\u2026)"),
386
+ cancelled: number("Scheduled emails this call cancelled"),
387
+ already_cancelled: number("Emails that were already cancelled before this call"),
388
+ not_cancellable: number("Emails already queued, sent or finished, which can no longer be cancelled")
389
+ },
390
+ ["batch_id", "cancelled", "already_cancelled", "not_cancellable"]
391
+ );
369
392
  var domainWithRecordsOutput = object(
370
393
  {
371
394
  domain: described(domainItem, "The domain"),
@@ -875,6 +898,16 @@ async function callMcpTool(client, name, args) {
875
898
  if (!id) return textResult("Missing required argument: id", true);
876
899
  return textResult(await client.emails.get(id));
877
900
  }
901
+ case "get_batch": {
902
+ const id = optString(args, "batch_id");
903
+ if (!id) return textResult("Missing required argument: batch_id", true);
904
+ return textResult(await client.batches.get(id));
905
+ }
906
+ case "cancel_batch": {
907
+ const id = optString(args, "batch_id");
908
+ if (!id) return textResult("Missing required argument: batch_id", true);
909
+ return textResult(await client.batches.cancel(id));
910
+ }
878
911
  case "list_received_emails": {
879
912
  const inReplyToEmail = optString(args, "in_reply_to_email");
880
913
  return textResult(
@@ -1413,6 +1446,38 @@ var MCP_TOOLS = [
1413
1446
  outputSchema: getEmailOutput,
1414
1447
  annotations: readOnly("Get email")
1415
1448
  },
1449
+ {
1450
+ name: "get_batch",
1451
+ description: "Get a batch send (the batch_id a batch send returned, also on each of its emails as batch_id): how many emails it has and how many are in each status now.",
1452
+ inputSchema: {
1453
+ type: "object",
1454
+ properties: {
1455
+ batch_id: { type: "string", description: "Batch id (batch_\u2026)" }
1456
+ },
1457
+ required: ["batch_id"]
1458
+ },
1459
+ outputSchema: batchOutput,
1460
+ annotations: readOnly("Get batch")
1461
+ },
1462
+ {
1463
+ name: "cancel_batch",
1464
+ description: "Cancel every email in a batch send that is still scheduled. Emails already queued or sent are left alone and counted in not_cancellable. Safe to repeat: a second call cancels nothing more. Confirm with the user before cancelling.",
1465
+ inputSchema: {
1466
+ type: "object",
1467
+ properties: {
1468
+ batch_id: { type: "string", description: "Batch id (batch_\u2026)" }
1469
+ },
1470
+ required: ["batch_id"]
1471
+ },
1472
+ outputSchema: cancelBatchOutput,
1473
+ annotations: {
1474
+ title: "Cancel batch",
1475
+ readOnlyHint: false,
1476
+ destructiveHint: true,
1477
+ idempotentHint: true,
1478
+ openWorldHint: false
1479
+ }
1480
+ },
1416
1481
  {
1417
1482
  name: "list_received_emails",
1418
1483
  description: "List emails received on domains with inbound enabled, newest first (bodies left out). A reply to an email you sent through Groundmail has in_reply_to_email: the sent email it answers. Pass in_reply_to_email: msg_\u2026 to list the replies to one sent email.",
@@ -2123,7 +2188,7 @@ function resolveApiKey() {
2123
2188
  }
2124
2189
 
2125
2190
  // src/server.ts
2126
- var MCP_SERVER_VERSION = "0.23.0";
2191
+ var MCP_SERVER_VERSION = "0.24.0";
2127
2192
  var MCP_SERVER_INSTRUCTIONS = [
2128
2193
  "Groundmail sends transactional email from domains the user has verified.",
2129
2194
  '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.23.0",
3
+ "version": "0.24.0",
4
4
  "mcpName": "io.github.Groundmail/groundmail",
5
5
  "description": "Groundmail MCP server: send transactional email, 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.37.0"
44
+ "groundmail": "0.38.0"
45
45
  },
46
46
  "devDependencies": {
47
47
  "tsup": "^8.5.0",