@coldbirds/mcp-server 1.0.1 → 1.0.3

package/dist/mcp.fallback.json

@@ -1269,9 +1269,60 @@
     {
       "name": "list_mailboxes",
       "title": "List Mailboxes",
-      "description": "Lists all sender mailboxes connected to the account.",
+      "description": "Lists sender mailboxes connected to the account. Supports filtering by status, provider, label, warmup state, connection health (SMTP/IMAP), DNS issues, and free-text search across email + display name. Cursor-paginated — pass the returned nextCursor to fetch the next page.",
       "inputSchema": {
         "type": "object",
+        "properties": {
+          "cursor": {
+            "type": "string",
+            "description": "Pagination cursor from the previous response's nextCursor."
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "default": 25,
+            "description": "Number of mailboxes to return per page."
+          },
+          "search": {
+            "type": "string",
+            "description": "Case-insensitive substring match on email address or display name."
+          },
+          "labelId": {
+            "type": "string",
+            "description": "Filter to a single label."
+          },
+          "provider": {
+            "type": "string",
+            "description": "Comma-separated provider list. Allowed values: GSUITE, MICROSOFT365, SMTP."
+          },
+          "status": {
+            "type": "string",
+            "description": "Comma-separated mailbox status list. Allowed values: ACTIVE, PAUSED, DISCONNECTED, SUSPENDED, DISGARDED."
+          },
+          "warmupEnabled": {
+            "type": "boolean",
+            "description": "Filter by warmup-enabled flag."
+          },
+          "isWarmupSeed": {
+            "type": "boolean",
+            "description": "Filter by warmup-seed flag."
+          },
+          "smtp": {
+            "type": "string",
+            "enum": ["ok", "failed"],
+            "description": "SMTP connection health filter."
+          },
+          "imap": {
+            "type": "string",
+            "enum": ["ok", "failed"],
+            "description": "IMAP connection health filter."
+          },
+          "dnsIssues": {
+            "type": "string",
+            "description": "Comma-separated DNS records flagged as missing or broken. Allowed values: mx, spf, dkim, a."
+          }
+        },
         "additionalProperties": false
       },
       "outputSchema": {
@@ -1282,48 +1333,44 @@
             "items": {
               "type": "object",
               "properties": {
-                "id": {
-                  "type": "string"
-                },
-                "emailAddress": {
-                  "type": "string",
-                  "format": "email"
-                },
-                "displayName": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
+                "id": { "type": "string" },
+                "emailAddress": { "type": "string", "format": "email" },
+                "displayName": { "type": ["string", "null"] },
                 "provider": {
                   "type": "string",
-                  "enum": [
-                    "GOOGLE",
-                    "MICROSOFT",
-                    "SMTP"
-                  ]
+                  "enum": ["GSUITE", "MICROSOFT365", "SMTP"]
                 },
                 "status": {
-                  "type": "string"
-                },
-                "createdAt": {
                   "type": "string",
-                  "format": "date-time"
-                }
+                  "enum": ["ACTIVE", "PAUSED", "DISCONNECTED", "SUSPENDED", "DISGARDED"]
+                },
+                "labelId": { "type": ["string", "null"] },
+                "isWarmupSeed": { "type": "boolean" },
+                "warmupEnabled": { "type": "boolean" },
+                "warmupLastSendAt": { "type": ["string", "null"], "format": "date-time" },
+                "smtpOk": { "type": ["boolean", "null"] },
+                "imapOk": { "type": ["boolean", "null"] },
+                "dnsMxOk": { "type": ["boolean", "null"] },
+                "dnsSpfOk": { "type": ["boolean", "null"] },
+                "dnsDkimOk": { "type": ["boolean", "null"] },
+                "dnsRecordOk": { "type": ["boolean", "null"] },
+                "connectionFailCount": { "type": "integer" },
+                "createdAt": { "type": "string", "format": "date-time" },
+                "updatedAt": { "type": "string", "format": "date-time" }
               },
-              "required": [
-                "id",
-                "emailAddress",
-                "provider",
-                "status",
-                "createdAt"
-              ]
+              "required": ["id", "emailAddress", "provider", "status", "createdAt", "updatedAt"]
             }
+          },
+          "pagination": {
+            "type": "object",
+            "properties": {
+              "nextCursor": { "type": ["string", "null"] },
+              "hasMore": { "type": "boolean" }
+            },
+            "required": ["nextCursor", "hasMore"]
           }
         },
