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.
- package/dist/index.js +45 -4
- 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("
|
|
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: "
|
|
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.
|
|
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.
|
|
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.
|
|
44
|
+
"groundmail": "0.57.0"
|
|
45
45
|
},
|
|
46
46
|
"devDependencies": {
|
|
47
47
|
"tsup": "^9.0.0",
|