@sendly/mcp 1.0.0 → 1.2.0

package/dist/index.js

@@ -4,6 +4,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
+var VERSION = "1.2.0";
 var API_KEY = process.env.SENDLY_API_KEY;
 var BASE_URL = process.env.SENDLY_BASE_URL || "https://sendly.live";
 if (!API_KEY) {
@@ -12,7 +13,30 @@ if (!API_KEY) {
   );
   process.exit(1);
 }
+if (!BASE_URL.startsWith("https://") && !BASE_URL.startsWith("http://localhost") && !BASE_URL.startsWith("http://127.0.0.1")) {
+  process.stderr.write(
+    "SENDLY_BASE_URL must use HTTPS in production.\nHTTP is only allowed for localhost development.\n"
+  );
+  process.exit(1);
+}
+var RATE_LIMIT_WINDOW_MS = 6e4;
+var RATE_LIMIT_MAX = 30;
+var rateLimitTokens = RATE_LIMIT_MAX;
+var rateLimitResetAt = Date.now() + RATE_LIMIT_WINDOW_MS;
+function checkRateLimit() {
+  const now = Date.now();
+  if (now >= rateLimitResetAt) {
+    rateLimitTokens = RATE_LIMIT_MAX;
+    rateLimitResetAt = now + RATE_LIMIT_WINDOW_MS;
+  }
+  if (rateLimitTokens <= 0) return false;
+  rateLimitTokens--;
+  return true;
+}
 async function api(method, path, body, query) {
+  if (!checkRateLimit()) {
+    throw new Error("Rate limited \u2014 too many requests. Wait a moment and try again.");
+  }
   const url = new URL(`/api/v1${path}`, BASE_URL);
   if (query) {
     for (const [k, v] of Object.entries(query)) {
@@ -29,6 +53,12 @@ async function api(method, path, body, query) {
     body: body ? JSON.stringify(body) : void 0
   });
   if (res.status === 204) return { success: true };
+  if (res.status === 429) {
+    const retryAfter = res.headers.get("Retry-After");
+    throw new Error(
+      `Rate limited by API. ${retryAfter ? `Retry after ${retryAfter} seconds.` : "Wait a moment and try again."}`
+    );
+  }
   const data = await res.json();
   if (!res.ok) {
     const msg = typeof data === "object" && data !== null ? data.error || data.message || JSON.stringify(data) : String(data);
@@ -50,7 +80,7 @@ function err(error) {
 }
 var server = new McpServer({
   name: "sendly",
-  version: "1.0.0"
+  version: VERSION
 });
 server.tool(
   "send_sms",
@@ -163,6 +193,25 @@ server.tool(
     }
   }
 );
+server.tool(
+  "get_conversation_context",
+  "Get LLM-ready formatted conversation context. Returns a pre-formatted text string with timestamped messages, AI classification, and business context \u2014 ready to paste into a prompt. More efficient than get_conversation for AI agents.",
+  {
+    conversationId: z.string().describe("The conversation ID"),
+    maxMessages: z.number().optional().describe("Max messages to include (default 20, max 50)")
+  },
+  async ({ conversationId, maxMessages }) => {
+    try {
+      return ok(
+        await api("GET", `/conversations/${conversationId}/context`, void 0, {
+          max_messages: maxMessages?.toString()
+        })
+      );
+    } catch (e) {
+      return err(e);
+    }
+  }
+);
 server.tool(
   "get_conversation",
   "Get a conversation thread by ID. Set includeMessages=true to load the message history.",
@@ -267,6 +316,158 @@ server.tool(
     }
   }
 );
+server.tool(
+  "get_suggested_replies",
+  "Get AI-generated reply suggestions for a conversation based on message history and context. Returns 2-3 suggested responses with different tones (professional, friendly, concise).",
+  {
+    conversationId: z.string().describe("The conversation ID to generate suggestions for")
+  },
+  async ({ conversationId }) => {
+    try {
+      return ok(
+        await api("POST", `/conversations/${conversationId}/suggest-replies`)
+      );
+    } catch (e) {
+      return err(e);
+    }
+  }
+);
+server.tool(
+  "create_label",
+  "Create a label for categorizing conversations and messages. Labels have a name and optional color.",
+  {
+    name: z.string().describe("Label name (e.g., 'urgent', 'vip', 'follow-up')"),
+    color: z.string().optional().describe("Hex color code (default: #6b7280)"),
+    description: z.string().optional().describe("Label description")
+  },
+  async ({ name, color, description }) => {
+    try {
+      const body = { name };
+      if (color) body.color = color;
+      if (description) body.description = description;
+      return ok(await api("POST", "/labels", body));
+    } catch (e) {
+      return err(e);
+    }
+  }
+);
+server.tool(
+  "list_labels",
+  "List all labels available in your workspace.",
+  {},
+  async () => {
+    try {
+      return ok(await api("GET", "/labels"));
+    } catch (e) {
+      return err(e);
+    }
+  }
+);
+server.tool(
+  "add_conversation_label",
+  "Add one or more labels to a conversation for categorization.",
+  {
+    conversationId: z.string().describe("The conversation ID"),
+    labelIds: z.array(z.string()).describe("Array of label IDs to add")
+  },
+  async ({ conversationId, labelIds }) => {
+    try {
+      return ok(
+        await api("POST", `/conversations/${conversationId}/labels`, {
+          labelIds
+        })
+      );
+    } catch (e) {
+      return err(e);
+    }
+  }
+);
+server.tool(
+  "remove_conversation_label",
+  "Remove a label from a conversation.",
+  {
+    conversationId: z.string().describe("The conversation ID"),
+    labelId: z.string().describe("The label ID to remove")
+  },
+  async ({ conversationId, labelId }) => {
+    try {
+      return ok(
+        await api("DELETE", `/conversations/${conversationId}/labels/${labelId}`)
+      );
+    } catch (e) {
+      return err(e);
+    }
+  }
+);
+server.tool(
+  "create_draft",
+  "Create a message draft for human review before sending. The draft must be approved before it becomes a real SMS.",
+  {
+    conversationId: z.string().describe("The conversation ID"),
+    text: z.string().describe("Draft message text"),
+    source: z.string().optional().describe("Source of the draft (default: 'ai')")
+  },
+  async ({ conversationId, text, source }) => {
+    try {
+      const body = { conversationId, text };
+      if (source) body.source = source;
+      return ok(await api("POST", "/drafts", body));
+    } catch (e) {
+      return err(e);
+    }
+  }
+);
+server.tool(
+  "list_drafts",
+  "List message drafts, optionally filtered by conversation or status.",
+  {
+    conversationId: z.string().optional().describe("Filter by conversation ID"),
+    status: z.enum(["pending", "approved", "rejected", "sent", "failed"]).optional().describe("Filter by status")
+  },
+  async ({ conversationId, status }) => {
+    try {
+      return ok(
+        await api("GET", "/drafts", void 0, {
+          conversation_id: conversationId,
+          status
+        })
+      );
+    } catch (e) {
+      return err(e);
+    }
+  }
+);
+server.tool(
+  "approve_draft",
+  "Approve a pending draft and send it as a real SMS message. Runs compliance checks and deducts credits at approval time.",
+  {
+    draftId: z.string().describe("The draft ID to approve")
+  },
+  async ({ draftId }) => {
+    try {
+      return ok(await api("POST", `/drafts/${draftId}/approve`));
+    } catch (e) {
+      return err(e);
+    }
+  }
+);
+server.tool(
+  "reject_draft",
+  "Reject a pending draft with an optional reason. The message will not be sent.",
+  {
+    draftId: z.string().describe("The draft ID to reject"),
+    reason: z.string().optional().describe("Reason for rejection")
+  },
+  async ({ draftId, reason }) => {
+    try {
+      const body = {};
+      if (reason) body.reason = reason;
+      return ok(await api("POST", `/drafts/${draftId}/reject`, body));
+    } catch (e) {
+      return err(e);
+    }
+  }
+);
 server.tool(
   "send_otp",
   "Send an OTP verification code via SMS. Use for phone verification, 2FA, or identity confirmation. Returns a verification ID to check the code against. In sandbox mode (test API key), the code is returned in the response for testing.",
@@ -329,5 +530,26 @@ server.tool(
     }
   }
 );
+server.tool(
+  "generate_business_page",
+  "Generate a hosted business landing page for verification. Use when a business doesn't have their own website. Returns a URL at sendly.live/biz/{slug} that satisfies carrier website requirements.",
+  {
+    businessName: z.string().describe("Business name"),
+    useCase: z.string().optional().describe("Use case (e.g., Insurance Services, Appointment Reminders, 2FA)"),
+    useCaseSummary: z.string().optional().describe("Brief description of what the business does"),
+    contactEmail: z.string().optional().describe("Business contact email"),
+    contactPhone: z.string().optional().describe("Business phone number"),
+    businessAddress: z.string().optional().describe("City, State ZIP (e.g., Chicago, IL 60601)")
+  },
+  async (params) => {
+    try {
+      return ok(
+        await api("POST", "/enterprise/business-page/generate", params)
+      );
+    } catch (e) {
+      return err(e);
+    }
+  }
+);
 var transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendly/mcp",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Sendly MCP Server — SMS for AI agents. Send messages, manage conversations, verify phone numbers.",
   "type": "module",
   "main": "dist/index.js",