@snokam/mcp-api 2.40.0 → 2.43.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snokam/mcp-api",
-  "version": "2.40.0",
+  "version": "2.43.0",
   "description": "MCP server exposing Snokam backend APIs as tools for Claude Code and other MCP clients",
   "type": "module",
   "bin": {

package/specs/production/notifications.json

@@ -17,7 +17,7 @@
           "Notifications"
         ],
         "summary": "Trigger newsletter summarizer",
-        "description": "Manually runs the weekly knowledge-summarizer cron (iterates active newsletterSeries, posts Olaf's summary to the configured Slack channel per series, and — if NEWSLETTER_SEND_EMAILS=true — emails subscribers).",
+        "description": "Manually runs the weekly knowledge-summarizer cron (iterates active newsletterSeries, posts Olaf's summary to the configured Slack channel per series, and emails subscribers for series with sendEmails=true).",
         "operationId": "TriggerKnowledgeSummarizer",
         "responses": {
           "200": {

package/specs/production/sanity.json

@@ -19879,6 +19879,9 @@
                 "slackChannel": {
                   "type": "string"
                 },
+                "sendEmails": {
+                  "type": "boolean"
+                },
                 "active": {
                   "type": "boolean"
                 },
@@ -19902,6 +19905,7 @@
               "required": [
                 "tag",
                 "slackChannel",
+                "sendEmails",
                 "active",
                 "topic",
                 "name",
@@ -19994,6 +19998,9 @@
               "slackChannel": {
                 "type": "string"
               },
+              "sendEmails": {
+                "type": "boolean"
+              },
               "active": {
                 "type": "boolean"
               },
@@ -20017,6 +20024,7 @@
             "required": [
               "tag",
               "slackChannel",
+              "sendEmails",
               "active",
               "topic",
               "name",
@@ -20201,6 +20209,9 @@
             "slackChannel": {
               "type": "string"
             },
+            "sendEmails": {
+              "type": "boolean"
+            },
             "active": {
               "type": "boolean"
             },
@@ -20224,6 +20235,7 @@
           "required": [
             "tag",
             "slackChannel",
+            "sendEmails",
             "active",
             "topic",
             "name",
@@ -20266,6 +20278,9 @@
           "slackChannel": {
             "type": "string"
           },
+          "sendEmails": {
+            "type": "boolean"
+          },
           "active": {
             "type": "boolean"
           },
@@ -20289,6 +20304,7 @@
         "required": [
           "tag",
           "slackChannel",
+          "sendEmails",
           "active",
           "topic",
           "name",
@@ -49854,6 +49870,7 @@
             }
           }
         },
+        "description": "Returns the published article list.\n\n`includeInactive=true` drops the `active == true` filter so\nadmins can see articles they've taken offline (\"Ikke live\").\nCallers decide whether to request it based on the viewer's\nsession — the public blog route leaves it false, admin routes\npass true.",
         "tags": [
           "Articles"
         ],
@@ -49882,6 +49899,15 @@
               "default": false,
               "type": "boolean"
             }
+          },
+          {
+            "in": "query",
+            "name": "includeInactive",
+            "required": false,
+            "schema": {
+              "default": false,
+              "type": "boolean"
+            }
           }
         ]
       }
@@ -49936,6 +49962,7 @@
             }
           }
         },
+        "description": "Single published article by slug or id.\n\n`includeInactive=true` removes the `active == true` requirement\nfrom the slug-match path so admins can open \"Ikke live\"\narticles by URL. Without it, slug lookups only return live\narticles (public behaviour). Id lookups are unaffected either\nway — if the caller already knows the sanity id, active is\nimmaterial.",
         "tags": [
           "Articles"
         ],
@@ -49972,6 +49999,15 @@
               "default": false,
               "type": "boolean"
             }
+          },
+          {
+            "in": "query",
+            "name": "includeInactive",
+            "required": false,
+            "schema": {
+              "default": false,
+              "type": "boolean"
+            }
           }
         ]
       },
@@ -50021,6 +50057,54 @@
         }
       }
     },