-        "required": [
-          "data"
-        ]
+        "required": ["data"]
       },
       "annotations": {
         "readOnlyHint": true,
@@ -1719,6 +1766,291 @@
         "path": "/api/v1/mailboxes/{id}"
       }
     },
+    {
+      "name": "get_mailbox_warmup",
+      "title": "Get Mailbox Warmup Analytics",
+      "description": "Returns warmup performance analytics for a single mailbox: today's score, trailing-window score, day-over-day delta, daily counters (sent / delivered / spam / rescued / bounced / opened / replied / marked), and per-ESP placement stats. Use this to diagnose why a mailbox's warmup is degrading.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Mailbox ID."
+          },
+          "windowDays": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 90,
+            "description": "Trailing window in days for daily counters and trailing score (default 30)."
+          }
+        },
+        "required": ["id"],
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "mailboxId": { "type": "string" },
+          "windowDays": { "type": "integer" },
+          "today": {
+            "type": "object",
+            "properties": {
+              "score": { "type": "integer" },
+              "placementRate": { "type": "number" },
+              "replyRate": { "type": "number" },
+              "openRate": { "type": "number" },
+              "markRate": { "type": "number" },
+              "bounceRate": { "type": "number" },
+              "placed": { "type": "integer" }
+            }
+          },
+          "trailing": {
+            "type": "object",
+            "properties": {
+              "score": { "type": "integer" },
+              "placementRate": { "type": "number" },
+              "replyRate": { "type": "number" },
+              "openRate": { "type": "number" },
+              "markRate": { "type": "number" },
+              "bounceRate": { "type": "number" },
+              "placed": { "type": "integer" }
+            }
+          },
+          "yesterday": {
+            "type": "object",
+            "properties": {
+              "score": { "type": "integer" }
+            }
+          },
+          "delta": { "type": "integer" },
+          "daily": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "day": { "type": "string", "format": "date-time" },
+                "sent": { "type": "integer" },
+                "delivered": { "type": "integer" },
+                "landedSpam": { "type": "integer" },
+                "rescued": { "type": "integer" },
+                "bounced": { "type": "integer" },
+                "opened": { "type": "integer" },
+                "replied": { "type": "integer" },
+                "marked": { "type": "integer" }
+              }
+            }
+          },
+          "espStats": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "esp": { "type": "string", "enum": ["GMAIL", "OUTLOOK", "OTHER"] },
+                "delivered": { "type": "integer" },
+                "landedSpam": { "type": "integer" },
+                "rescued": { "type": "integer" },
+                "overridden": { "type": "integer" }
+              }
+            }
+          }
+        },
+        "required": ["mailboxId", "windowDays", "today", "trailing", "delta", "daily", "espStats"]
+      },
+      "annotations": {
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": false
+      },
+      "_http": {
+        "method": "GET",
+        "path": "/api/v1/mailboxes/{id}/warmup"
+      }
+    },
+    {
+      "name": "list_labels",
+      "title": "List Mailbox Labels",
+      "description": "Lists all mailbox labels for the account along with each label's mailbox count. Labels group mailboxes (e.g. by client, by domain, by campaign theme) for filtering and warmup analytics.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": { "type": "string" },
+                "name": { "type": "string" },
+                "mailboxCount": { "type": "integer" },
+                "createdAt": { "type": "string", "format": "date-time" },
+                "updatedAt": { "type": "string", "format": "date-time" }
+              },
+              "required": ["id", "name", "mailboxCount", "createdAt", "updatedAt"]
+            }
+          }
+        },
+        "required": ["data"]
+      },
+      "annotations": {
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": false
+      },
+      "_http": {
+        "method": "GET",
+        "path": "/api/v1/labels"
+      }
+    },
+    {
+      "name": "create_label",
+      "title": "Create Mailbox Label",
+      "description": "Creates a new mailbox label. Label names must be unique per account (case-insensitive).",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 80,
+            "description": "Label name. Must be unique within the account."
+          }
+        },
+        "required": ["name"],
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "id": { "type": "string" },
+          "name": { "type": "string" },
+          "mailboxCount": { "type": "integer" },
+          "createdAt": { "type": "string", "format": "date-time" },
+          "updatedAt": { "type": "string", "format": "date-time" }
+        },
+        "required": ["id", "name", "createdAt", "updatedAt"]
+      },
+      "annotations": {
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "idempotentHint": false,
+        "openWorldHint": false
+      },
+      "_http": {
+        "method": "POST",
+        "path": "/api/v1/labels"
+      }
+    },
+    {
+      "name": "update_label",
+      "title": "Rename Mailbox Label",
+      "description": "Renames an existing mailbox label. Returns 409 if the new name collides with another label.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Label ID to rename."
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 80,
+            "description": "New label name."
+          }
+        },
+        "required": ["id", "name"],
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "id": { "type": "string" },
+          "name": { "type": "string" },
+          "mailboxCount": { "type": "integer" },
+          "createdAt": { "type": "string", "format": "date-time" },
+          "updatedAt": { "type": "string", "format": "date-time" }
+        },
+        "required": ["id", "name", "createdAt", "updatedAt"]
+      },
+      "annotations": {
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": false
+      },
+      "_http": {
+        "method": "PATCH",
+        "path": "/api/v1/labels/{id}"
+      }
+    },
+    {
+      "name": "delete_label",
+      "title": "Delete Mailbox Label",
+      "description": "Deletes a mailbox label. Mailboxes that were tagged with this label are unassigned (not deleted). Returns no body on success.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Label ID to delete."
+          }
+        },
+        "required": ["id"],
+        "additionalProperties": false
+      },
+      "annotations": {
+        "readOnlyHint": false,
+        "destructiveHint": true,
+        "idempotentHint": true,
+        "openWorldHint": false
+      },
+      "_http": {
+        "method": "DELETE",
+        "path": "/api/v1/labels/{id}"
+      }
+    },
+    {
+      "name": "get_label_warmup",
+      "title": "Get Label Warmup Analytics",
+      "description": "Returns aggregated warmup analytics for every mailbox inside a label: headline KPIs (inbox placement %, median score, bounce rate, 24h volume), red-flag alerts (no-sends, score drop, bounce spike, connection failures, seed degradation), daily counter rollup, per-ESP breakdown, sender-provider mix, and per-mailbox worklist for triage. Use this for fleet-level analysis.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Label ID."
+          },
+          "maturity": {
+            "type": "string",
+            "enum": ["all", "mature", "new", "seeds"],
+            "description": "Restrict the analytics population: `all` (default) includes every mailbox, `mature` only mailboxes warming for 14+ days, `new` mailboxes warming under 14 days, `seeds` only seed mailboxes."
+          },
+          "windowDays": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 90,
+            "description": "Trailing window in days for daily counters and scoring (default 30)."
+          }
+        },
+        "required": ["id"],
+        "additionalProperties": false
+      },
+      "annotations": {
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": false
+      },
+      "_http": {
+        "method": "GET",
+        "path": "/api/v1/labels/{id}/warmup"
+      }
+    },
     {
       "title": "List Events",
       "description": "Lists tracked email events (SENT, OPENED, CLICKED, REPLIED, BOUNCED, etc.) with optional filters. Supports cursor-based pagination.",

package/dist/tools.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.__internals=void 0,exports.registerTools=registerTools;const types_js_1=require("@modelcontextprotocol/sdk/types.js"),json_schema_to_zod_1=require("./json-schema-to-zod"),PLACEHOLDER_RE=/\{(\w+)\}/g;function pathParams(t){const n=[];for(const o of t.matchAll(PLACEHOLDER_RE)){const e=o[1];e&&n.push(e)}return n}function stringifyPathValue(t,n){if(typeof n=="string")return n;if(typeof n=="number"||typeof n=="boolean")return String(n);throw new Error(`Path parameter '${t}' must be a string, number, or boolean (got ${typeof n})`)}function interpolate(t,n){return t.replace(PLACEHOLDER_RE,(o,e)=>{const r=n[e];if(r==null)throw new Error(`Missing required path parameter '${e}'`);return encodeURIComponent(stringifyPathValue(e,r))})}function remainingArgs(t,n){const o={};for(const[e,r]of Object.entries(t))n.includes(e)||(o[e]=r);return o}function asQuery(t){return t}async function dispatch(t,n,o){const{method:e,path:r}=n._http,i=pathParams(r),s=interpolate(r,o),c=remainingArgs(o,i),u=Object.keys(c).length>0;switch(e){case"GET":return t.get(s,u?c:void 0);case"POST":return t.post(s,u?c:void 0);case"PATCH":return t.patch(s,u?c:void 0);case"DELETE":return await t.delete(s)??{ok:!0}}}function ok(t){return{content:[{type:"text",text:JSON.stringify(t,null,2)}]}}function fail(t){return{content:[{type:"text",text:t}],isError:!0}}function buildHandler(t,n){return async o=>{try{const e=await dispatch(t,n,o);return ok(e)}catch(e){const r=e instanceof Error?e.message:String(e);return fail(`Tool '${n.name}' failed: ${r}`)}}}function buildInputSchema(t){const n=(0,json_schema_to_zod_1.jsonSchemaToZod)(t.inputSchema);if(n._def?.typeName!=="ZodObject")throw new Error(`Tool '${t.name}' inputSchema must be a JSON-Schema object at the root`);return n}function registerTools(t,n,o){for(const e of o.tools){const r={description:e.description,inputSchema:buildInputSchema(e)};e.title&&(r.title=e.title),t.registerTool(e.name,r,buildHandler(n,e))}t.server.setRequestHandler(types_js_1.ListToolsRequestSchema,()=>({tools:o.tools.map(e=>{const{_http:r,...i}=e;return i})}))}exports.__internals={dispatch,pathParams,interpolate,remainingArgs};
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.__internals=void 0,exports.registerTools=registerTools;const types_js_1=require("@modelcontextprotocol/sdk/types.js"),json_schema_to_zod_1=require("./json-schema-to-zod"),PLACEHOLDER_RE=/\{(\w+)\}/g;function pathParams(t){const e=[];for(const o of t.matchAll(PLACEHOLDER_RE)){const n=o[1];n&&e.push(n)}return e}function stringifyPathValue(t,e){if(typeof e=="string")return e;if(typeof e=="number"||typeof e=="boolean")return String(e);throw new Error(`Path parameter '${t}' must be a string, number, or boolean (got ${typeof e})`)}function interpolate(t,e){return t.replace(PLACEHOLDER_RE,(o,n)=>{const r=e[n];if(r==null)throw new Error(`Missing required path parameter '${n}'`);return encodeURIComponent(stringifyPathValue(n,r))})}function remainingArgs(t,e){const o={};for(const[n,r]of Object.entries(t))e.includes(n)||(o[n]=r);return o}function asQuery(t){return t}async function dispatch(t,e,o){const{method:n,path:r}=e._http,s=pathParams(r),c=interpolate(r,o),u=remainingArgs(o,s),i=Object.keys(u).length>0;switch(n){case"GET":return t.get(c,i?u:void 0);case"POST":return t.post(c,i?u:void 0);case"PATCH":return t.patch(c,i?u:void 0);case"DELETE":return await t.delete(c)??{ok:!0}}}function ok(t){return{content:[{type:"text",text:JSON.stringify(t,null,2)}]}}function fail(t){return{content:[{type:"text",text:t}],isError:!0}}function isRecord(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}function toStructured(t,e){if(!t.outputSchema||!isRecord(e))return;const o=t.outputSchema.properties;if(isRecord(o)&&"data"in o){const{success:r,...s}=e;return s}return"data"in e&&isRecord(e.data)?e.data:e}function buildHandler(t,e){return async o=>{try{const n=await dispatch(t,e,o),r=toStructured(e,n),s=ok(r??n);return r!==void 0?{...s,structuredContent:r}:s}catch(n){const r=n instanceof Error?n.message:String(n);return fail(`Tool '${e.name}' failed: ${r}`)}}}function buildInputSchema(t){const e=(0,json_schema_to_zod_1.jsonSchemaToZod)(t.inputSchema);if(e._def?.typeName!=="ZodObject")throw new Error(`Tool '${t.name}' inputSchema must be a JSON-Schema object at the root`);return e}function registerTools(t,e,o){for(const n of o.tools){const r={description:n.description,inputSchema:buildInputSchema(n)};n.title&&(r.title=n.title),t.registerTool(n.name,r,buildHandler(e,n))}t.server.setRequestHandler(types_js_1.ListToolsRequestSchema,()=>({tools:o.tools.map(n=>{const{_http:r,...s}=n;return s})}))}exports.__internals={dispatch,pathParams,interpolate,remainingArgs,toStructured};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coldbirds/mcp-server",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "MCP server for ColdBirds Sequence — control campaigns, contacts, and mailboxes from AI assistants like Claude Desktop, Cursor, and Windsurf.",
   "keywords": [
     "coldbirds",