@sendraven/mcp 0.1.0 → 0.2.0

package/README.md

@@ -82,7 +82,7 @@ hold. The tools respect all three. See
 ## Tools
 
 <!-- tools:start -->
-45 tools, generated from the server's registry.
+47 tools, generated from the server's registry.
 
 | Tool | What it does |
 | --- | --- |
@@ -96,9 +96,11 @@ hold. The tools respect all three. See
 | `list_suppressions` | List addresses we refuse to mail and why (hard_bounce, complaint, unsubscribe, manual). Check here first when someone reports not receiving email. |
 | `add_suppression` | Stop sending to an address. Scope 'marketing' leaves transactional mail working. |
 | `remove_suppression` | Remove a suppression so the address can be mailed again. Be careful with hard bounces — the address was rejected by the receiving server, and re-sending raises the bounce rate that AWS enforces on. |
-| `list_broadcasts` | List campaigns with their status and send progress. |
+| `get_broadcast` | One campaign, with a 'progress' object while it is sending or paused: how many addresses are still pending, sent, failed, or skipped because the person opted out after the campaign started. This is how you tell a paused campaign that is still making progress from one waiting on quota. |
+| `list_broadcasts` | List campaigns with their status and send progress. A campaign showing 'paused' is not broken: it ran out of the day's sending quota part way and is waiting to continue. Use get_broadcast to see how much is left, and resume_broadcast to continue it now. |
 | `preview_broadcast` | How many contacts a campaign would reach, and whether the reputation gate would allow it. Always run this before sending — it is the only way to see the size of a campaign without starting it. |
-| `send_broadcast` | Send a campaign now, or schedule it with scheduled_at. This mails every contact in the segment and cannot be undone once started — run preview_broadcast first. |
+| `resume_broadcast` | Continue a campaign left 'paused' by the daily sending quota. It mails only the addresses still pending — the audience was frozen when the campaign started and everyone already reached is marked — so calling this twice cannot double-send. Only works on a paused campaign; anything else answers 409. A background worker also resumes paused campaigns on its own once quota frees up, so use this only when waiting is not acceptable. |
+| `send_broadcast` | Send a campaign now, or schedule it with scheduled_at. This mails every contact in the segment and cannot be undone once started — run preview_broadcast first. A campaign bigger than the day's remaining quota is not rejected: it sends what it can and stops as 'paused', then continues later. That is expected, not an error to retry. |
 | `list_threads` | List email conversations. Pass awaiting_reply=true to get only the threads where someone has written to you and you haven't answered — this is the tool to poll when deciding what needs a response. |
 | `get_thread` | Read a conversation as a chronological transcript of outbound and inbound messages. Inbound text already has quoted history and signatures stripped, so read `text`; `raw_text` holds the untrimmed body if the stripped version looks wrong. Check spf_verdict and dkim_verdict before trusting a reply's claimed sender. |
 | `reply_to_message` | Reply to a message, keeping it on the same conversation. Sets the threading headers so the recipient's mail client shows it as part of the existing exchange rather than a new one. Prefer this over send_email whenever you are answering something. |

package/dist/tools/broadcasts.js

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sendBroadcastTool = exports.previewBroadcastTool = exports.listBroadcastsTool = void 0;
+exports.sendBroadcastTool = exports.resumeBroadcastTool = exports.getBroadcastTool = exports.previewBroadcastTool = exports.listBroadcastsTool = void 0;
 const zod_1 = require("zod");
 const client_1 = require("../client");
 exports.listBroadcastsTool = {
     name: "list_broadcasts",
-    description: "List campaigns with their status and send progress.",
+    description: "List campaigns with their status and send progress. A campaign showing 'paused' is not " +
+        "broken: it ran out of the day's sending quota part way and is waiting to continue. Use " +
+        "get_broadcast to see how much is left, and resume_broadcast to continue it now.",
     schema: {},
     handler: async () => (0, client_1.request)("GET", "/v1/broadcasts"),
 };
@@ -17,10 +19,31 @@ exports.previewBroadcastTool = {
     schema: { id: zod_1.z.string() },
     handler: async (args) => (0, client_1.request)("GET", `/v1/broadcasts/${args.id}/preview`),
 };
