groundmail-mcp 0.16.2 → 0.17.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/README.md +1 -1
- package/dist/index.js +73 -5
- package/package.json +2 -2
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), domains (add, apply DNS through Cloudflare, Vercel, GoDaddy, Netlify, DigitalOcean or DNSimple, verify), 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), received emails (with replies linked to the email you sent), domains (add, apply DNS through Cloudflare, Vercel, GoDaddy, Netlify, DigitalOcean or DNSimple, verify), 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
|
@@ -193,7 +193,10 @@ var dnsRecordItem = object(
|
|
|
193
193
|
host: string("Record host name"),
|
|
194
194
|
value: string("Record value"),
|
|
195
195
|
purpose: string("What the record is for, for example SPF or DKIM"),
|
|
196
|
-
priority: number("MX preference, present on MX records")
|
|
196
|
+
priority: number("MX preference, present on MX records"),
|
|
197
|
+
already_set: boolean(
|
|
198
|
+
"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"
|
|
199
|
+
)
|
|
197
200
|
},
|
|
198
201
|
["type", "host", "value"]
|
|
199
202
|
);
|
|
@@ -337,7 +340,7 @@ var verifyDomainOutput = object(
|
|
|
337
340
|
checks: described(
|
|
338
341
|
object({
|
|
339
342
|
ownership: boolean("Ownership record found"),
|
|
340
|
-
spf: boolean("SPF
|
|
343
|
+
spf: boolean("SPF in place. Always true for a main domain (example.com), which needs no SPF change"),
|
|
341
344
|
dkim: boolean("DKIM record found"),
|
|
342
345
|
dmarc: boolean("DMARC record found")
|
|
343
346
|
}),
|
|
@@ -612,6 +615,43 @@ var testEmailOutput = object(
|
|
|
612
615
|
},
|
|
613
616
|
["email"]
|
|
614
617
|
);
|
|
618
|
+
var inReplyToEmailItem = {
|
|
619
|
+
...object(
|
|
620
|
+
{
|
|
621
|
+
id: string("The sent email id (msg_\u2026)"),
|
|
622
|
+
subject: string("Its subject line"),
|
|
623
|
+
from: string("Its sender"),
|
|
624
|
+
to: stringArray("Its recipients"),
|
|
625
|
+
sent_at: string("When it was sent (ISO 8601)"),
|
|
626
|
+
tags: arrayOf(
|
|
627
|
+
object({ name: string("Tag name"), value: string("Tag value") }, ["name", "value"]),
|
|
628
|
+
"Its tags as sent"
|
|
629
|
+
),
|
|
630
|
+
tenant: nullableString("External id of the tenant it was sent as; null when it was not sent as a tenant")
|
|
631
|
+
},
|
|
632
|
+
["id"]
|
|
633
|
+
),
|
|
634
|
+
type: ["object", "null"],
|
|
635
|
+
description: "The email you sent through Groundmail that this one replies to, as it was when the reply arrived; null when it replies to none of your sent emails"
|
|
636
|
+
};
|
|
637
|
+
var receivedEmailItem = object(
|
|
638
|
+
{
|
|
639
|
+
id: string("Received email id (inb_\u2026)"),
|
|
640
|
+
domain_name: string("The receiving domain"),
|
|
641
|
+
rcpt_to: string("The address it was delivered to"),
|
|
642
|
+
from: string("Sender"),
|
|
643
|
+
to: stringArray("To addresses"),
|
|
644
|
+
cc: stringArray("Cc addresses"),
|
|
645
|
+
subject: string("Subject line"),
|
|
646
|
+
spam_status: nullableString("Content scanning verdict: clean, suspicious or spam; null when not scanned"),
|
|
647
|
+
message_id: nullableString("Its Message-ID header"),
|
|
648
|
+
in_reply_to: nullableString("Its In-Reply-To header"),
|
|
649
|
+
in_reply_to_email: inReplyToEmailItem,
|
|
650
|
+
attachment_count: number("Number of attachments"),
|
|
651
|
+
received_at: string("When it arrived (ISO 8601)")
|
|
652
|
+
},
|
|
653
|
+
["id", "from", "subject"]
|
|
654
|
+
);
|
|
615
655
|
|
|
616
656
|
// src/tools.ts
|
|
617
657
|
var DNS_PROVIDERS = ["cloudflare", "godaddy", "vercel", "netlify", "digitalocean", "dnsimple"];
|
|
@@ -741,6 +781,17 @@ async function callMcpTool(client, name, args) {
|
|
|
741
781
|
if (!id) return textResult("Missing required argument: id", true);
|
|
742
782
|
return textResult(await client.emails.get(id));
|
|
743
783
|
}
|
|
784
|
+
case "list_received_emails": {
|
|
785
|
+
const inReplyToEmail = optString(args, "in_reply_to_email");
|
|
786
|
+
return textResult(
|
|
787
|
+
await client.receivedEmails.list({
|
|
788
|
+
limit: optNumber(args, "limit"),
|
|
789
|
+
cursor: optString(args, "cursor"),
|
|
790
|
+
domain: optString(args, "domain"),
|
|
791
|
+
...inReplyToEmail ? { inReplyToEmail } : {}
|
|
792
|
+
})
|
|
793
|
+
);
|
|
794
|
+
}
|
|
744
795
|
case "apply_domain_dns": {
|
|
745
796
|
const domain = String(args.domain ?? "").trim();
|
|
746
797
|
if (!domain) {
|
|
@@ -1199,6 +1250,23 @@ var MCP_TOOLS = [
|
|
|
1199
1250
|
outputSchema: getEmailOutput,
|
|
1200
1251
|
annotations: readOnly("Get email")
|
|
1201
1252
|
},
|
|
1253
|
+
{
|
|
1254
|
+
name: "list_received_emails",
|
|
1255
|
+
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.",
|
|
1256
|
+
inputSchema: {
|
|
1257
|
+
type: "object",
|
|
1258
|
+
properties: {
|
|
1259
|
+
...paginationProps,
|
|
1260
|
+
domain: { type: "string", description: "Only messages received on this domain" },
|
|
1261
|
+
in_reply_to_email: {
|
|
1262
|
+
type: "string",
|
|
1263
|
+
description: "Only replies to this sent email (msg_\u2026)"
|
|
1264
|
+
}
|
|
1265
|
+
}
|
|
1266
|
+
},
|
|
1267
|
+
outputSchema: pagedOutput("received_emails", receivedEmailItem, "Received emails on this page, newest first"),
|
|
1268
|
+
annotations: readOnly("List received emails")
|
|
1269
|
+
},
|
|
1202
1270
|
{
|
|
1203
1271
|
name: "list_domains",
|
|
1204
1272
|
description: "List sending domains for this account.",
|
|
@@ -1211,11 +1279,11 @@ var MCP_TOOLS = [
|
|
|
1211
1279
|
},
|
|
1212
1280
|
{
|
|
1213
1281
|
name: "create_domain",
|
|
1214
|
-
description: "Add a sending domain. DNS must still be applied and verified before production sends.",
|
|
1282
|
+
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.",
|
|
1215
1283
|
inputSchema: {
|
|
1216
1284
|
type: "object",
|
|
1217
1285
|
properties: {
|
|
1218
|
-
name: { type: "string", description: "Domain name (example.com)" },
|
|
1286
|
+
name: { type: "string", description: "Domain name, ideally a subdomain (mail.example.com)" },
|
|
1219
1287
|
inbound_enabled: { type: "boolean", description: "Enable inbound receiving on this domain" },
|
|
1220
1288
|
tenant: tenantProp("Give the domain to this tenant; only that tenant can then send from it")
|
|
1221
1289
|
},
|
|
@@ -1816,7 +1884,7 @@ function resolveApiKey() {
|
|
|
1816
1884
|
}
|
|
1817
1885
|
|
|
1818
1886
|
// src/server.ts
|
|
1819
|
-
var MCP_SERVER_VERSION = "0.
|
|
1887
|
+
var MCP_SERVER_VERSION = "0.17.1";
|
|
1820
1888
|
var MCP_SERVER_INSTRUCTIONS = [
|
|
1821
1889
|
"Groundmail sends transactional email from domains the user has verified.",
|
|
1822
1890
|
'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.17.1",
|
|
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.29.1"
|
|
45
45
|
},
|
|
46
46
|
"devDependencies": {
|
|
47
47
|
"tsup": "^8.5.0",
|