groundmail-mcp 0.22.0 → 0.23.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 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), received emails (with replies linked to the email you sent), domains (add, apply DNS through Cloudflare, Vercel, GoDaddy, Netlify, DigitalOcean or DNSimple, verify), senders (saved names and addresses to send as), 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), senders (saved names and addresses to send as), your brand (logo, colors and footer every template follows), 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
@@ -582,6 +582,30 @@ var listSendersOutput = object(
582
582
  { data: arrayOf(senderItem, "Every sender, the default first") },
583
583
  ["data"]
584
584
  );
585
+ var brandOutput = object(
586
+ {
587
+ brand: described(
588
+ object(
589
+ {
590
+ is_set: boolean("False until anything is set"),
591
+ settings: described(object({}), "The look templates follow: any of a template design's settings (colors, fonts, button style, globalCss)"),
592
+ logo: described(
593
+ object({ url: string("https image URL"), width: { type: ["number", "null"], description: "Width in px" }, align: string("left or center") }, ["url", "align"]),
594
+ "The logo on top of every branded email, or null"
595
+ ),
596
+ accent_color: nullableString("The line across the top of every email"),
597
+ company_name: nullableString("Company name for the footer"),
598
+ address: nullableString("Mailing address for the footer"),
599
+ website: nullableString("Website, linked from the logo and the footer"),
600
+ updated_at: nullableString("When the brand was last changed (ISO 8601)")
601
+ },
602
+ ["is_set", "settings"]
603
+ ),
604
+ "The workspace brand"
605
+ )
606
+ },
607
+ ["brand"]
608
+ );
585
609
  var tenantOutput = object({ tenant: described(tenantItem, "The tenant") }, ["tenant"]);
586
610
  var streamCounts = (description) => ({
587
611
  ...object({
@@ -1027,6 +1051,21 @@ async function callMcpTool(client, name, args) {
1027
1051
  })
1028
1052
  );
1029
1053
  }
1054
+ case "get_brand": {
1055
+ return textResult(await client.brand.get());
1056
+ }
1057
+ case "update_brand": {
1058
+ const params = {};
1059
+ for (const key of ["accent_color", "company_name", "address", "website"]) {
1060
+ if (key in args) params[key] = args[key] === null ? null : optString(args, key);
1061
+ }
1062
+ if ("logo" in args) params.logo = args.logo ?? null;
1063
+ if (args.settings && typeof args.settings === "object" && !Array.isArray(args.settings)) params.settings = args.settings;
1064
+ if (!Object.keys(params).length) {
1065
+ return textResult("Nothing to update: pass settings, logo, accent_color, company_name, address or website", true);
1066
+ }
1067
+ return textResult(await client.brand.update(params));
1068
+ }
1030
1069
  case "list_senders": {
1031
1070
  return textResult(await client.senders.list());
1032
1071
  }
@@ -1711,6 +1750,47 @@ var MCP_TOOLS = [
1711
1750
  openWorldHint: false
1712
1751
  }
1713
1752
  },
1753
+ {
1754
+ name: "get_brand",
1755
+ description: "Get the workspace brand: the look every template follows unless it overrides a setting (settings: the same keys as a template design's settings), the logo on top, the accent line, and the company name, mailing address and website in the footer.",
1756
+ inputSchema: { type: "object", properties: {} },
1757
+ outputSchema: brandOutput,
1758
+ annotations: readOnly("Get brand")
1759
+ },
1760
+ {
1761
+ name: "update_brand",
1762
+ description: "Update the workspace brand. Fields left out keep their value; null clears one. settings replaces the brand's look (read it with get_brand first and change what you need). Templates that follow the brand pick it up from their next send.",
1763
+ inputSchema: {
1764
+ type: "object",
1765
+ properties: {
1766
+ settings: {
1767
+ type: "object",
1768
+ description: "The look, as a template design's settings: backgroundColor, contentBackgroundColor, textColor, linkColor, fontFamily, contentWidth, darkMode, globalCss, and theme { buttonBackground, buttonTextColor, buttonRadius, bodyFontSize, lineHeight, headingFontSize }"
1769
+ },
1770
+ logo: {
1771
+ type: ["object", "null"],
1772
+ description: "The logo: { url: https image URL, align: left | center, width?: px }. null removes it",
1773
+ properties: {
1774
+ url: { type: "string", description: "https image URL (PNG or JPEG show in every mail app)" },
1775
+ align: { type: "string", enum: ["left", "center"], description: "Where the logo sits" },
1776
+ width: { type: "number", description: "Width in px, 24 to 552. Default 120" }
1777
+ }
1778
+ },
1779
+ accent_color: { type: ["string", "null"], description: "Hex colour of the line across the top, for example #2f6feb" },
1780
+ company_name: { type: ["string", "null"], description: "Company name for the footer" },
1781
+ address: { type: ["string", "null"], description: "Mailing address for the footer (a PO box is fine)" },
1782
+ website: { type: ["string", "null"], description: "Website, for example acme.com" }
1783
+ }
1784
+ },
1785
+ outputSchema: brandOutput,
1786
+ annotations: {
1787
+ title: "Update brand",
1788
+ readOnlyHint: false,
1789
+ destructiveHint: false,
1790
+ idempotentHint: true,
1791
+ openWorldHint: false
1792
+ }
1793
+ },
1714
1794
  {
1715
1795
  name: "list_senders",
1716
1796
  description: "List saved senders: name, address, reply-to and handle, the default first, with how many automations and templates use each. Send as one with send_email sender instead of typing from.",
@@ -2043,7 +2123,7 @@ function resolveApiKey() {
2043
2123
  }
2044
2124
 
2045
2125
  // src/server.ts
2046
- var MCP_SERVER_VERSION = "0.22.0";
2126
+ var MCP_SERVER_VERSION = "0.23.0";
2047
2127
  var MCP_SERVER_INSTRUCTIONS = [
2048
2128
  "Groundmail sends transactional email from domains the user has verified.",
2049
2129
  '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.22.0",
3
+ "version": "0.23.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.2",
44
- "groundmail": "0.36.0"
44
+ "groundmail": "0.37.0"
45
45
  },
46
46
  "devDependencies": {
47
47
  "tsup": "^8.5.0",