groundmail-mcp 0.26.0 → 0.27.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.
Files changed (2) hide show
  1. package/dist/index.js +44 -5
  2. package/package.json +2 -2
package/dist/index.js CHANGED
@@ -811,6 +811,7 @@ var burrowGuardSiteProperties = {
811
811
  block_free_webmail: boolean("Turns away personal addresses such as Gmail and Outlook"),
812
812
  allow_data_center_ips: boolean("Lets through visitors on hosting and cloud networks"),
813
813
  email_checks_only: boolean("No script or token: verify takes the email and runs the address checks only"),
814
+ watch_only: boolean("Every check runs and is recorded, and verify always answers success"),
814
815
  last_check_at: nullableString("When this site last had a check (ISO 8601)"),
815
816
  created_at: string("Created at (ISO 8601)")
816
817
  };
@@ -819,6 +820,7 @@ var burrowGuardSitesOutput = object(
819
820
  { data: arrayOf(object(burrowGuardSiteProperties, burrowGuardSiteRequired), "Every BurrowGuard site") },
820
821
  ["data"]
821
822
  );
823
+ var burrowGuardSiteOutput = object(burrowGuardSiteProperties, burrowGuardSiteRequired);
822
824
  var burrowGuardSiteCreatedOutput = object(
823
825
  {
824
826
  ...burrowGuardSiteProperties,
@@ -839,7 +841,8 @@ var burrowGuardChecksOutput = object(
839
841
  reason: nullableString("Why it did not pass"),
840
842
  reason_label: nullableString("The reason in words"),
841
843
  ip: nullableString("The visitor IP when the challenge was issued"),
842
- user_agent: nullableString("The visitor user agent when the challenge was issued")
844
+ user_agent: nullableString("The visitor user agent when the challenge was issued"),
845
+ watch_only: boolean("The site was on watch only: result is what would have happened, and nobody was turned away")
843
846
  },
844
847
  ["id", "site_id", "created_at", "result"]
845
848
  ),
@@ -852,6 +855,7 @@ var burrowGuardChecksOutput = object(
852
855
  checked: number("Checks in the range"),
853
856
  passed: number("Passed"),
854
857
  blocked: number("Blocked"),
858
+ would_block: number("Would have been blocked on a watch-only site. Not in blocked"),
855
859
  no_token: number("No token: the script did not run and the email checks passed"),
856
860
  top_reason: nullableString("The most common block reason")
857
861
  },
@@ -1135,10 +1139,17 @@ async function callMcpTool(client, name, args) {
1135
1139
  ...hostnames.length > 0 ? { allowed_hostnames: hostnames } : {},
1136
1140
  ...emailOnly ? { email_checks_only: true } : {},
1137
1141
  ...typeof args.block_free_webmail === "boolean" ? { block_free_webmail: args.block_free_webmail } : {},
1138
- ...typeof args.allow_data_center_ips === "boolean" ? { allow_data_center_ips: args.allow_data_center_ips } : {}
1142
+ ...typeof args.allow_data_center_ips === "boolean" ? { allow_data_center_ips: args.allow_data_center_ips } : {},
1143
+ ...typeof args.watch_only === "boolean" ? { watch_only: args.watch_only } : {}
1139
1144
  })
1140
1145
  );
1141
1146
  }
1147
+ case "update_burrowguard_site": {
1148
+ const siteId = optString(args, "id");
1149
+ if (!siteId) return textResult("Missing required argument: id", true);
1150
+ if (typeof args.watch_only !== "boolean") return textResult("Missing required argument: watch_only", true);
1151
+ return textResult(await client.burrowguard.sites.update(siteId, { watch_only: args.watch_only }));
1152
+ }
1142
1153
  case "list_burrowguard_checks": {
1143
1154
  const checkResult = optString(args, "result");
1144
1155
  return textResult(
@@ -1875,6 +1886,10 @@ var MCP_TOOLS = [
1875
1886
  email_checks_only: {
1876
1887
  type: "boolean",
1877
1888
  description: "For a form already behind a captcha: no script, tag or box, and verify takes just the email. allowed_hostnames can then be left out"
1889
+ },
1890
+ watch_only: {
1891
+ type: "boolean",
1892
+ description: "Run every check and show what would be blocked, without blocking anyone: verify always answers success. Good for the first week on a live form"
1878
1893
  }
1879
1894
  },
1880
1895
  required: ["name"]
@@ -1888,14 +1903,38 @@ var MCP_TOOLS = [
1888
1903
  openWorldHint: false
1889
1904
  }
1890
1905
  },
1906
+ {
1907
+ name: "update_burrowguard_site",
1908
+ description: "Turn watch only on or off for a BurrowGuard site. On, every check runs and shows what would be blocked, and nobody is turned away. Off, the site starts blocking.",
1909
+ inputSchema: {
1910
+ type: "object",
1911
+ properties: {
1912
+ id: { type: "string", description: "The site's id" },
1913
+ watch_only: { type: "boolean", description: "True to only watch, false to start blocking" }
1914
+ },
1915
+ required: ["id", "watch_only"]
1916
+ },
1917
+ outputSchema: burrowGuardSiteOutput,
1918
+ annotations: {
1919
+ title: "Update BurrowGuard site",
1920
+ readOnlyHint: false,
1921
+ destructiveHint: false,
1922
+ idempotentHint: true,
1923
+ openWorldHint: false
1924
+ }
1925
+ },
1891
1926
  {
1892
1927
  name: "list_burrowguard_checks",
1893
- description: "Recent BurrowGuard checks with totals and this month's usage: time, email domain, result and reason. The address itself is never stored.",
1928
+ description: "Recent BurrowGuard checks with totals and this month's usage: time, email domain, result and reason. With watch_only true, result is what would have happened and nobody was turned away. The address itself is never stored.",
1894
1929
  inputSchema: {
1895
1930
  type: "object",
1896
1931
  properties: {
1897
1932
  site: { type: "string", description: "Only this site (its id)" },
1898
- result: { type: "string", enum: ["passed", "blocked", "no_token"], description: "Only this result" }
1933
+ result: {
1934
+ type: "string",
1935
+ enum: ["passed", "blocked", "would_block", "no_token"],
1936
+ description: "Only this result. blocked is real blocks; would_block is the same on a watch-only site"
1937
+ }
1899
1938
  }
1900
1939
  },
1901
1940
  outputSchema: burrowGuardChecksOutput,
@@ -2445,7 +2484,7 @@ function resolveApiKey() {
2445
2484
  }
2446
2485
 
2447
2486
  // src/server.ts
2448
- var MCP_SERVER_VERSION = "0.25.0";
2487
+ var MCP_SERVER_VERSION = "0.27.0";
2449
2488
  var MCP_SERVER_INSTRUCTIONS = [
2450
2489
  "Groundmail sends transactional email from domains the user has verified.",
2451
2490
  '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.26.0",
3
+ "version": "0.27.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.41.0"
44
+ "groundmail": "0.42.0"
45
45
  },
46
46
  "devDependencies": {
47
47
  "tsup": "^8.5.0",