supersendtx-mcp 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -0,0 +1,164 @@
+#!/usr/bin/env node
+
+// src/server.ts
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { SuperSendTX } from "supersendtx";
+
+// src/tools.ts
+function textResult(value, isError = false) {
+  return {
+    content: [{ type: "text", text: typeof value === "string" ? value : JSON.stringify(value, null, 2) }],
+    ...isError ? { isError: true } : {}
+  };
+}
+async function callMcpTool(client, name, args) {
+  try {
+    switch (name) {
+      case "send_email": {
+        const result = await client.emails.send({
+          from: String(args.from),
+          to: String(args.to),
+          subject: String(args.subject),
+          html: args.html != null ? String(args.html) : void 0,
+          text: args.text != null ? String(args.text) : void 0,
+          reply_to: args.reply_to != null ? String(args.reply_to) : void 0
+        });
+        return textResult(result);
+      }
+      case "apply_domain_dns": {
+        const domain = String(args.domain ?? "").trim();
+        if (!domain) {
+          return textResult("Missing required argument: domain", true);
+        }
+        const providerRaw = typeof args.provider === "string" ? args.provider.trim().toLowerCase() : "";
+        if (providerRaw !== "cloudflare" && providerRaw !== "godaddy") {
+          return textResult(
+            'Missing or invalid provider. Use provider "cloudflare" or "godaddy".',
+            true
+          );
+        }
+        const credentials = args.credentials && typeof args.credentials === "object" ? args.credentials : void 0;
+        const result = await client.domains.apply(domain, {
+          provider: providerRaw,
+          ...credentials ? { credentials } : {}
+        });
+        return textResult(result);
+      }
+      case "verify_domain": {
+        const result = await client.domains.verify(String(args.domain));
+        return textResult(result);
+      }
+      case "get_deliverability": {
+        const window = args.window === "7d" ? "7d" : "30d";
+        const result = await client.emails.insights(window);
+        return textResult(result);
+      }
+      default:
+        return textResult(`Unknown tool: ${name}`, true);
+    }
+  } catch (error) {
+    const message = error && typeof error === "object" && "message" in error ? String(error.message) : "Request failed";
+    return textResult(message, true);
+  }
+}
+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.",
+    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" },
+        html: { type: "string" },
+        text: { type: "string" },
+        reply_to: { type: "string" }
+      },
+      required: ["from", "to", "subject"]
+    }
+  },
+  {
+    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.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        domain: { type: "string" },
+        provider: { type: "string", enum: ["cloudflare", "godaddy"] },
+        credentials: {
+          type: "object",
+          description: "Optional inline registrar credentials (GoDaddy api key/secret)"
+        }
+      },
+      required: ["domain", "provider"]
+    }
+  },
+  {
+    name: "verify_domain",
+    description: "Verify DNS for a sending domain after records are applied.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        domain: { type: "string" }
+      },
+      required: ["domain"]
+    }
+  },
+  {
+    name: "get_deliverability",
+    description: "Fetch best-effort deliverability metrics for recent sends (7d or 30d window).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        window: { type: "string", enum: ["7d", "30d"] }
+      }
+    }
+  }
+];
+function resolveApiKey() {
+  const key = process.env.SUPERSENDTX_API_KEY?.trim();
+  if (!key) {
+    throw new Error("SUPERSENDTX_API_KEY is required");
+  }
+  if (!key.startsWith("stx_")) {
+    throw new Error("SUPERSENDTX_API_KEY must start with stx_");
+  }
+  return key;
+}
+
+// src/server.ts
+function createMcpServer(apiKey, baseUrl) {
+  const client = new SuperSendTX(apiKey, baseUrl ? { baseUrl } : {});
+  const server = new Server(
+    { name: "supersendtx-mcp", version: "0.1.0" },
+    { capabilities: { tools: {} } }
+  );
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: MCP_TOOLS.map((tool) => ({
+      name: tool.name,
+      description: tool.description,
+      inputSchema: tool.inputSchema
+    }))
+  }));
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const result = await callMcpTool(client, request.params.name, request.params.arguments ?? {});
+    return result;
+  });
+  return server;
+}
+async function runStdioServer() {
+  const apiKey = resolveApiKey();
+  const baseUrl = process.env.SUPERSENDTX_API_URL?.trim();
+  const server = createMcpServer(apiKey, baseUrl || void 0);
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+// src/index.ts
+runStdioServer().catch((error) => {
+  console.error(error instanceof Error ? error.message : error);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "supersendtx-mcp",
+  "version": "0.1.0",
+  "description": "SuperSend TX MCP server — send email and manage domains from Cursor or Claude",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "supersendtx-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Super-Send/superTX-app.git",
+    "directory": "packages/supersendtx-mcp"
+  },
+  "homepage": "https://docs.supersendtx.com/ai/mcp",
+  "keywords": [
+    "mcp",
+    "email",
+    "transactional",
+    "supersendtx",
+    "cursor",
+    "claude"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "supersendtx": "0.8.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5",
+    "vitest": "^3.2.4"
+  }
+}