supersendtx-mcp 0.6.35 → 0.6.39

package/README.md

@@ -1,8 +1,8 @@
 # supersendtx-mcp
 
-MCP server for [SuperSend TX](https://supersendtx.com) — send email and manage domains, webhooks, suppressions, and templates from Cursor, Claude Code, and other MCP clients, and talk to Ranla, the agent in the same account.
+MCP server for [SuperSend TX](https://ranla.ai) — send email and manage domains, webhooks, suppressions, and templates from Cursor, Claude Code, and other MCP clients, and talk to Ranla, the agent in the same account.
 
-**Install:** `npx -y supersendtx-mcp` · **Docs:** https://docs.supersendtx.com/ai/mcp
+**Install:** `npx -y supersendtx-mcp` · **Docs:** https://docs.ranla.ai/ai/mcp
 
 ## Transports
 
@@ -138,16 +138,15 @@ These call the app host and need a full-access key (OAuth sign-in and dashboard
 | `arc_get_thread` | Read a thread's messages, artifacts and waiting approvals |
 | `arc_message` | Send text to Ranla and wait for the turn — returns `text`, `artifacts`, and `pendingApproval` |
 | `arc_list_approvals` / `arc_approve` / `arc_reject` | Answer approvals |
-| `arc_request_connection` | Connect link for a missing integration |
-| `arc_<tool>` | Read-only Ranla tools, listed from the account with input schemas. Results say in `forCaller` when a step needs `arc_message` |
+| `arc_ranla` | Run one of Ranla's commands (`campaign list`, `page propose`, `connection request`). The description lists them from the account; `help <noun>` gives every field. What needs sign-off comes back as `pendingApproval` |
 
-Flow: `arc_ensure_thread` → `arc_message` → if a step needs approval, `arc_list_approvals` → `arc_approve` or `arc_reject`.
+Flow: `arc_ensure_thread`, then `arc_message` or `arc_ranla`, and if a step needs approval, `arc_list_approvals`, then `arc_approve` or `arc_reject`.
 
-An SEO page approval also carries `actionId`: pass it to `arc_seo_page_package` to read the draft, for example to build the page in your own repo.
+An SEO page approval also carries `actionId`: run `arc_ranla` with `page get` and that `actionId` to read the draft, for example to build the page in your own repo.
 
 Every tool has a `title` and `readOnlyHint` / `destructiveHint` annotations, so clients can run reads without asking and confirm writes.
 
-Full reference: https://docs.supersendtx.com/ai/mcp
+Full reference: https://docs.ranla.ai/ai/mcp
 
 ## License
 

package/dist/index.js

@@ -84,7 +84,7 @@ import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprot
 import { SuperSendTX } from "supersendtx";
 
 // package.json
-var version = "0.6.35";
+var version = "0.6.39";
 
 // src/annotations.ts
 var READ = { readOnlyHint: true };
@@ -118,6 +118,8 @@ var FIXED_TOOL_HINTS = {
   arc_get_thread: { ...READ, title: "Read a Ranla thread" },
   arc_ensure_thread: { ...WRITE, title: "Open a Ranla thread", idempotentHint: true },
   arc_message: { ...WRITE, title: "Message Ranla" },
+  /** A command can change the account; what reaches people or spends stops at an approval. */
+  arc_ranla: { ...WRITE, title: "Run a Ranla command", openWorldHint: true },
   arc_list_approvals: { ...READ, title: "List pending approvals" },
   /** Approving can send email to real people. */
   arc_approve: { ...WRITE, title: "Approve a Ranla step", openWorldHint: true },
@@ -142,102 +144,6 @@ function mcpToolAnnotations(tool) {
   return tool.readOnly === true ? { title, ...READ } : { title, ...WRITE };
 }
 
-// src/arc-talk-tools.ts
-var ARC_MCP_TALK_GROWTH_TOOL_NAMES = [
-  // Cold-start SEO plan: a minute of vendor data and a planning call. Read-only, so MCP carries it.
-  "seo_plan",
-  "get_business_brief",
-  "get_brand",
-  "read_url",
-  // A canvas document Ranla wrote, as it stands now. Writing to one mutates
-  // and goes through `arc_message` like every other write.
-  "read_canvas",
-  // The ids read_canvas takes; nothing else an external agent can call returns them.
-  "list_documents",
-  // Every image in the account, with public URLs an external agent can use as they are.
-  "list_library_images",
-  "get_setup_status",
-  "get_growth_health",
-  "get_revenue_health",
-  "list_product_events",
-  "list_product_analytics",
-  "inspect_analytics_person",
-  "inspect_attribute_values",
-  "list_campaigns",
-  "list_goals",
-  "list_lists",
-  "list_segments",
-  "get_segment",
-  "get_tracking_snippet",
-  "verify_tracking_install",
-  "list_automations",
-  "get_automation",
-  "get_setup_run",
-  "propose_lifecycle_events",
-  "list_plan",
-  "get_job_schedule",
-  "list_opportunities",
-  "list_ideas",
-  "get_comms_prefs",
-  "list_audience",
-  "preview_segment",
-  "estimate_reach",
-  "list_templates",
-  "get_template",
-  "list_on_site_messages",
-  "get_on_site_message",
-  "get_on_site_theme",
-  "show_install",
-  "get_campaign_performance",
-  "get_campaign_evaluation",
-  "list_ad_campaigns",
-  "get_ad_spend",
-  "get_ad_delivery_diagnostics",
-  "get_search_term_evidence",
-  "list_proposed_ad_campaigns",
-  "read_campaign_design",
-  "list_campaign_replies",
-  // The inbox as conversations, with the replies Ranla drafted.
-  "read_inbox",
-  "get_learnings",
-  "read_repo_activity",
-  "get_codebase_digest",
-  "read_product_context",
-  "search_codebase",
-  "read_repo_file",
-  "site_traffic_summary",
-  "site_traffic_breakdown",
-  "site_traffic_efforts",
-  // Search reads. Read-only on the customer's own data, same as the analytics
-  // reads above: the role that owns them recommends and never publishes.
-  "seo_search_performance",
-  "seo_opportunities",
-  "seo_site_authority",
-  "seo_site_structure",
-  "seo_page_detail",
-  "seo_page_package",
-  // Reddit reads. Our own tables only: the inbox, a thread with its drafts,
-  // what ranks on Google, post ideas, connected accounts, the activity log.
-  "reddit_desk_status",
-  "reddit_opportunities",
-  "reddit_thread_detail",
-  "reddit_rankings",
-  "reddit_ai_citations",
-  "reddit_post_ideas",
-  "reddit_accounts",
-  "reddit_activity",
-  "reddit_leads",
-  "seo_competitors",
-  "seo_lift_queue",
-  // AI search reads. Our own tables only: how the answer engines see the product.
-  "aeo_status",
-  "aeo_prompts",
-  "aeo_answer",
-  "aeo_sources",
-  "aeo_competitors",
-  "aeo_actions"
-];
-
 // src/arc-mcp.ts
 var DEFAULT_APP_ORIGIN = "https://app.supersendtx.com";
 var DEFAULT_RANLA_APP_ORIGIN = "https://app.ranla.ai";
@@ -251,31 +157,27 @@ function openObjectSchema(description) {
   };
 }
 var RANLA_AGENT_NAME = "Ranla";
-var TALK_READ_TOOLS = ARC_MCP_TALK_GROWTH_TOOL_NAMES.map((growthTool) => ({
-  name: `arc_${growthTool}`,
-  description: `Read-only Ranla tool: ${growthTool.replace(/_/g, " ")}.`,
-  inputSchema: openObjectSchema("Pass the tool arguments as fields."),
-  kind: "growth",
-  growthTool,
-  readOnly: true
-}));
-var SETUP_TOOLS = [
-  {
-    name: "arc_request_connection",
-    description: "Surface a Connect card for a missing integration slot.",
+var RANLA_COMMAND_TOOL_NAME = "arc_ranla";
+var RANLA_COMMAND_INTRO = `Run one of ${RANLA_AGENT_NAME}'s commands in this account. command is "<noun> <verb>", such as "campaign list" or "page propose", and input holds its fields. "help <noun>" lists a noun's commands with every field. A command that needs sign-off does nothing yet: it comes back with pendingApproval, and arc_approve with its messageId applies it. For strategy, or anything that needs ${RANLA_AGENT_NAME}'s judgement or research, use arc_message.`;
+function ranlaCommandTool(index) {
+  return {
+    name: RANLA_COMMAND_TOOL_NAME,
+    description: index ? `${RANLA_COMMAND_INTRO}
+
+Commands:
+${index}` : RANLA_COMMAND_INTRO,
     inputSchema: {
       type: "object",
       properties: {
-        slot: { type: "string" },
-        reason: { type: "string" }
+        command: { type: "string", description: '"<noun> <verb>", or "help <noun>".' },
+        input: { type: "object", description: "The command's fields.", additionalProperties: true },
+        threadId: { type: "string", description: "Ranla thread to record it in (from arc_ensure_thread). Optional." }
       },
-      required: ["slot"]
+      required: ["command"]
     },
-    kind: "growth",
-    growthTool: "request_connection",
-    readOnly: false
-  }
-];
+    kind: "meta"
+  };
+}
 var META_TOOLS = [
   {
     name: "arc_list_threads",
@@ -364,7 +266,7 @@ var META_TOOLS = [
     kind: "meta"
   }
 ];
-var ARC_MCP_TOOLS = [...META_TOOLS, ...SETUP_TOOLS, ...TALK_READ_TOOLS];
+var ARC_MCP_TOOLS = [...META_TOOLS, ranlaCommandTool()];
 function resolveArcAppOrigin(options = {}) {
   const fromEnv = process.env.RANLA_APP_URL?.trim() || process.env.SUPERSENDTX_APP_URL?.trim() || "";
   if (fromEnv) return fromEnv.replace(/\/$/, "");
@@ -394,40 +296,22 @@ var CATALOG_TIMEOUT_MS = 4e3;
 function isArcMcpToolName(name) {
   return name.startsWith(ARC_TOOL_PREFIX);
 }
-function isCatalogEntry(value) {
-  if (!value || typeof value !== "object") return false;
-  const entry = value;
-  const schema = entry.inputSchema;
-  return typeof entry.name === "string" && /^[a-z0-9_]+$/.test(entry.name) && typeof entry.description === "string" && !!schema && typeof schema === "object" && schema.type === "object";
-}
-async function fetchGrowthToolCatalog(apiKey, baseUrl) {
+async function fetchCommandIndex(apiKey, baseUrl) {
   try {
     const origin = resolveArcAppOrigin({ baseUrl, apiKey });
-    const response = await arcFetch(origin, apiKey, "/api/growth/tools", {
+    const response = await arcFetch(origin, apiKey, "/api/growth/commands", {
       signal: AbortSignal.timeout(CATALOG_TIMEOUT_MS)
     });
-    if (!response.ok || !Array.isArray(response.body.tools)) return null;
-    const entries = response.body.tools.filter(isCatalogEntry);
-    return entries.length > 0 ? entries : null;
+    const index = response.body.index;
+    return response.ok && typeof index === "string" && index.trim() ? index : null;
   } catch {
     return null;
   }
 }
 async function loadArcMcpTools(apiKey, baseUrl) {
-  const catalog = await fetchGrowthToolCatalog(apiKey, baseUrl);
-  if (!catalog) return ARC_MCP_TOOLS;
-  return [
-    ...META_TOOLS,
-    ...catalog.map((entry) => ({
-      name: `${ARC_TOOL_PREFIX}${entry.name}`,
-      description: `${entry.mutates ? RANLA_AGENT_NAME : `${RANLA_AGENT_NAME}, read-only`}: ${entry.description}`,
-      inputSchema: entry.inputSchema,
-      kind: "growth",
-      growthTool: entry.name,
-      // Missing `mutates` is not a promise of read-only: only an explicit false is.
-      readOnly: entry.mutates === false
-    }))
-  ];
+  const index = await fetchCommandIndex(apiKey, baseUrl);
+  if (!index) return ARC_MCP_TOOLS;
+  return [...META_TOOLS, ranlaCommandTool(index)];
 }
 function optString(args, key) {
   if (args[key] == null) return void 0;
@@ -437,6 +321,22 @@ function optString(args, key) {
 async function callArcMcpTool(apiKey, name, args, baseUrl) {
   if (!isArcMcpToolName(name)) return null;
   const origin = resolveArcAppOrigin({ baseUrl, apiKey });
+  if (name === RANLA_COMMAND_TOOL_NAME) {
+    const command = optString(args, "command");
+    if (!command) throw new Error("Missing required argument: command");
+    const input = args.input && typeof args.input === "object" && !Array.isArray(args.input) ? args.input : {};
+    const threadId = optString(args, "threadId");
+    const response = await arcFetch(origin, apiKey, "/api/growth/commands", {
+      method: "POST",
+      body: JSON.stringify({ command, input, ...threadId ? { threadId } : {} })
+    });
+    if (!response.ok) {
+      throw new Error(
+        typeof response.body.error === "string" ? response.body.error : `Ranla command failed (${response.status})`
+      );
+    }
+    return response.body;
+  }
   if (!META_TOOLS.some((tool) => tool.name === name)) {
     const growthTool = name.slice(ARC_TOOL_PREFIX.length);
     const response = await arcFetch(origin, apiKey, `/api/growth/tools/${encodeURIComponent(growthTool)}`, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "supersendtx-mcp",
-  "version": "0.6.35",
+  "version": "0.6.39",
   "description": "SuperSend TX MCP server — mail tools plus Ranla agent-first tools for Cursor and Claude",
   "license": "MIT",
   "type": "module",
@@ -17,7 +17,7 @@
     "url": "git+https://github.com/Super-Send/superTX-app.git",
     "directory": "packages/supersendtx-mcp"
   },
-  "homepage": "https://docs.supersendtx.com/ai/mcp",
+  "homepage": "https://docs.ranla.ai/ai/mcp",
   "keywords": [
     "mcp",
     "email",
@@ -40,7 +40,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "supersendtx": "0.15.6"
+    "supersendtx": "0.15.7"
   },
   "devDependencies": {
     "tsup": "^8.5.0",