@snokam/mcp-api 0.6.0 → 0.8.0

package/dist/index.js

@@ -17,6 +17,7 @@ import { getAccessToken } from "./auth.js";
 let currentEnvironment = process.env.SNOKAM_ENVIRONMENT ?? "production";
 let endpoints = [];
 let endpointsByTool = new Map();
+const serviceUrlOverrides = new Map();
 async function loadEndpoints(environment) {
     currentEnvironment = environment;
     endpoints = await fetchSpecs(environment);
@@ -24,6 +25,16 @@ async function loadEndpoints(environment) {
     for (const ep of endpoints) {
         endpointsByTool.set(ep.toolName, ep);
     }
+    // Re-apply any active URL overrides
+    applyUrlOverrides();
+}
+function applyUrlOverrides() {
+    for (const ep of endpoints) {
+        const override = serviceUrlOverrides.get(ep.service);
+        if (override) {
+            ep.baseUrl = override;
+        }
+    }
 }
 // ---------------------------------------------------------------------------
 // Built-in tool: SwitchEnvironment
@@ -46,6 +57,42 @@ const switchToolDef = {
     },
 };
 // ---------------------------------------------------------------------------
+// Built-in tool: SetServiceUrl
+// ---------------------------------------------------------------------------
+const SET_URL_TOOL_NAME = "SetServiceUrl";
+const RESET_URL_TOOL_NAME = "ResetServiceUrl";
+const setUrlToolDef = {
+    name: SET_URL_TOOL_NAME,
+    description: "Override a service's base URL, e.g. to point to a locally running function. Auth is skipped for localhost URLs. Use ResetServiceUrl to revert.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            service: {
+                type: "string",
+                description: "The service name (e.g. employees, notifications, events)",
+            },
+            url: {
+                type: "string",
+                description: "The base URL to use (e.g. http://localhost:7071)",
+            },
+        },
+        required: ["service", "url"],
+    },
+};
+const resetUrlToolDef = {
+    name: RESET_URL_TOOL_NAME,
+    description: "Reset a service's base URL back to the environment default. Call without arguments to reset all overrides.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            service: {
+                type: "string",
+                description: "The service name to reset. Omit to reset all overrides.",
+            },
+        },
+    },
+};
+// ---------------------------------------------------------------------------
 // JSON Schema builder for tool inputs
 // ---------------------------------------------------------------------------
 function buildInputSchema(endpoint) {
@@ -114,9 +161,12 @@ async function executeCall(endpoint, args) {
     const headers = {
         Accept: "application/json",
     };
-    const token = await getAccessToken(endpoint.scope);
-    if (token) {
-        headers.Authorization = `Bearer ${token}`;
+    const isLocal = url.startsWith("http://localhost") || url.startsWith("http://127.0.0.1");
+    if (!isLocal) {
+        const token = await getAccessToken(endpoint.scope);
+        if (token) {
+            headers.Authorization = `Bearer ${token}`;
+        }
     }
     let fetchBody;
     if (args.body !== undefined && endpoint.method !== "GET") {
@@ -246,6 +296,8 @@ Controls: Sonos speakers, lights, YouTube queue
     server.setRequestHandler(ListToolsRequestSchema, async () => ({
         tools: [
             switchToolDef,
+            setUrlToolDef,
+            resetUrlToolDef,
             ...endpoints.map((ep) => ({
                 name: ep.toolName,
                 description: ep.description || ep.summary || `${ep.method} ${ep.path}`,
@@ -292,6 +344,56 @@ Controls: Sonos speakers, lights, YouTube queue
                 ],
             };
         }
+        // Handle SetServiceUrl
+        if (name === SET_URL_TOOL_NAME) {
+            const service = String(args.service ?? "");
+            const url = String(args.url ?? "");
+            const serviceEndpoints = endpoints.filter((ep) => ep.service === service);
+            if (serviceEndpoints.length === 0) {
+                const available = [
+                    ...new Set(endpoints.map((ep) => ep.service)),
+                ].sort();
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Unknown service: ${service}. Available: ${available.join(", ")}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            serviceUrlOverrides.set(service, url);
+            for (const ep of serviceEndpoints) {
+                ep.baseUrl = url;
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Overrode ${service} → ${url} (${serviceEndpoints.length} endpoints). Auth ${url.startsWith("http://localhost") || url.startsWith("http://127.0.0.1") ? "skipped" : "active"}.`,
+                    },
+                ],
+            };
+        }
+        // Handle ResetServiceUrl
+        if (name === RESET_URL_TOOL_NAME) {
+            const service = args.service ? String(args.service) : undefined;
+            if (service) {
+                serviceUrlOverrides.delete(service);
+            }
+            else {
+                serviceUrlOverrides.clear();
+            }
+            // Reload to restore original URLs
+            await loadEndpoints(currentEnvironment);
+            const msg = service
+                ? `Reset ${service} to environment default`
+                : `Reset all service URL overrides`;
+            return {
+                content: [{ type: "text", text: msg }],
+            };
+        }
         const endpoint = endpointsByTool.get(name);
         if (!endpoint) {
             return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snokam/mcp-api",
-  "version": "0.6.0",
+  "version": "0.8.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

@@ -11,6 +11,63 @@
     }
   ],
   "paths": {
+    "/v1.0/protected/push/register": {
+      "post": {
+        "tags": [
+          "Push"
+        ],
+        "summary": "Register device for push notifications",
+        "description": "Creates or updates a device installation in Azure Notification Hub",
+        "operationId": "RegisterDevice",
+        "requestBody": {
+          "description": "Device registration data",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/deviceInstallation"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Device registered successfully",
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://000b05c4-1c46-4ea7-bcf6-e8d17bc1838c/user_impersonation"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/push/register/{installationId}": {
+      "delete": {
+        "tags": [
+          "Push"
+        ],
+        "summary": "Unregister device from push notifications",
+        "description": "Removes a device installation from Azure Notification Hub",
+        "operationId": "UnregisterDevice",
+        "responses": {
+          "200": {
+            "description": "Device unregistered successfully",
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://000b05c4-1c46-4ea7-bcf6-e8d17bc1838c/user_impersonation"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/protected/slack": {
       "post": {
         "tags": [
@@ -113,6 +170,40 @@
         ]
       }
     },
+    "/v1.0/protected/push": {
+      "post": {
+        "tags": [
+          "Notifications"
+        ],
+        "summary": "Send push notification",
+        "description": "Queues a push notification for delivery",
+        "operationId": "SendPushNotification",
+        "requestBody": {
+          "description": "Push notification to send",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/sendPushRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Notification queued successfully",
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://000b05c4-1c46-4ea7-bcf6-e8d17bc1838c/user_impersonation"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/protected/notify": {
       "post": {
         "tags": [
@@ -150,6 +241,26 @@
   },
   "components": {
     "schemas": {
+      "deviceInstallation": {
+        "type": "object",
+        "properties": {
+          "installationId": {
+            "type": "string"
+          },
+          "platform": {
+            "type": "string"
+          },
+          "pushChannel": {
+            "type": "string"
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      },
       "sendEmailAttachmentRequest": {
         "type": "object",
         "properties": {
@@ -213,6 +324,32 @@
           },
           "email": {
             "$ref": "#/components/schemas/sendEmailRequest"
+          },
+          "push": {
+            "$ref": "#/components/schemas/sendPushRequest"
+          }
+        }
+      },
+      "sendPushRequest": {
+        "type": "object",
+        "properties": {
+          "title": {
+            "type": "string"
+          },
+          "body": {
+            "type": "string"
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "data": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            }
           }
         }
       },

package/specs/production/sanity.json

@@ -4581,6 +4581,41 @@
         "type": "object",
         "additionalProperties": true
       },
+      "RedemptionCodePoolStatus": {
+        "properties": {
+          "totalCodes": {
+            "type": "number",
+            "format": "double"
+          },
+          "availableCodes": {
+            "type": "number",
+            "format": "double"
+          },
+          "claimedCodes": {
+            "type": "number",
+            "format": "double"
+          }
+        },
+        "required": [
+          "totalCodes",
+          "availableCodes",
+          "claimedCodes"
+        ],
+        "type": "object",
+        "additionalProperties": true
+      },
+      "ClaimedRedemptionCode": {
+        "properties": {
+          "code": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "code"
+        ],
+        "type": "object",
+        "additionalProperties": true
+      },
       "MuxTrack": {
         "properties": {
           "max_height": {
@@ -24472,6 +24507,99 @@
         ]
       }
     },
+    "/v1.0/redemption-codes": {
+      "get": {
+        "operationId": "GetPoolStatus",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RedemptionCodePoolStatus"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "Redemption Codes"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://c03a7c58-49d5-4f50-aa43-ad00b22c6943/user_impersonation"
+            ]
+          }
+        ],
+        "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/redemption-codes/claim": {
+      "post": {
+        "operationId": "ClaimRedemptionCode",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ClaimedRedemptionCode"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "message"
+                  ],
+                  "type": "object"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "Redemption Codes"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://c03a7c58-49d5-4f50-aa43-ad00b22c6943/user_impersonation"
+            ]
+          }
+        ],
+        "parameters": []
+      }
+    },
     "/v1.0/quizes": {
       "get": {
         "operationId": "GetQuizes",

package/specs/test/notifications.json

@@ -11,6 +11,63 @@
     }
   ],
   "paths": {
+    "/v1.0/protected/push/register": {
+      "post": {
+        "tags": [
+          "Push"
+        ],
+        "summary": "Register device for push notifications",
+        "description": "Creates or updates a device installation in Azure Notification Hub",
+        "operationId": "RegisterDevice",
+        "requestBody": {
+          "description": "Device registration data",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/deviceInstallation"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Device registered successfully",
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://246713d5-cd48-4a00-84dd-7fc7ae290a62/user_impersonation"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/push/register/{installationId}": {
+      "delete": {
+        "tags": [
+          "Push"
+        ],
+        "summary": "Unregister device from push notifications",
+        "description": "Removes a device installation from Azure Notification Hub",
+        "operationId": "UnregisterDevice",
+        "responses": {
+          "200": {
+            "description": "Device unregistered successfully",
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://246713d5-cd48-4a00-84dd-7fc7ae290a62/user_impersonation"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/protected/slack": {
       "post": {
         "tags": [
@@ -113,6 +170,40 @@
         ]
       }
     },
+    "/v1.0/protected/push": {
+      "post": {
+        "tags": [
+          "Notifications"
+        ],
+        "summary": "Send push notification",
+        "description": "Queues a push notification for delivery",
+        "operationId": "SendPushNotification",
+        "requestBody": {
+          "description": "Push notification to send",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/sendPushRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Notification queued successfully",
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://246713d5-cd48-4a00-84dd-7fc7ae290a62/user_impersonation"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/protected/notify": {
       "post": {
         "tags": [
@@ -150,6 +241,26 @@
   },
   "components": {
     "schemas": {
+      "deviceInstallation": {
+        "type": "object",
+        "properties": {
+          "installationId": {
+            "type": "string"
+          },
+          "platform": {
+            "type": "string"
+          },
+          "pushChannel": {
+            "type": "string"
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      },
       "sendEmailAttachmentRequest": {
         "type": "object",
         "properties": {
@@ -213,6 +324,32 @@
           },
           "email": {
             "$ref": "#/components/schemas/sendEmailRequest"
+          },
+          "push": {
+            "$ref": "#/components/schemas/sendPushRequest"
+          }
+        }
+      },
+      "sendPushRequest": {
+        "type": "object",
+        "properties": {
+          "title": {
+            "type": "string"
+          },
+          "body": {
+            "type": "string"
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "data": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            }
           }
         }
       },

package/specs/test/sanity.json

@@ -4581,6 +4581,41 @@
         "type": "object",
         "additionalProperties": true
       },
+      "RedemptionCodePoolStatus": {
+        "properties": {
+          "totalCodes": {
+            "type": "number",
+            "format": "double"
+          },
+          "availableCodes": {
+            "type": "number",
+            "format": "double"
+          },
+          "claimedCodes": {
+            "type": "number",
+            "format": "double"
+          }
+        },
+        "required": [
+          "totalCodes",
+          "availableCodes",
+          "claimedCodes"
+        ],
+        "type": "object",
+        "additionalProperties": true
+      },
+      "ClaimedRedemptionCode": {
+        "properties": {
+          "code": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "code"
+        ],
+        "type": "object",
+        "additionalProperties": true
+      },
       "MuxTrack": {
         "properties": {
           "max_height": {
@@ -24472,6 +24507,99 @@
         ]
       }
     },
+    "/v1.0/redemption-codes": {
+      "get": {
+        "operationId": "GetPoolStatus",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RedemptionCodePoolStatus"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "Redemption Codes"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://59c81dff-a91a-4343-bbba-0c201c23db32/user_impersonation"
+            ]
+          }
+        ],
+        "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/redemption-codes/claim": {
+      "post": {
+        "operationId": "ClaimRedemptionCode",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ClaimedRedemptionCode"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "message"
+                  ],
+                  "type": "object"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "Redemption Codes"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://59c81dff-a91a-4343-bbba-0c201c23db32/user_impersonation"
+            ]
+          }
+        ],
+        "parameters": []
+      }
+    },
     "/v1.0/quizes": {
       "get": {
         "operationId": "GetQuizes",

package/specs/test/sync.json

@@ -1,181 +0,0 @@
-{
-  "openapi": "3.0.1",
-  "info": {
-    "title": "Sync Function",
-    "description": "Sync data from one system to another, e.g CvPartner to Sanity",
-    "version": "v1.0.0"
-  },
-  "servers": [
-    {
-      "url": "https://sync.api.test.snokam.no"
-    }
-  ],
-  "paths": {
-    "/v1.0/azure-ad-to-sanity": {
-      "get": {
-        "tags": [
-          "Sync"
-        ],
-        "summary": "Syncs Azure AD to Sanity",
-        "description": "Synchronizes data from Azure AD to Sanity.",
-        "operationId": "SyncAzureAdToSanity",
-        "responses": {
-          "200": {
-            "description": "Data synchronized successfully",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "string"
-                }
-              }
-            },
-            "x-ms-summary": "Success"
-          },
-          "401": {
-            "description": "Unauthorized access",
-            "x-ms-summary": "Unauthorized"
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://2d964377-8322-482d-bd45-3134b48a9da5/user_impersonation"
-            ]
-          }
-        ]
-      }
-    },
-    "/v1.0/cv-partner-to-sanity": {
-      "get": {
-        "tags": [
-          "Sync"
-        ],
-        "summary": "Syncs CV Partner to Sanity",
-        "description": "Synchronizes data from CV Partner to Sanity.",
-        "operationId": "SyncCvPartnerToSanity",
-        "responses": {
-          "200": {
-            "description": "Data synchronized successfully",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "string"
-                }
-              }
-            },
-            "x-ms-summary": "Success"
-          },
-          "401": {
-            "description": "Unauthorized access",
-            "x-ms-summary": "Unauthorized"
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://2d964377-8322-482d-bd45-3134b48a9da5/user_impersonation"
-            ]
-          }
-        ]
-      }
-    },
-    "/v1.0/power-office-to-sanity": {
-      "get": {
-        "tags": [
-          "Sync"
-        ],
-        "summary": "Sync power office data to sanity",
-        "description": "Sync power office data to sanity",
-        "operationId": "SyncPowerOfficeToSanity",
-        "parameters": [
-          {
-            "name": "from",
-            "in": "query",
-            "description": "",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "date-time"
-            },
-            "x-ms-summary": "Date from"
-          },
-          {
-            "name": "to",
-            "in": "query",
-            "description": "",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "date-time"
-            },
-            "x-ms-summary": "Date to"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Data synchronized successfully",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "string"
-                }
-              }
-            },
-            "x-ms-summary": "Success"
-          },
-          "401": {
-            "description": "Unauthorized access",
-            "x-ms-summary": "Unauthorized"
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://2d964377-8322-482d-bd45-3134b48a9da5/user_impersonation"
-            ]
-          }
-        ]
-      }
-    },
-    "/v1.0/okrs-to-sanity": {
-      "get": {
-        "tags": [
-          "Sync"
-        ],
-        "summary": "Sync OKRs",
-        "description": "Synchronizes OKRs",
-        "operationId": "SyncOkrs",
-        "responses": {
-          "200": {
-            "description": "OKRs synchronized successfully",
-            "x-ms-summary": "Success"
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://2d964377-8322-482d-bd45-3134b48a9da5/user_impersonation"
-            ]
-          }
-        ]
-      }
-    }
-  },
-  "components": {
-    "securitySchemes": {
-      "Implicit": {
-        "type": "oauth2",
-        "flows": {
-          "implicit": {
-            "authorizationUrl": "https://login.microsoftonline.com/a8533784-aa3c-403b-a61a-1533ecc6e3ed/oauth2/v2.0/authorize",
-            "tokenUrl": "https://login.microsoftonline.com/a8533784-aa3c-403b-a61a-1533ecc6e3ed/oauth2/v2.0/token",
-            "refreshUrl": "https://login.microsoftonline.com/a8533784-aa3c-403b-a61a-1533ecc6e3ed/oauth2/v2.0/token",
-            "scopes": {
-              "api://2d964377-8322-482d-bd45-3134b48a9da5/user_impersonation": "Default function scope"
-            }
-          }
-        }
-      }
-    }
-  }
-}