supersendtx-mcp 0.4.1 → 0.5.1

package/dist/index.js

@@ -133,16 +133,21 @@ async function callMcpTool(client, name, args) {
         const from = optString(args, "from");
         const to = optString(args, "to");
         const subject = optString(args, "subject");
+        const templateId = optString(args, "template_id") || optString(args, "template_alias");
         if (!from) return textResult("Missing required argument: from", true);
         if (!to) return textResult("Missing required argument: to", true);
-        if (!subject) return textResult("Missing required argument: subject", true);
+        if (!templateId && !subject) {
+          return textResult("Provide subject, or template_id / template_alias", true);
+        }
+        const variables = args.variables && typeof args.variables === "object" && !Array.isArray(args.variables) ? args.variables : void 0;
         const result = await client.emails.send({
           from,
           to,
-          subject,
+          ...subject ? { subject } : {},
           html: optString(args, "html"),
           text: optString(args, "text"),
-          reply_to: optString(args, "reply_to")
+          reply_to: optString(args, "reply_to"),
+          ...templateId ? { template: { id: templateId, ...variables ? { variables } : {} } } : {}
         });
         return textResult(result);
       }
@@ -164,9 +169,9 @@ async function callMcpTool(client, name, args) {
           return textResult("Missing required argument: domain", true);
         }
         const providerRaw = typeof args.provider === "string" ? args.provider.trim().toLowerCase() : "";
