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.
- package/dist/index.js +27 -6
- 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
|
|
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.
|
|
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.
|
|
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.
|
|
44
|
+
"groundmail": "0.30.0"
|
|
45
45
|
},
|
|
46
46
|
"devDependencies": {
|
|
47
47
|
"tsup": "^8.5.0",
|