+    "/v1.0/articles/all": {
+      "get": {
+        "operationId": "GetAllPublishedArticles",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetArticlesResult"
+                }
+              }
+            }
+          }
+        },
+        "description": "Every published article regardless of the `active` flag. Used by\nthe admin list so editors can see articles they've taken offline\n(\"Ikke live\"). Public callers should stay on `GetArticles`,\nwhich filters to `active == true`.",
+        "tags": [
+          "Articles"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://3358ac8e-681e-4aeb-bfbf-bb008913c423/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "query",
+            "name": "useCache",
+            "required": false,
+            "schema": {
+              "default": false,
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "useCdn",
+            "required": false,
+            "schema": {
+              "default": false,
+              "type": "boolean"
+            }
+          }
+        ]
+      }
+    },
     "/v1.0/articles/drafts": {
       "get": {
         "operationId": "GetDraftOnlyArticles",

package/specs/test/notifications.json

@@ -17,7 +17,7 @@
           "Notifications"
         ],
         "summary": "Trigger newsletter summarizer",
-        "description": "Manually runs the weekly knowledge-summarizer cron (iterates active newsletterSeries, posts Olaf's summary to the configured Slack channel per series, and — if NEWSLETTER_SEND_EMAILS=true — emails subscribers).",
+        "description": "Manually runs the weekly knowledge-summarizer cron (iterates active newsletterSeries, posts Olaf's summary to the configured Slack channel per series, and emails subscribers for series with sendEmails=true).",
         "operationId": "TriggerKnowledgeSummarizer",
         "responses": {
           "200": {

package/specs/test/sanity.json

@@ -19879,6 +19879,9 @@
                 "slackChannel": {
                   "type": "string"
                 },
+                "sendEmails": {
+                  "type": "boolean"
+                },
                 "active": {
                   "type": "boolean"
                 },
@@ -19902,6 +19905,7 @@
               "required": [
                 "tag",
                 "slackChannel",
+                "sendEmails",
                 "active",
                 "topic",
                 "name",
@@ -19994,6 +19998,9 @@
               "slackChannel": {
                 "type": "string"
               },
+              "sendEmails": {
+                "type": "boolean"
+              },
               "active": {
                 "type": "boolean"
               },
@@ -20017,6 +20024,7 @@
             "required": [
               "tag",
               "slackChannel",
+              "sendEmails",
               "active",
               "topic",
               "name",
@@ -20201,6 +20209,9 @@
             "slackChannel": {
               "type": "string"
             },
+            "sendEmails": {
+              "type": "boolean"
+            },
             "active": {
               "type": "boolean"
             },
@@ -20224,6 +20235,7 @@
           "required": [
             "tag",
             "slackChannel",
+            "sendEmails",
             "active",
             "topic",
             "name",
@@ -20266,6 +20278,9 @@
           "slackChannel": {
             "type": "string"
           },
+          "sendEmails": {
+            "type": "boolean"
+          },
           "active": {
             "type": "boolean"
           },
@@ -20289,6 +20304,7 @@
         "required": [
           "tag",
           "slackChannel",
+          "sendEmails",
           "active",
           "topic",
           "name",
@@ -49854,6 +49870,7 @@
             }
           }
         },
+        "description": "Returns the published article list.\n\n`includeInactive=true` drops the `active == true` filter so\nadmins can see articles they've taken offline (\"Ikke live\").\nCallers decide whether to request it based on the viewer's\nsession — the public blog route leaves it false, admin routes\npass true.",
         "tags": [
           "Articles"
         ],
@@ -49882,6 +49899,15 @@
               "default": false,
               "type": "boolean"
             }
+          },
+          {
+            "in": "query",
+            "name": "includeInactive",
+            "required": false,
+            "schema": {
+              "default": false,
+              "type": "boolean"
+            }
           }
         ]
       }
@@ -49936,6 +49962,7 @@
             }
           }
         },
+        "description": "Single published article by slug or id.\n\n`includeInactive=true` removes the `active == true` requirement\nfrom the slug-match path so admins can open \"Ikke live\"\narticles by URL. Without it, slug lookups only return live\narticles (public behaviour). Id lookups are unaffected either\nway — if the caller already knows the sanity id, active is\nimmaterial.",
         "tags": [
           "Articles"
         ],
@@ -49972,6 +49999,15 @@
               "default": false,
               "type": "boolean"
             }
+          },
+          {
+            "in": "query",
+            "name": "includeInactive",
+            "required": false,
+            "schema": {
+              "default": false,
+              "type": "boolean"
+            }
           }
         ]
       },
@@ -50021,6 +50057,54 @@
         }
       }
     },
+    "/v1.0/articles/all": {
+      "get": {
+        "operationId": "GetAllPublishedArticles",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetArticlesResult"
+                }
+              }
+            }
+          }
+        },
+        "description": "Every published article regardless of the `active` flag. Used by\nthe admin list so editors can see articles they've taken offline\n(\"Ikke live\"). Public callers should stay on `GetArticles`,\nwhich filters to `active == true`.",
+        "tags": [
+          "Articles"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "query",
+            "name": "useCache",
+            "required": false,
+            "schema": {
+              "default": false,
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "useCdn",
+            "required": false,
+            "schema": {
+              "default": false,
+              "type": "boolean"
+            }
+          }
+        ]
+      }
+    },
     "/v1.0/articles/drafts": {
       "get": {
         "operationId": "GetDraftOnlyArticles",