@coldbirds/mcp-server 1.0.2 → 1.0.5

package/dist/mcp.fallback.json

@@ -24,6 +24,84 @@
     }
   },
   "tools": [
+    {
+      "name": "get_dashboard",
+      "title": "Get Dashboard",
+      "description": "Returns the high-level account dashboard: active campaign count, sends today, 7-day open/reply/bounce rates, a 14-day daily-send series, and the top 5 campaigns by sent volume. Use this for 'how is my outreach doing?' style questions.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "timezone": {
+            "type": "string",
+            "description": "IANA timezone (e.g. America/New_York) used to compute the 'sends today' boundary. Defaults to the account's preference, or UTC."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "activeCampaigns": { "type": "integer", "description": "Campaigns currently in ACTIVE status." },
+          "sendsToday": { "type": "integer", "description": "Emails sent since local midnight." },
+          "sentLast7d": { "type": "integer" },
+          "repliedLast7d": { "type": "integer", "description": "Distinct send jobs with at least one reply (last 7d)." },
+          "openedLast7d": { "type": "integer", "description": "Distinct send jobs with at least one open (last 7d)." },
+          "bouncedLast7d": { "type": "integer" },
+          "replyRate": { "type": "number", "description": "repliedLast7d / sentLast7d (0..1)." },
+          "openRate": { "type": "number", "description": "openedLast7d / sentLast7d (0..1)." },
+          "dailySends": {
+            "type": "array",
+            "description": "14 daily buckets, oldest first.",
+            "items": {
+              "type": "object",
+              "properties": {
+                "date": { "type": "string", "description": "UTC YYYY-MM-DD." },
+                "sent": { "type": "integer" },
+                "replied": { "type": "integer" }
+              },
+              "required": ["date", "sent", "replied"]
+            }
+          },
+          "topCampaigns": {
+            "type": "array",
+            "description": "Up to 5 campaigns ranked by sent volume in the last 7d.",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": { "type": "string" },
+                "name": { "type": "string" },
+                "sent": { "type": "integer" },
+                "opened": { "type": "integer" },
+                "replied": { "type": "integer" }
+              },
+              "required": ["id", "name", "sent", "opened", "replied"]
+            }
+          }
+        },
+        "required": [
+          "activeCampaigns",
+          "sendsToday",
+          "sentLast7d",
+          "repliedLast7d",
+          "openedLast7d",
+          "bouncedLast7d",
+          "replyRate",
+          "openRate",
+          "dailySends",
+          "topCampaigns"
+        ]
+      },
+      "annotations": {
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": false
+      },
+      "_http": {
+        "method": "GET",
+        "path": "/api/v1/dashboard"
+      }
+    },
     {
       "name": "get_account",
       "title": "Get Account",
@@ -1269,9 +1347,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 +1411,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 +1844,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coldbirds/mcp-server",
-  "version": "1.0.2",
+  "version": "1.0.5",
   "description": "MCP server for ColdBirds Sequence — control campaigns, contacts, and mailboxes from AI assistants like Claude Desktop, Cursor, and Windsurf.",
   "keywords": [
     "coldbirds",
@@ -37,7 +37,11 @@
     "lint": "eslint src",
     "test": "jest --config jest.config.cjs",
     "test:coverage": "jest --config jest.config.cjs --coverage",
-    "prepublishOnly": "npm run build && npm run lint && npm test"
+    "prepublishOnly": "npm run build && npm run lint && npm test",
+    "release:patch": "npm version patch --no-git-tag-version && npm run release:tag",
+    "release:minor": "npm version minor --no-git-tag-version && npm run release:tag",
+    "release:major": "npm version major --no-git-tag-version && npm run release:tag",
+    "release:tag": "bash scripts/release-tag.sh"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",