@snokam/mcp-api 0.8.0 → 0.10.0

package/dist/index.js

@@ -9,7 +9,7 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { fetchSpecs } from "./openapi-loader.js";
+import { fetchSpecs, fetchSpecFromUrl, } from "./openapi-loader.js";
 import { getAccessToken } from "./auth.js";
 // ---------------------------------------------------------------------------
 // State
@@ -161,12 +161,9 @@ async function executeCall(endpoint, args) {
     const headers = {
         Accept: "application/json",
     };
-    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}`;
-        }
+    const token = await getAccessToken(endpoint.scope);
+    if (token) {
+        headers.Authorization = `Bearer ${token}`;
     }
     let fetchBody;
     if (args.body !== undefined && endpoint.method !== "GET") {
@@ -348,6 +345,39 @@ Controls: Sonos speakers, lights, YouTube queue
         if (name === SET_URL_TOOL_NAME) {
             const service = String(args.service ?? "");
             const url = String(args.url ?? "");
+            const isLocal = url.startsWith("http://localhost") ||
+                url.startsWith("http://127.0.0.1");
+            // For localhost URLs, fetch the live swagger spec from the local function
+            // to pick up any new/changed endpoints during development
+            if (isLocal) {
+                try {
+                    const liveEndpoints = await fetchSpecFromUrl(service, url);
+                    // Remove old endpoints for this service
+                    endpoints = endpoints.filter((ep) => ep.service !== service);
+                    // Add the fresh ones
+                    endpoints.push(...liveEndpoints);
+                    // Rebuild lookup map
+                    endpointsByTool = new Map();
+                    for (const ep of endpoints) {
+                        endpointsByTool.set(ep.toolName, ep);
+                    }
+                    serviceUrlOverrides.set(service, url);
+                    await server.sendToolListChanged();
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Overrode ${service} → ${url}. Loaded ${liveEndpoints.length} endpoints from local swagger.`,
+                            },
+                        ],
+                    };
+                }
+                catch (error) {
+                    // Fall through to static override if swagger fetch fails
+                    console.error(`[snokam-mcp] Failed to fetch swagger from ${url}, falling back to static spec:`, error instanceof Error ? error.message : error);
+                }
+            }
+            // Static override: just change the base URL on existing endpoints
             const serviceEndpoints = endpoints.filter((ep) => ep.service === service);
             if (serviceEndpoints.length === 0) {
                 const available = [
@@ -371,7 +401,7 @@ Controls: Sonos speakers, lights, YouTube queue
                 content: [
                     {
                         type: "text",
-                        text: `Overrode ${service} → ${url} (${serviceEndpoints.length} endpoints). Auth ${url.startsWith("http://localhost") || url.startsWith("http://127.0.0.1") ? "skipped" : "active"}.`,
+                        text: `Overrode ${service} → ${url} (${serviceEndpoints.length} endpoints).`,
                     },
                 ],
             };

package/dist/openapi-loader.d.ts

@@ -42,5 +42,10 @@ interface OpenApiRequestBody {
         schema?: Record<string, unknown>;
     }>;
 }
+/**
+ * Fetch a swagger spec from a specific URL (e.g. a locally running function)
+ * and return parsed endpoints for that service.
+ */
+export declare function fetchSpecFromUrl(service: string, baseUrl: string): Promise<ApiEndpoint[]>;
 export declare function fetchSpecs(environment: string): Promise<ApiEndpoint[]>;
 export {};

package/dist/openapi-loader.js

@@ -101,6 +101,21 @@ function parseSpec(spec, service, baseUrl) {
 // ---------------------------------------------------------------------------
 // Public API
 // ---------------------------------------------------------------------------
+/**
+ * Fetch a swagger spec from a specific URL (e.g. a locally running function)
+ * and return parsed endpoints for that service.
+ */
+export async function fetchSpecFromUrl(service, baseUrl) {
+    const swaggerUrl = `${baseUrl}/swagger.json`;
+    const response = await fetch(swaggerUrl, {
+        signal: AbortSignal.timeout(10_000),
+    });
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status} from ${swaggerUrl}`);
+    }
+    const spec = (await response.json());
+    return parseSpec(spec, service, baseUrl);
+}
 export async function fetchSpecs(environment) {
     // Try to load bundled specs first (for speed)
     try {

package/package.json

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

@@ -339,6 +339,9 @@
           "body": {
             "type": "string"
           },
+          "email": {
+            "type": "string"
+          },
           "tags": {
             "type": "array",
             "items": {

package/specs/test/notifications.json

@@ -339,6 +339,9 @@
           "body": {
             "type": "string"
           },
+          "email": {
+            "type": "string"
+          },
           "tags": {
             "type": "array",
             "items": {

package/specs/test/sync.json

@@ -0,0 +1,181 @@
+{
+  "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"
+            }
+          }
+        }
+      }
+    }
+  }
+}