@sezzlee/openapi-mcp 0.1.0 → 0.2.0

package/README.md

@@ -4,7 +4,7 @@ MCP server that exposes an OpenAPI (Swagger 2.0 / OpenAPI 3.0–3.2) document as
 search-first tool catalog — `search_tools`, `load_tool`, `invoke_tool` — over a **remote**
 backend, calling it with `fetch`.
 
-> Status: `0.1.0`, alpha. Install with `npm install -g @sezzlee/openapi-mcp` or run it with
+> Status: `0.2.0`, alpha. Install with `npm install -g @sezzlee/openapi-mcp` or run it with
 > `npx -y @sezzlee/openapi-mcp`; the binary is `sezzlee-openapi`.
 
 ## How this differs from the embedded SDKs

package/dist/server.js

@@ -1,6 +1,6 @@
 import { createRequire } from "node:module";
 import { McpServer } from "@modelcontextprotocol/server";
-import { assertCatalogValid, createDetail, defaultSearchLimit, emitGuarded, evaluateVisibility, invokeArgumentsDescription, invokeDescription, loadDescription, missingArgument, operationNameDescription, searchCatalog, searchDescription, searchDetailDescription, searchLimitDescription, searchQueryDescription, searchTagsDescription, textResult, unknownTool, wrongArgumentType, } from "@sezzlee/core";
+import { assertCatalogValid, checkPinnedVersion, createLoadedTool, defaultSearchLimit, emitGuarded, evaluateVisibility, invokeArgumentsDescription, invokeDescription, invokeVersionDescription, loadDescription, missingArgument, operationNameDescription, searchCatalog, searchDescription, searchDetailDescription, searchLimitDescription, searchQueryDescription, searchTagsDescription, textResult, unknownTool, wrongArgumentType, } from "@sezzlee/core";
 import { z } from "zod";
 import { invokeEntry } from "./invoke/invoke.js";
 const { version } = createRequire(import.meta.url)("../package.json");
@@ -79,7 +79,7 @@ export function createOpenApiMcpServer(gateway, fetcher, limits, options = {}) {
         if (entry === undefined || !visible(decision)) {
             return unknownTool(name);
         }
-        return textResult(createDetail(entry.tool, decision), false);
+        return textResult(createLoadedTool(entry.tool, decision), false);
     }));
     server.registerTool("invoke_tool", {
         description: invokeDescription,
@@ -90,9 +90,14 @@ export function createOpenApiMcpServer(gateway, fetcher, limits, options = {}) {
                 .unknown()
                 .optional()
                 .meta({ description: invokeArgumentsDescription }),
+            version: z.unknown().optional().meta({
+                type: "string",
+                description: invokeVersionDescription,
+                default: null,
+            }),
         })
             .meta({ required: ["name", "arguments"] }),
-    }, async ({ name, arguments: args }, ctx) => emitGuarded(budget, async () => {
+    }, async ({ name, arguments: args, version: pinned }, ctx) => emitGuarded(budget, async () => {
         if (name === undefined) {
             return missingArgument("invoke_tool", "name");
         }
@@ -104,6 +109,10 @@ export function createOpenApiMcpServer(gateway, fetcher, limits, options = {}) {
         if (entry === undefined) {
             return unknownTool(name);
         }
+        const stale = checkPinnedVersion(entry.tool, pinned);
+        if (stale !== undefined) {
+            return stale;
+        }
         const context = ctx;
         const exchanged = context?.http?.authInfo?.extra?.[exchangedTokenKey];
         return invokeEntry(entry, args, fetcher, limits, context?.mcpReq?.signal, typeof exchanged === "string" ? exchanged : undefined);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sezzlee/openapi-mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server that exposes an OpenAPI document as a search-first sezzlee catalog over a remote backend.",
   "keywords": [
     "mcp",
@@ -46,8 +46,8 @@
   "dependencies": {
     "@modelcontextprotocol/node": "^2.0.0",
     "@modelcontextprotocol/server": "^2.0.0",
-    "@sezzlee/core": "^0.1.0",
-    "@sezzlee/openapi": "^0.1.0",
+    "@sezzlee/core": "^0.2.0",
+    "@sezzlee/openapi": "^0.2.0",
     "zod": "^4.5.4"
   },
   "devDependencies": {