supersendtx-mcp 0.5.5 → 0.5.9

package/README.md

@@ -8,16 +8,16 @@ MCP server for [SuperSend TX](https://supersendtx.com) — send email and manage
 
 | Mode | Command / URL | Auth |
 |------|---------------|------|
-| **stdio** (default) | `npx -y supersendtx-mcp` | `SUPERSENDTX_API_KEY=stx_…` |
-| **HTTP** (local) | `npx -y supersendtx-mcp --http --port 3000` | `Authorization: Bearer stx_…` on each request |
-| **HTTP** (hosted) | `https://mcp.supersendtx.com/mcp` | **OAuth** (recommended) or `Authorization: Bearer stx_…` |
+| **stdio** (default) | `npx -y supersendtx-mcp` | `SUPERSENDTX_API_KEY=stx_…` or `rnl_…` |
+| **HTTP** (local) | `npx -y supersendtx-mcp --http --port 3000` | `Authorization: Bearer stx_…` or `rnl_…` on each request |
+| **HTTP** (hosted) | `https://mcp.supersendtx.com/mcp` | **OAuth** (recommended) or `Authorization: Bearer stx_…` or `rnl_…` |
 
 Optional: `SUPERSENDTX_API_URL` (e.g. `http://localhost:3003/api` for local API).
 
 Local HTTP endpoint: `http://127.0.0.1:3000/mcp` · health: `GET /health`  
 Hosted health: `GET https://mcp.supersendtx.com/health`
 
-Hosted OAuth: add only `"url": "https://mcp.supersendtx.com/mcp"` — the client runs the browser consent flow. Bearer `stx_…` still works for advanced setups.
+Hosted OAuth: add only `"url": "https://mcp.supersendtx.com/mcp"` — the client runs the browser consent flow. Bearer `stx_…` or `rnl_…` still works for advanced setups.
 
 ---
 

package/dist/index.js

@@ -56,15 +56,15 @@ function printHelp() {
   supersendtx-mcp --http [--port 3000] [--host 127.0.0.1]
 
 Environment:
-  SUPERSENDTX_API_KEY   Required for stdio (Bearer stx_\u2026 for HTTP)
+  SUPERSENDTX_API_KEY   Required for stdio (Bearer stx_\u2026 or rnl_\u2026 for HTTP)
   SUPERSENDTX_API_URL   Optional API base (default https://api.supersendtx.com)
 
 HTTP auth:
-  Authorization: Bearer stx_\u2026 (API key) or MCP OAuth access token
+  Authorization: Bearer stx_\u2026 or rnl_\u2026 (API key) or MCP OAuth access token
 `);
 }
 function isSuperSendTxApiKey(token) {
-  return /^stx_[a-f0-9]{48}$/i.test(token.trim());
+  return /^(?:stx_|rnl_)[a-f0-9]{48}$/i.test(token.trim());
 }
 function parseBearerToken(authorization) {
   if (!authorization) return null;
@@ -82,6 +82,65 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import { SuperSendTX } from "supersendtx";
 
+// src/arc-mcp.ts
+var ARC_MCP_TOOLS = [
+  {
+    name: "arc_get_business_brief",
+    description: "Read the business brief and lifecycle map.",
+    inputSchema: { type: "object", properties: {} },
+    growthTool: "get_business_brief"
+  },
+  {
+    name: "arc_get_setup_status",
+    description: "Connection inventory and compounding blockers.",
+    inputSchema: { type: "object", properties: {} },
+    growthTool: "get_setup_status"
+  },
+  {
+    name: "arc_get_growth_health",
+    description: "Signup \u2192 activation \u2192 pay health over a window.",
+    inputSchema: {
+      type: "object",
+      properties: { days: { type: "number" } }
+    },
+    growthTool: "get_growth_health"
+  },
+  {
+    name: "arc_request_connection",
+    description: "Surface a Connect card for a missing integration slot.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        slot: { type: "string" },
+        reason: { type: "string" }
+      },
+      required: ["slot"]
+    },
+    growthTool: "request_connection"
+  }
+];
+async function callArcMcpTool(apiKey, name, args, baseUrl) {
+  const def = ARC_MCP_TOOLS.find((tool) => tool.name === name);
+  if (!def) return null;
+  const origin = (baseUrl ?? process.env.SUPERSENDTX_API_URL ?? "https://app.supersendtx.com").replace(
+    /\/$/,
+    ""
+  );
+  const response = await fetch(`${origin}/api/growth/tools/${encodeURIComponent(def.growthTool)}`, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${apiKey}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({ input: args })
+  });
+  const body = await response.json().catch(() => ({}));
+  if (!response.ok) {
+    throw new Error(body.error ?? `Arc tool failed (${response.status})`);
+  }
+  return body.result;
+}
+
 // src/tools.ts
 function textResult(value, isError = false) {
   return {
@@ -126,8 +185,14 @@ var EMAIL_WEBHOOK_EVENTS = /* @__PURE__ */ new Set([
   "email.suppressed",
   "email.scheduled"
 ]);
-async function callMcpTool(client, name, args) {
+async function callMcpTool(client, name, args, options = {}) {
   try {
+    const arc = ARC_MCP_TOOLS.find((tool) => tool.name === name);
+    if (arc) {
+      const apiKey = options.apiKey ?? resolveApiKey();
+      const result = await callArcMcpTool(apiKey, name, args, options.baseUrl);
+      return textResult(result);
+    }
     switch (name) {
       case "send_email": {
         const from = optString(args, "from");
@@ -565,13 +630,14 @@ var MCP_TOOLS = [
     }
   }
 ];
+var MCP_TOOLS_WITH_ARC = [...MCP_TOOLS, ...ARC_MCP_TOOLS];
 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_");
+  if (!key.startsWith("stx_") && !key.startsWith("rnl_")) {
+    throw new Error("SUPERSENDTX_API_KEY must start with stx_ or rnl_");
   }
   return key;
 }
@@ -584,14 +650,17 @@ function createMcpServer(apiKey, baseUrl) {
     { capabilities: { tools: {} } }
   );
   server.setRequestHandler(ListToolsRequestSchema, async () => ({
-    tools: MCP_TOOLS.map((tool) => ({
+    tools: MCP_TOOLS_WITH_ARC.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 ?? {});
+    const result = await callMcpTool(client, request.params.name, request.params.arguments ?? {}, {
+      apiKey,
+      baseUrl
+    });
     return result;
   });
   return server;
@@ -704,7 +773,7 @@ async function handleHttpRequest(req, res, options = {}) {
     sendJson(
       res,
       401,
-      { error: "Missing or invalid Authorization. Use Bearer stx_\u2026 or complete MCP OAuth." },
+      { error: "Missing or invalid Authorization. Use Bearer stx_\u2026 / rnl_\u2026 or complete MCP OAuth." },
       { "www-authenticate": buildWwwAuthenticateChallenge(origin) }
     );
     return;
@@ -741,7 +810,7 @@ async function runHttpServer(options) {
     httpServer.listen(port, host, () => resolve());
   });
   console.error(`SuperSend TX MCP HTTP listening on http://${host}:${port}/mcp`);
-  console.error("Authenticate with Bearer stx_\u2026 or MCP OAuth access token");
+  console.error("Authenticate with Bearer stx_\u2026 / rnl_\u2026 or MCP OAuth access token");
 }
 
 // src/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "supersendtx-mcp",
-  "version": "0.5.5",
+  "version": "0.5.9",
   "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.14.1"
+    "supersendtx": "0.15.2"
   },
   "devDependencies": {
     "tsup": "^8.5.0",