@sendly/mcp 2.0.1 → 2.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @sendly/mcp
 
-Full SMS platform for AI agents — 82 tools for messaging, contacts, campaigns, templates, webhooks, OTP verification, conversations, labels, drafts, and more via [Model Context Protocol](https://modelcontextprotocol.io).
+Full SMS platform for AI agents — 85 tools for messaging, contacts, campaigns, templates, webhooks, OTP verification, conversations, labels, drafts, and more via [Model Context Protocol](https://modelcontextprotocol.io).
 
 ## Quick Setup
 
@@ -241,7 +241,7 @@ With test keys, use magic numbers:
 
 ## Links
 
-- [MCP Tools Reference](https://sendly.live/docs/ai/mcp-tools) — all 82 tools with schemas
+- [MCP Tools Reference](https://sendly.live/docs/ai/mcp-tools) — all 85 tools with schemas
 - [Agent Skills](https://sendly.live/skills) — SKILL.md files for 8 platforms
 - [API Reference](https://sendly.live/docs/api)
 - [Sendly Dashboard](https://sendly.live/dashboard)

package/dist/index.js

@@ -3,6 +3,9 @@
 // src/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { readFileSync } from "fs";
+import { dirname, resolve } from "path";
+import { fileURLToPath } from "url";
 
 // src/tools.ts
 import { z } from "zod";
@@ -439,6 +442,67 @@ function registerAllTools(server2, api2) {
       }
     }
   );
+  server2.tool(
+    "mark_contact_valid",
+    "Clear the invalid flag on a contact so future campaigns include it again. Contacts get auto-flagged as invalid when a send fails with a terminal bad-number error (landline, invalid number) or when a carrier lookup reports they can't receive SMS. Use this when you disagree with the auto-flag.",
+    {
+      contactId: z.string().describe("The contact ID to clear the invalid flag on")
+    },
+    async ({ contactId }) => {
+      try {
+        return ok(await api2("POST", `/contacts/${contactId}/mark-valid`));
+      } catch (e) {
+        return err(e);
+      }
+    }
+  );
+  server2.tool(
+    "check_contact_numbers",
+    "Trigger a background carrier lookup across contacts. Landlines and other non-SMS-capable numbers are auto-excluded from future campaigns. The lookup runs asynchronously (1-5 minutes). Results populate line_type, carrier_name, and invalid_reason fields on affected contacts. Idempotent: re-triggering while a lookup is running for the same scope is a no-op \u2014 response carries alreadyRunning: true in that case.",
+    {
+      listId: z.string().optional().describe("Scope the lookup to a single contact list"),
+      force: z.boolean().optional().describe("Re-check contacts even if already looked up (default: false)")
+    },
+    async ({ listId, force }) => {
+      try {
+        return ok(
+          await api2("POST", "/contacts/lookup", {
+            listId: listId ?? null,
+            force: force ?? false
+          })
+        );
+      } catch (e) {
+        return err(e);
+      }
+    }
+  );
+  server2.tool(
+    "bulk_mark_contacts_valid",
+    "Clear the invalid flag on many contacts at once (up to 10,000 per call). Pass either an explicit id array OR a listId \u2014 not both. Foreign ids silently no-op via the per-organization filter. Returns { cleared } \u2014 the number of contacts whose flag was actually cleared.",
+    {
+      ids: z.array(z.string()).max(1e4).optional().describe("Explicit contact ids to clear (max 10,000)"),
+      listId: z.string().optional().describe("Clear every flagged member of this list")
+    },
+    async ({ ids, listId }) => {
+      if (!ids && !listId) {
+        return err("bulk_mark_contacts_valid requires either 'ids' or 'listId'");
+      }
+      if (ids && listId) {
+        return err("bulk_mark_contacts_valid accepts 'ids' OR 'listId', not both");
+      }
+      try {
+        return ok(
+          await api2(
+            "POST",
+            "/contacts/bulk-mark-valid",
+            ids ? { ids } : { listId }
+          )
+        );
+      } catch (e) {
+        return err(e);
+      }
+    }
+  );
   server2.tool(
     "import_contacts",
     "Bulk import contacts from an array. Optionally add all imported contacts to a list. Returns created/updated/skipped counts.",
@@ -1177,6 +1241,78 @@ function registerAllTools(server2, api2) {
       }
     }
   );
+  server2.tool(
+    "reset_webhook_circuit",
+    "Reset the circuit breaker for a webhook so deliveries resume immediately instead of waiting for the automatic 5-minute recovery.",
+    { webhookId: z.string().describe("The webhook ID") },
+    async ({ webhookId }) => {
+      try {
+        return ok(await api2("POST", `/webhooks/${webhookId}/reset-circuit`));
+      } catch (e) {
+        return err(e);
+      }
+    }
+  );
+  server2.tool(
+    "redeliver_webhook",
+    "Replay failed or cancelled webhook deliveries from the audit log for a time window. Use after a customer endpoint has recovered from an outage. Reset the circuit first if it is open. Each replay preserves the original event_id for dedup.",
+    {
+      webhookId: z.string().describe("The webhook ID"),
+      since: z.string().optional().describe(
+        "Earliest delivery time, ISO-8601. Defaults to 24h ago."
+      ),
+      until: z.string().optional().describe("Latest delivery time, ISO-8601. Defaults to now."),
+      eventTypes: z.array(z.string()).optional().describe("Filter by event type. Defaults to all."),
+      statuses: z.array(z.string()).optional().describe(
+        "Replay deliveries in any of these statuses. Defaults to ['failed', 'cancelled']."
+      ),
+      limit: z.number().int().positive().max(1e4).optional().describe("Max deliveries to requeue. Defaults to 1000, max 10000.")
+    },
+    async ({ webhookId, since, until, eventTypes, statuses, limit }) => {
+      try {
+        const body = {};
+        if (since !== void 0) body.since = since;
+        if (until !== void 0) body.until = until;
+        if (eventTypes !== void 0) body.event_types = eventTypes;
+        if (statuses !== void 0) body.statuses = statuses;
+        if (limit !== void 0) body.limit = limit;
+        return ok(
+          await api2("POST", `/webhooks/${webhookId}/redeliver`, body)
+        );
+      } catch (e) {
+        return err(e);
+      }
+    }
+  );
+  server2.tool(
+    "backfill_webhook",
+    "Synthesize webhook events from the underlying message log for events that have no audit row (the case redeliver_webhook cannot recover). Use this when a circuit-breaker outage left events with no delivery record. Synthesized events have fresh IDs \u2014 clients should dedupe by event.data.object.id (the message ID). Reset the circuit first if it is open.",
+    {
+      webhookId: z.string().describe("The webhook ID"),
+      since: z.string().optional().describe(
+        "Earliest message time, ISO-8601. Defaults to 24h ago."
+      ),
+      until: z.string().optional().describe("Latest message time, ISO-8601. Defaults to now."),
+      eventTypes: z.array(z.string()).optional().describe(
+        "Filter by event type. Defaults to subscribed message events."
+      ),
+      limit: z.number().int().positive().max(1e4).optional().describe("Max events to synthesize. Defaults to 1000, max 10000.")
+    },
+    async ({ webhookId, since, until, eventTypes, limit }) => {
+      try {
+        const body = {};
+        if (since !== void 0) body.since = since;
+        if (until !== void 0) body.until = until;
+        if (eventTypes !== void 0) body.event_types = eventTypes;
+        if (limit !== void 0) body.limit = limit;
+        return ok(
+          await api2("POST", `/webhooks/${webhookId}/backfill`, body)
+        );
+      } catch (e) {
+        return err(e);
+      }
+    }
+  );
   server2.tool(
     "send_otp",
     "Send an OTP verification code via SMS. Use for phone verification, 2FA, or identity confirmation. In sandbox mode (test API key), the code is returned in the response.",
@@ -1356,7 +1492,11 @@ function registerAllTools(server2, api2) {
 }
 
 // src/index.ts
-var VERSION = "2.0.0";
+var __dirname = dirname(fileURLToPath(import.meta.url));
+var pkg = JSON.parse(
+  readFileSync(resolve(__dirname, "../package.json"), "utf8")
+);
+var VERSION = pkg.version;
 var API_KEY = process.env.SENDLY_API_KEY;
 var BASE_URL = process.env.SENDLY_BASE_URL || "https://sendly.live";
 if (!API_KEY) {
@@ -1396,7 +1536,8 @@ async function api(method, path, body, query) {
     }
   }
   const headers = {
-    Authorization: `Bearer ${API_KEY}`
+    Authorization: `Bearer ${API_KEY}`,
+    "User-Agent": `@sendly/mcp/${VERSION}`
   };
   if (body) headers["Content-Type"] = "application/json";
   const res = await fetch(url.toString(), {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendly/mcp",
-  "version": "2.0.1",
+  "version": "2.3.0",
   "description": "Sendly MCP Server — Full SMS platform for AI agents. Messaging, contacts, campaigns, templates, webhooks, OTP verification, and more.",
   "type": "module",
   "main": "dist/index.js",