groundmail-mcp 0.15.0 → 0.16.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 +3 -3
- package/dist/index.js +10 -12
- 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 or
|
|
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).
|
|
59
59
|
|
|
60
60
|
## Transports
|
|
61
61
|
|
|
@@ -135,7 +135,7 @@ Want your coding agent to know Groundmail too? Install the [agent skills](https:
|
|
|
135
135
|
|
|
136
136
|
- **Our own mail servers and IP space.** Your password resets and receipts don't share a pool with bulk marketing senders.
|
|
137
137
|
- **Transactional email only.** No newsletters or cold outreach on the platform, which keeps the sending reputation clean.
|
|
138
|
-
- **Start free.** 3,000 emails a month
|
|
138
|
+
- **Start free.** Free covers 3,000 emails a month. After that it's pay as you go: $0.70 per 1,000, less as you grow. [Pricing](https://groundmail.dev/pricing/)
|
|
139
139
|
- **Built for code and for agents.** REST API, SMTP, SDKs for Node, Python, Go, PHP and Ruby, a CLI, and an MCP server for Claude, ChatGPT and Cursor.
|
|
140
140
|
|
|
141
141
|
## All Groundmail libraries
|
|
@@ -158,4 +158,4 @@ Want your coding agent to know Groundmail too? Install the [agent skills](https:
|
|
|
158
158
|
| Agent skills and Claude Code plugin | [Groundmail/groundmail-skills](https://github.com/Groundmail/groundmail-skills) |
|
|
159
159
|
| Email templates (React Email, MJML, HTML) | [Groundmail/email-templates](https://github.com/Groundmail/email-templates) |
|
|
160
160
|
|
|
161
|
-
[Website](https://groundmail.dev) · [Docs](https://docs.groundmail.dev) · [Pricing](https://groundmail.dev/pricing) · [Sign up free](https://app.groundmail.dev/signup)
|
|
161
|
+
[Website](https://groundmail.dev) · [Docs](https://docs.groundmail.dev) · [Pricing](https://groundmail.dev/pricing/) · [Sign up free](https://app.groundmail.dev/signup)
|
package/dist/index.js
CHANGED
|
@@ -613,6 +613,7 @@ var testEmailOutput = object(
|
|
|
613
613
|
);
|
|
614
614
|
|
|
615
615
|
// src/tools.ts
|
|
616
|
+
var DNS_PROVIDERS = ["cloudflare", "godaddy", "vercel", "netlify", "digitalocean", "dnsimple"];
|
|
616
617
|
function textResult(value, isError = false) {
|
|
617
618
|
const isObject = value !== null && typeof value === "object" && !Array.isArray(value);
|
|
618
619
|
return {
|
|
@@ -745,11 +746,8 @@ async function callMcpTool(client, name, args) {
|
|
|
745
746
|
return textResult("Missing required argument: domain", true);
|
|
746
747
|
}
|
|
747
748
|
const providerRaw = typeof args.provider === "string" ? args.provider.trim().toLowerCase() : "";
|
|
748
|
-
if (providerRaw
|
|
749
|
-
return textResult(
|
|
750
|
-
'Missing or invalid provider. Use provider "cloudflare", "godaddy", or "vercel".',
|
|
751
|
-
true
|
|
752
|
-
);
|
|
749
|
+
if (!DNS_PROVIDERS.includes(providerRaw)) {
|
|
750
|
+
return textResult(`Missing or invalid provider. Use one of: ${DNS_PROVIDERS.join(", ")}.`, true);
|
|
753
751
|
}
|
|
754
752
|
const result = await client.domains.apply(domain, { provider: providerRaw });
|
|
755
753
|
return textResult(result);
|
|
@@ -991,8 +989,8 @@ async function callMcpTool(client, name, args) {
|
|
|
991
989
|
const domain = optString(args, "domain");
|
|
992
990
|
if (!domain) return textResult("Missing required argument: domain", true);
|
|
993
991
|
const apply = optString(args, "apply");
|
|
994
|
-
if (apply && apply
|
|
995
|
-
return textResult(
|
|
992
|
+
if (apply && !DNS_PROVIDERS.includes(apply)) {
|
|
993
|
+
return textResult(`apply must be one of: ${DNS_PROVIDERS.join(", ")}`, true);
|
|
996
994
|
}
|
|
997
995
|
return textResult(await client.dmarc.enable(domain, apply ? { apply } : {}));
|
|
998
996
|
}
|
|
@@ -1233,14 +1231,14 @@ var MCP_TOOLS = [
|
|
|
1233
1231
|
},
|
|
1234
1232
|
{
|
|
1235
1233
|
name: "apply_domain_dns",
|
|
1236
|
-
description: "Apply Groundmail DNS records for a domain through Cloudflare, Vercel or
|
|
1234
|
+
description: "Apply Groundmail DNS records for a domain through Cloudflare, Vercel, GoDaddy, Netlify, DigitalOcean or DNSimple, using the provider account connected in the dashboard. If none is connected, ask the user to connect it at https://app.groundmail.dev/integrations (never ask for the provider token in chat), or have them publish the records from create_domain by hand.",
|
|
1237
1235
|
inputSchema: {
|
|
1238
1236
|
type: "object",
|
|
1239
1237
|
properties: {
|
|
1240
1238
|
domain: { type: "string", description: "Domain name or id of a domain already added to this account (example.com)" },
|
|
1241
1239
|
provider: {
|
|
1242
1240
|
type: "string",
|
|
1243
|
-
enum: [
|
|
1241
|
+
enum: [...DNS_PROVIDERS],
|
|
1244
1242
|
description: "DNS provider that hosts the domain"
|
|
1245
1243
|
}
|
|
1246
1244
|
},
|
|
@@ -1550,7 +1548,7 @@ var MCP_TOOLS = [
|
|
|
1550
1548
|
},
|
|
1551
1549
|
{
|
|
1552
1550
|
name: "list_tenants",
|
|
1553
|
-
description: "List tenants: one per customer you send email for, each with its own domains, suppression list, stats, pause switch and daily limit. Tenants are included on
|
|
1551
|
+
description: "List tenants: one per customer you send email for, each with its own domains, suppression list, stats, pause switch and daily limit. Tenants are included on pay as you go and the Dedicated plan.",
|
|
1554
1552
|
inputSchema: {
|
|
1555
1553
|
type: "object",
|
|
1556
1554
|
properties: {
|
|
@@ -1685,7 +1683,7 @@ var MCP_TOOLS = [
|
|
|
1685
1683
|
domain: { type: "string", description: "Domain name or id (example.com)" },
|
|
1686
1684
|
apply: {
|
|
1687
1685
|
type: "string",
|
|
1688
|
-
enum: [
|
|
1686
|
+
enum: [...DNS_PROVIDERS],
|
|
1689
1687
|
description: "Also write the DMARC record through this DNS provider (connected under Integrations)"
|
|
1690
1688
|
}
|
|
1691
1689
|
},
|
|
@@ -1817,7 +1815,7 @@ function resolveApiKey() {
|
|
|
1817
1815
|
}
|
|
1818
1816
|
|
|
1819
1817
|
// src/server.ts
|
|
1820
|
-
var MCP_SERVER_VERSION = "0.15.
|
|
1818
|
+
var MCP_SERVER_VERSION = "0.15.1";
|
|
1821
1819
|
var MCP_SERVER_INSTRUCTIONS = [
|
|
1822
1820
|
"Groundmail sends transactional email from domains the user has verified.",
|
|
1823
1821
|
'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.16.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.27.0"
|
|
45
45
|
},
|
|
46
46
|
"devDependencies": {
|
|
47
47
|
"tsup": "^8.5.0",
|