-        if (providerRaw !== "cloudflare" && providerRaw !== "godaddy") {
+        if (providerRaw !== "cloudflare" && providerRaw !== "godaddy" && providerRaw !== "vercel") {
           return textResult(
-            'Missing or invalid provider. Use provider "cloudflare" or "godaddy".',
+            'Missing or invalid provider. Use provider "cloudflare", "godaddy", or "vercel".',
             true
           );
         }
@@ -266,6 +271,28 @@ async function callMcpTool(client, name, args) {
         if (!idOrAlias) return textResult("Missing required argument: id or alias", true);
         return textResult(await client.templates.get(idOrAlias));
       }
+      case "create_template": {
+        const name2 = optString(args, "name");
+        const subjectArg = optString(args, "subject");
+        if (!name2) return textResult("Missing required argument: name", true);
+        if (!subjectArg) return textResult("Missing required argument: subject", true);
+        const format = optString(args, "format");
+        return textResult(
+          await client.templates.create({
+            name: name2,
+            subject: subjectArg,
+            ...format === "blocks" || format === "html" ? { format } : {},
+            html: optString(args, "html"),
+            text: optString(args, "text"),
+            alias: optString(args, "alias")
+          })
+        );
+      }
+      case "publish_template": {
+        const idOrAlias = optString(args, "id") ?? optString(args, "alias");
+        if (!idOrAlias) return textResult("Missing required argument: id or alias", true);
+        return textResult(await client.templates.publish(idOrAlias));
+      }
       case "send_test_webhook_event": {
         const event = optString(args, "event");
         if (!event || !EMAIL_WEBHOOK_EVENTS.has(event)) {
@@ -302,18 +329,25 @@ var paginationProps = {
 var MCP_TOOLS = [
   {
     name: "send_email",
-    description: "Send a transactional email via SuperSend TX. Sandbox sends must use the shared sandbox from address and only deliver to the account email until a domain is verified.",
+    description: "Send a transactional email via SuperSend TX. Provide subject + html/text, or a published template_id / template_alias with optional variables.",
     inputSchema: {
       type: "object",
       properties: {
         from: { type: "string", description: "Sender address (must match a verified domain or sandbox sender)" },
         to: { type: "string", description: "Recipient email address" },
-        subject: { type: "string" },
+        subject: { type: "string", description: "Optional when using a published template" },
         html: { type: "string" },
         text: { type: "string" },
-        reply_to: { type: "string" }
+        reply_to: { type: "string" },
+        template_id: { type: "string", description: "Published template UUID" },
+        template_alias: { type: "string", description: "Published template alias" },
+        variables: {
+          type: "object",
+          description: "Template variables when using template_id or template_alias",
+          additionalProperties: true
+        }
       },
-      required: ["from", "to", "subject"]
+      required: ["from", "to"]
     }
   },
   {
@@ -357,12 +391,12 @@ var MCP_TOOLS = [
   },
   {
     name: "apply_domain_dns",
-    description: "Apply SuperSend TX DNS records for a domain. Cloudflare can use a token stored in the dashboard; GoDaddy accepts one-time credentials on the request.",
+    description: "Apply SuperSend TX DNS records for a domain. Cloudflare and GoDaddy can use credentials stored in the dashboard; GoDaddy also accepts one-time credentials on the request.",
     inputSchema: {
       type: "object",
       properties: {
         domain: { type: "string" },
-        provider: { type: "string", enum: ["cloudflare", "godaddy"] },
+        provider: { type: "string", enum: ["cloudflare", "godaddy", "vercel"] },
         credentials: {
           type: "object",
           description: "Optional inline registrar credentials (GoDaddy api key/secret)"
@@ -473,6 +507,33 @@ var MCP_TOOLS = [
       }
     }
   },
+  {
+    name: "create_template",
+    description: "Create a draft email template (html or blocks format).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: { type: "string" },
+        subject: { type: "string" },
+        format: { type: "string", enum: ["html", "blocks"] },
+        html: { type: "string" },
+        text: { type: "string" },
+        alias: { type: "string" }
+      },
+      required: ["name", "subject"]
+    }
+  },
+  {
+    name: "publish_template",
+    description: "Publish a template, snapshotting an immutable version for sends.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "string" },
+        alias: { type: "string" }
+      }
+    }
+  },
   {
     name: "send_test_webhook_event",
     description: "Simulate a webhook event (POST /emails/test) for CI or local webhook testing. Optionally deliver to subscribed endpoints.",
@@ -561,14 +622,14 @@ function buildWwwAuthenticateChallenge(origin) {
 }
 
 // src/oauth-resolve.ts
-async function resolveOAuthAccessToken(accessToken, baseUrl) {
-  const apiBase = (baseUrl || process.env.SUPERSENDTX_API_URL || "https://api.supersendtx.com").replace(
-    /\/$/,
-    ""
-  );
+function getOAuthResolveUrl() {
+  const appBase = (process.env.SUPERSENDTX_APP_URL?.trim() || process.env.SUPERSENDTX_OAUTH_ISSUER?.trim() || "https://app.supersendtx.com").replace(/\/$/, "");
+  return `${appBase}/api/mcp/oauth/resolve`;
+}
+async function resolveOAuthAccessToken(accessToken) {
   const resolveSecret = process.env.SUPERSENDTX_MCP_RESOLVE_SECRET?.trim() || process.env.SUPERSENDTX_CREDENTIALS_ENCRYPTION_KEY?.trim() || (process.env.NODE_ENV === "production" ? "" : "supersendtx-dev-mcp-resolve");
   if (!resolveSecret) return null;
-  const response = await fetch(`${apiBase}/mcp/oauth/resolve`, {
+  const response = await fetch(getOAuthResolveUrl(), {
     method: "POST",
     headers: {
       authorization: `Bearer ${accessToken}`,
@@ -607,7 +668,7 @@ async function resolveApiKeyFromAuthorization(authorization, baseUrl) {
   const bearer = parseBearerToken(authorization);
   if (!bearer) return null;
   if (isSuperSendTxApiKey(bearer)) return bearer;
-  return resolveOAuthAccessToken(bearer, baseUrl);
+  return resolveOAuthAccessToken(bearer);
 }
 async function handleHttpRequest(req, res, options = {}) {
   const origin = getRequestOrigin(req);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "supersendtx-mcp",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "description": "SuperSend TX MCP server — stdio or local HTTP (--http) for Cursor and Claude",
   "license": "MIT",
   "type": "module",
@@ -40,7 +40,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "supersendtx": "0.8.2"
+    "supersendtx": "0.11.0"
   },
   "devDependencies": {
     "tsup": "^8.5.0",