groundmail-mcp 0.17.0 → 0.18.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 +27 -6
  2. package/package.json +2 -2
package/dist/index.js CHANGED
@@ -130,6 +130,23 @@ function heldBackItem() {
130
130
  ["email", "reason"]
131
131
  );
132
132
  }
133
+ var nullableBoolean = (description) => ({ type: ["boolean", "null"], description });
134
+ var emailDelivery = {
135
+ ...object(
136
+ {
137
+ receiving_server: nullableString("Hostname of the recipient's mail server, e.g. gmail-smtp-in.l.google.com"),
138
+ response: nullableString(
139
+ "Its exact SMTP reply to the latest attempt that finished: 250 \u2026 when it accepted the email, 5xx \u2026 when it refused it"
140
+ ),
141
+ tls: nullableBoolean("Whether the connection used TLS; null when the attempt did not say"),
142
+ deferred_response: nullableString("Its reply to the latest deferral (a 4xx such as greylisting; delivery is retried); null when none"),
143
+ deferred_at: nullableString("When the latest deferral happened (ISO 8601)")
144
+ },
145
+ ["receiving_server", "response", "tls", "deferred_response", "deferred_at"]
146
+ ),
147
+ type: ["object", "null"],
148
+ description: "What the recipient's mail server said about the latest delivery attempt. Null until an attempt reports one, and for test emails. delivered_at minus created_at is how long it took to land"
149
+ };
133
150
  var emailItem = object(
134
151
  {
135
152
  id: string("Email id (msg_\u2026)"),
@@ -147,6 +164,7 @@ var emailItem = object(
147
164
  enum: ["hard", "block", null],
148
165
  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"
149
166
  },
167
+ delivery: emailDelivery,
150
168
  held_back: arrayOf(
151
169
  heldBackItem(),
152
170
  "Recipients Groundmail validation held back before sending, with why; empty when none were"
@@ -193,7 +211,10 @@ var dnsRecordItem = object(
193
211
  host: string("Record host name"),
194
212
  value: string("Record value"),
195
213
  purpose: string("What the record is for, for example SPF or DKIM"),
196
- priority: number("MX preference, present on MX records")
214
+ priority: number("MX preference, present on MX records"),
215
+ already_set: boolean(
216
+ "True when the domain already publishes a record that does this job (its own DMARC record). The value is what is there now: nothing to add or change, never publish a second one"
217
+ )
197
218
  },
198
219
  ["type", "host", "value"]
199
220
  );
@@ -337,7 +358,7 @@ var verifyDomainOutput = object(
337
358
  checks: described(
338
359
  object({
339
360
  ownership: boolean("Ownership record found"),
340
- spf: boolean("SPF record found"),
361
+ spf: boolean("SPF in place. Always true for a main domain (example.com), which needs no SPF change"),
341
362
  dkim: boolean("DKIM record found"),
342
363
  dmarc: boolean("DMARC record found")
343
364
  }),
@@ -1236,7 +1257,7 @@ var MCP_TOOLS = [
1236
1257
  },
1237
1258
  {
1238
1259
  name: "get_email",
1239
- description: "Get a single email by public id (msg_\u2026).",
1260
+ description: "Get a single email by public id (msg_\u2026): its status, and in delivery the recipient's mail server, its exact reply (250 \u2026 when accepted, 5xx \u2026 when refused), TLS and the latest deferral. delivered_at minus created_at is how long it took to land.",
1240
1261
  inputSchema: {
1241
1262
  type: "object",
1242
1263
  properties: {
@@ -1276,11 +1297,11 @@ var MCP_TOOLS = [
1276
1297
  },
1277
1298
  {
1278
1299
  name: "create_domain",
1279
- description: "Add a sending domain. DNS must still be applied and verified before production sends.",
1300
+ description: "Add a sending domain. Suggest a subdomain of the company's domain (mail.example.com): the app's email then keeps its own reputation and the team's mailboxes and DNS stay as they are. DNS must still be applied and verified before production sends. Records with already_set are already in place: leave them alone.",
1280
1301
  inputSchema: {
1281
1302
  type: "object",
1282
1303
  properties: {
1283
- name: { type: "string", description: "Domain name (example.com)" },
1304
+ name: { type: "string", description: "Domain name, ideally a subdomain (mail.example.com)" },
1284
1305
  inbound_enabled: { type: "boolean", description: "Enable inbound receiving on this domain" },
1285
1306
  tenant: tenantProp("Give the domain to this tenant; only that tenant can then send from it")
1286
1307
  },
@@ -1881,7 +1902,7 @@ function resolveApiKey() {
1881
1902
  }
1882
1903
 
1883
1904
  // src/server.ts
1884
- var MCP_SERVER_VERSION = "0.17.0";
1905
+ var MCP_SERVER_VERSION = "0.18.0";
1885
1906
  var MCP_SERVER_INSTRUCTIONS = [
1886
1907
  "Groundmail sends transactional email from domains the user has verified.",
1887
1908
  '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.17.0",
3
+ "version": "0.18.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.1",
44
- "groundmail": "0.29.0"
44
+ "groundmail": "0.30.0"
45
45
  },
46
46
  "devDependencies": {
47
47
  "tsup": "^8.5.0",