+exports.getBroadcastTool = {
+    name: "get_broadcast",
+    description: "One campaign, with a 'progress' object while it is sending or paused: how many addresses " +
+        "are still pending, sent, failed, or skipped because the person opted out after the " +
+        "campaign started. This is how you tell a paused campaign that is still making progress " +
+        "from one waiting on quota.",
+    schema: { id: zod_1.z.string() },
+    handler: async (args) => (0, client_1.request)("GET", `/v1/broadcasts/${args.id}`),
+};
+exports.resumeBroadcastTool = {
+    name: "resume_broadcast",
+    description: "Continue a campaign left 'paused' by the daily sending quota. It mails only the addresses " +
+        "still pending — the audience was frozen when the campaign started and everyone already " +
+        "reached is marked — so calling this twice cannot double-send. Only works on a paused " +
+        "campaign; anything else answers 409. A background worker also resumes paused campaigns on " +
+        "its own once quota frees up, so use this only when waiting is not acceptable.",
+    schema: { id: zod_1.z.string() },
+    handler: async (args) => (0, client_1.request)("POST", `/v1/broadcasts/${args.id}/resume`),
+};
 exports.sendBroadcastTool = {
     name: "send_broadcast",
     description: "Send a campaign now, or schedule it with scheduled_at. This mails every contact in the " +
-        "segment and cannot be undone once started — run preview_broadcast first.",
+        "segment and cannot be undone once started — run preview_broadcast first. A campaign bigger " +
+        "than the day's remaining quota is not rejected: it sends what it can and stops as 'paused', " +
+        "then continues later. That is expected, not an error to retry.",
     schema: {
         id: zod_1.z.string(),
         scheduled_at: zod_1.z.string().optional().describe("ISO 8601 timestamp; omit to send now"),

package/dist/tools/broadcasts.js.map

@@ -1 +1 @@
-{"version":3,"file":"broadcasts.js","sourceRoot":"","sources":["../../src/tools/broadcasts.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,sCAAoC;AAEvB,QAAA,kBAAkB,GAAG;IAChC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,qDAAqD;IAClE,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,IAAA,gBAAO,EAAC,KAAK,EAAE,gBAAgB,CAAC;CACtD,CAAC;AAEW,QAAA,oBAAoB,GAAG;IAClC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,4FAA4F;QAC5F,4FAA4F;QAC5F,cAAc;IAChB,MAAM,EAAE,EAAE,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE;IAC1B,OAAO,EAAE,KAAK,EAAE,IAA6B,EAAE,EAAE,CAC/C,IAAA,gBAAO,EAAC,KAAK,EAAE,kBAAkB,IAAI,CAAC,EAAE,UAAU,CAAC;CACtD,CAAC;AAEW,QAAA,iBAAiB,GAAG;IAC/B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,yFAAyF;QACzF,0EAA0E;IAC5E,MAAM,EAAE;QACN,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;QACd,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;KACrF;IACD,OAAO,EAAE,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC/C,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAC7B,OAAO,IAAA,gBAAO,EAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5D,CAAC;CACF,CAAC"}
+{"version":3,"file":"broadcasts.js","sourceRoot":"","sources":["../../src/tools/broadcasts.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,sCAAoC;AAEvB,QAAA,kBAAkB,GAAG;IAChC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,yFAAyF;QACzF,yFAAyF;QACzF,iFAAiF;IACnF,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,IAAA,gBAAO,EAAC,KAAK,EAAE,gBAAgB,CAAC;CACtD,CAAC;AAEW,QAAA,oBAAoB,GAAG;IAClC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,4FAA4F;QAC5F,4FAA4F;QAC5F,cAAc;IAChB,MAAM,EAAE,EAAE,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE;IAC1B,OAAO,EAAE,KAAK,EAAE,IAA6B,EAAE,EAAE,CAC/C,IAAA,gBAAO,EAAC,KAAK,EAAE,kBAAkB,IAAI,CAAC,EAAE,UAAU,CAAC;CACtD,CAAC;AAEW,QAAA,gBAAgB,GAAG;IAC9B,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,2FAA2F;QAC3F,qFAAqF;QACrF,yFAAyF;QACzF,4BAA4B;IAC9B,MAAM,EAAE,EAAE,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE;IAC1B,OAAO,EAAE,KAAK,EAAE,IAA6B,EAAE,EAAE,CAAC,IAAA,gBAAO,EAAC,KAAK,EAAE,kBAAkB,IAAI,CAAC,EAAE,EAAE,CAAC;CAC9F,CAAC;AAEW,QAAA,mBAAmB,GAAG;IACjC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,4FAA4F;QAC5F,yFAAyF;QACzF,uFAAuF;QACvF,4FAA4F;QAC5F,+EAA+E;IACjF,MAAM,EAAE,EAAE,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE;IAC1B,OAAO,EAAE,KAAK,EAAE,IAA6B,EAAE,EAAE,CAC/C,IAAA,gBAAO,EAAC,MAAM,EAAE,kBAAkB,IAAI,CAAC,EAAE,SAAS,CAAC;CACtD,CAAC;AAEW,QAAA,iBAAiB,GAAG;IAC/B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,yFAAyF;QACzF,6FAA6F;QAC7F,8FAA8F;QAC9F,gEAAgE;IAClE,MAAM,EAAE;QACN,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;QACd,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;KACrF;IACD,OAAO,EAAE,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC/C,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAC7B,OAAO,IAAA,gBAAO,EAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5D,CAAC;CACF,CAAC"}

package/dist/tools/index.js

@@ -32,8 +32,10 @@ exports.TOOLS = [
     suppressions_1.listSuppressionsTool,
     suppressions_1.addSuppressionTool,
     suppressions_1.removeSuppressionTool,
+    broadcasts_1.getBroadcastTool,
     broadcasts_1.listBroadcastsTool,
     broadcasts_1.previewBroadcastTool,
+    broadcasts_1.resumeBroadcastTool,
     broadcasts_1.sendBroadcastTool,
     threads_1.listThreadsTool,
     threads_1.getThreadTool,

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACH,qCAKkB;AAClB,uCAA6E;AAC7E,iDAIwB;AACxB,6CAIsB;AACtB,uCAA+E;AAC/E,2CAAsF;AACtF,2CAAoE;AACpE,+CAA+E;AAC/E,qCAAkF;AAClF,2CAYqB;AACrB,6CAQsB;AAeT,QAAA,KAAK,GAAc;IAC9B,sBAAa;IACb,uBAAc;IACd,qBAAY;IACZ,wBAAe;IACf,yBAAe;IACf,uBAAa;IACb,0BAAgB;IAChB,mCAAoB;IACpB,iCAAkB;IAClB,oCAAqB;IACrB,+BAAkB;IAClB,iCAAoB;IACpB,8BAAiB;IACjB,yBAAe;IACf,uBAAa;IACb,4BAAkB;IAClB,6BAAiB;IACjB,8BAAkB;IAClB,4BAAgB;IAChB,6BAAiB;IACjB,8BAAkB;IAClB,iCAAmB;IACnB,wBAAU;IACV,2BAAa;IACb,uBAAc;IACd,2BAAkB;IAClB,2BAAkB;IAClB,6BAAiB;IACjB,0BAAc;IACd,0BAAc;IACd,6BAAiB;IACjB,4BAAgB;IAChB,wBAAY;IACZ,4BAAgB;IAChB,wBAAW;IACX,8BAAiB;IACjB,8BAAiB;IACjB,kCAAqB;IACrB,oCAAuB;IACvB,4BAAe;IACf,yBAAY;IACZ,2BAAe;IACf,kCAAsB;IACtB,6BAAiB;IACjB,0BAAc;CACf,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACH,qCAKkB;AAClB,uCAA6E;AAC7E,iDAIwB;AACxB,6CAMsB;AACtB,uCAA+E;AAC/E,2CAAsF;AACtF,2CAAoE;AACpE,+CAA+E;AAC/E,qCAAkF;AAClF,2CAYqB;AACrB,6CAQsB;AAeT,QAAA,KAAK,GAAc;IAC9B,sBAAa;IACb,uBAAc;IACd,qBAAY;IACZ,wBAAe;IACf,yBAAe;IACf,uBAAa;IACb,0BAAgB;IAChB,mCAAoB;IACpB,iCAAkB;IAClB,oCAAqB;IACrB,6BAAgB;IAChB,+BAAkB;IAClB,iCAAoB;IACpB,gCAAmB;IACnB,8BAAiB;IACjB,yBAAe;IACf,uBAAa;IACb,4BAAkB;IAClB,6BAAiB;IACjB,8BAAkB;IAClB,4BAAgB;IAChB,6BAAiB;IACjB,8BAAkB;IAClB,iCAAmB;IACnB,wBAAU;IACV,2BAAa;IACb,uBAAc;IACd,2BAAkB;IAClB,2BAAkB;IAClB,6BAAiB;IACjB,0BAAc;IACd,0BAAc;IACd,6BAAiB;IACjB,4BAAgB;IAChB,wBAAY;IACZ,4BAAgB;IAChB,wBAAW;IACX,8BAAiB;IACjB,8BAAiB;IACjB,kCAAqB;IACrB,oCAAuB;IACvB,4BAAe;IACf,yBAAY;IACZ,2BAAe;IACf,kCAAsB;IACtB,6BAAiB;IACjB,0BAAc;CACf,CAAC"}

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@sendraven/mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server for SendRaven: send email, read replies as threads, run campaigns, and decide approvals, with per-key limits for agents.",
+  "mcpName": "ai.sendraven/mcp",
   "license": "MIT",
   "author": "Common Ninja Ltd.",
   "homepage": "https://sendraven.ai/mcp",

package/server.json

@@ -1,20 +1,22 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
   "name": "ai.sendraven/mcp",
-  "description": "Email for AI agents: send, read replies as threads, run campaigns, decide approvals, with per-key limits.",
+  "description": "Email for AI agents: send, read replies as threads, run campaigns, with per-key limits.",
   "repository": {
     "url": "https://github.com/CommonNinja/sendraven-mcp-server",
     "source": "github"
   },
-  "version": "0.1.0",
+  "version": "0.2.0",
   "websiteUrl": "https://sendraven.ai/mcp",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@sendraven/mcp",
-      "version": "0.1.0",
-      "transport": { "type": "stdio" },
+      "version": "0.2.0",
+      "transport": {
+        "type": "stdio"
+      },
       "environmentVariables": [
         {
           "name": "SENDRAVEN_API_KEY",