groundmail-mcp 0.5.6 → 0.5.8

package/dist/index.js

@@ -324,21 +324,28 @@ async function callMcpTool(client, name, args) {
 function formatToolError(error) {
   if (!error || typeof error !== "object") return "Request failed";
   const err = error;
-  const lines = [typeof err.message === "string" && err.message ? err.message : "Request failed"];
+  const text = (value) => typeof value === "string" && value.trim() ? value.trim() : null;
+  const lines = [text(err.message) ?? "Request failed"];
   const code = typeof err.code === "string" && /^[a-z_]+$/.test(err.code) ? err.code : null;
   if (code) {
     const status = typeof err.status === "number" ? ` (HTTP ${err.status})` : "";
     lines.push(`code: ${code}${status}`);
   }
+  const requiredScope = text(err.requiredScope);
+  if (requiredScope) lines.push(`required scope: ${requiredScope}`);
   if (err.details !== void 0 && err.details !== null) {
     lines.push(`details: ${JSON.stringify(err.details)}`);
   }
-  if (typeof err.upgradeUrl === "string" && err.upgradeUrl) {
-    lines.push(`upgrade: https://app.groundmail.dev${err.upgradeUrl.startsWith("/") ? "" : "/"}${err.upgradeUrl}`);
-  }
-  if (code) {
-    lines.push(`how to fix: https://docs.groundmail.dev/errors#${code}`);
+  const upgradeUrl = text(err.upgradeUrl);
+  if (upgradeUrl) {
+    lines.push(
+      `upgrade: ${/^https?:\/\//.test(upgradeUrl) ? upgradeUrl : `https://app.groundmail.dev${upgradeUrl.startsWith("/") ? "" : "/"}${upgradeUrl}`}`
+    );
   }
+  const hint = text(err.hint);
+  if (hint) lines.push(`hint: ${hint}`);
+  const docsUrl = text(err.docsUrl) ?? (code ? `https://docs.groundmail.dev/errors#${code}` : null);
+  if (docsUrl) lines.push(`how to fix: ${docsUrl}`);
   return lines.join("\n");
 }
 var paginationProps = {
@@ -596,7 +603,7 @@ function resolveApiKey() {
 }
 
 // src/server.ts
-var MCP_SERVER_VERSION = "0.5.6";
+var MCP_SERVER_VERSION = "0.5.8";
 var MCP_SERVER_INSTRUCTIONS = [
   "Groundmail sends transactional email from domains the user has verified.",
   '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.',
@@ -639,6 +646,17 @@ var PROTECTED_RESOURCE_METADATA_PATHS = /* @__PURE__ */ new Set([
   `${PROTECTED_RESOURCE_METADATA_PATH}${MCP_HTTP_PATH}`
 ]);
 var DOCS_URL = "https://docs.groundmail.dev/ai/mcp";
+var MCP_SCOPES_SUPPORTED = [
+  "full",
+  "emails:send",
+  "emails:read",
+  "domains:read",
+  "domains:write",
+  "webhooks:write",
+  "templates:write",
+  "suppressions:write",
+  "account:read"
+];
 function trimOrigin(origin) {
   return origin.replace(/\/$/, "");
 }
@@ -650,7 +668,7 @@ function buildProtectedResourceMetadata(origin) {
     resource_name: "Groundmail",
     resource_documentation: DOCS_URL,
     authorization_servers: [appOrigin.replace(/\/$/, "")],
-    scopes_supported: ["full"],
+    scopes_supported: [...MCP_SCOPES_SUPPORTED],
     bearer_methods_supported: ["header"]
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "groundmail-mcp",
-  "version": "0.5.6",
+  "version": "0.5.8",
   "mcpName": "io.github.Groundmail/groundmail",
   "description": "Groundmail MCP server: send transactional email, manage domains, templates, webhooks and suppressions from Claude, Cursor, ChatGPT and other MCP clients",
   "license": "MIT",
@@ -40,7 +40,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "groundmail": "0.14.1"
+    "groundmail": "0.14.3"
   },
   "devDependencies": {
     "tsup": "^8.5.0",