@tokenlabai/mcp-server 0.6.0 → 0.6.1

package/README.md

@@ -10,7 +10,7 @@ It exposes public catalog tools for agents that need to choose models, inspect s
 
 ## Generated Tool Profiles
 
-The checked-in `generated/tools.json` manifest is generated from TokenLab's public OpenAPI document plus the small MCP-only overlay in `contract/mcp-overlay.json`. Version 0.6.0 generates 76 endpoint tools; two composite discovery tools are registered at runtime.
+The checked-in `generated/tools.json` manifest is generated from TokenLab's public OpenAPI document plus the small MCP-only overlay in `contract/mcp-overlay.json`. Version 0.6.1 generates 76 endpoint tools; two composite discovery tools are registered at runtime.
 
 | Profile | Endpoint tools | Coverage |
 | --- | ---: | --- |
@@ -126,7 +126,7 @@ This repository includes `server.json` for the official MCP Registry.
 
 Release metadata:
 
-- npm package: `@tokenlabai/mcp-server@0.6.0`
+- npm package: `@tokenlabai/mcp-server@0.6.1`
 - MCP registry name: `io.github.hedging8563/tokenlab`
 - `package.json.mcpName`: `io.github.hedging8563/tokenlab`
 

package/contract/mcp-overlay.json

@@ -69,6 +69,19 @@
     "landing_url": "https://tokenlab.sh/mcp",
     "docs_url": "https://docs.tokenlab.sh/integrations/tokenlab-mcp-server",
     "recommended_client_name": "tokenlab",
+    "live_model_contract": {
+      "tool": "get_model",
+      "endpoint": "/v1/models/{model}",
+      "fields": [
+        "supported_operations",
+        "supported_parameters",
+        "request_endpoint",
+        "request_endpoint_by_operation",
+        "request_shape_mode",
+        "operation_constraints",
+        "recommended_request"
+      ]
+    },
     "composite_tools": [
       {
         "name": "compare_models",

package/contract/openapi.json

@@ -1714,7 +1714,7 @@
           "Models"
         ],
         "summary": "Get model",
-        "description": "Retrieves a model instance, providing basic information about the model.",
+        "description": "Retrieves current model details, including supported operations, request parameters, request endpoints, selector limits, and pricing when available. Non-chat integrations should read these current model-specific request details before creating a request.",
         "operationId": "getModel",
         "parameters": [
           {
@@ -7267,21 +7267,11 @@
           },
           "size": {
             "type": "string",
-            "default": "1024x1024",
-            "description": "Image size. For gpt-image-2, use auto or WIDTHxHEIGHT; custom dimensions must both be multiples of 16, longest edge <= 3840px, long/short ratio <= 3:1, and total pixels between 655,360 and 8,294,400."
+            "description": "Image size. Defaults are model-specific. For gpt-image-2, omit this field or use auto for automatic sizing, or send WIDTHxHEIGHT; custom dimensions must both be multiples of 16, longest edge <= 3840px, long/short ratio <= 3:1, and total pixels between 655,360 and 8,294,400."
           },
           "quality": {
             "type": "string",
-            "enum": [
-              "standard",
-              "hd",
-              "auto",
-              "low",
-              "medium",
-              "high"
-            ],
-            "default": "standard",
-            "description": "Image quality. GPT Image models such as gpt-image-2 use auto/low/medium/high. Other image families may use provider-specific values."
+            "description": "Image quality. Defaults and accepted values are model-specific. For gpt-image-2, omit this field or use auto for automatic quality, or send low, medium, or high. Other image families may use provider-specific values."
           },
           "style": {
             "type": "string",
@@ -11891,6 +11881,81 @@
         },
         "additionalProperties": false
       },
+      "NonChatOperationConstraint": {
+        "type": "object",
+        "properties": {
+          "operation": {
+            "type": "string"
+          },
+          "request_endpoint": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "request_shape_mode": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "status_mode": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "supported_parameters": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "required_selectors": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "optional_selectors": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "documented_inputs": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "allowed_resolutions": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "allowed_durations": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "allowed_aspect_ratios": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "notes": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "additionalProperties": false
+      },
       "NonChatRequestFormatSummary": {
         "type": [
           "object",
@@ -11909,6 +11974,54 @@
               "type": "string"
             }
           },
+          "feature_flags": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "boolean"
+            }
+          },
+          "output_formats": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "service_limits": {
+            "type": [
+              "object",
+              "null"
+            ],
+            "properties": {
+              "online_rpm": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "concurrency": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "offline_inference": {
+                "type": "boolean"
+              },
+              "offline_tpd": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "prompt_max_characters": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              }
+            },
+            "additionalProperties": false
+          },
           "required_selectors": {
             "type": "array",
             "items": {
@@ -11927,18 +12040,36 @@
               "type": "string"
             }
           },
+          "resolutions_label": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
           "durations": {
             "type": "array",
             "items": {
               "type": "string"
             }
           },
+          "durations_label": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
           "aspect_ratios": {
             "type": "array",
             "items": {
               "type": "string"
             }
           },
+          "aspect_ratios_label": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
           "request_endpoint": {
             "type": [
               "string",
@@ -11951,6 +12082,12 @@
               "null"
             ]
           },
+          "request_shape_mode": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
           "recommended_request_summary": {
             "type": [
               "object",
@@ -11966,6 +12103,12 @@
                 "null"
               ]
             }
+          },
+          "operation_constraints": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/NonChatOperationConstraint"
+            }
           }
         },
         "additionalProperties": true

package/generated/public-contract.json

@@ -5,7 +5,7 @@
     "id": "tokenlab-mcp-server",
     "name": "@tokenlabai/mcp-server",
     "title": "TokenLab MCP Server",
-    "version": "0.6.0",
+    "version": "0.6.1",
     "registry_name": "io.github.hedging8563/tokenlab",
     "source_url": "https://github.com/hedging8563/tokenlab-mcp-server",
     "landing_url": "https://tokenlab.sh/mcp",
@@ -25,8 +25,8 @@
     "openapi": "3.0.3",
     "title": "TokenLab AI Gateway",
     "version": "1.0.0",
-    "sha256": "586c32a9e47c4557977b92d73183518e986e70666f6530e2718ef5b7293a1706",
-    "tool_manifest_sha256": "e38134c2fa2489313f79dbefae73808ff8222d7009f1eb81c0c958f09d2c8677"
+    "sha256": "1b60d2976d994b4007a17984d9aa4ad4c11d791fb4e8096e1f86144bcee366f1",
+    "tool_manifest_sha256": "6647f8fbec7a80e4588640d9582a2931ba5fd675b3c01589ae6e833c0fdf6d69"
   },
   "profiles": {
     "catalog": {
@@ -242,6 +242,19 @@
   "features": {
     "structured_content": true,
     "tool_annotations": true,
+    "live_model_contract": {
+      "tool": "get_model",
+      "endpoint": "/v1/models/{model}",
+      "fields": [
+        "supported_operations",
+        "supported_parameters",
+        "request_endpoint",
+        "request_endpoint_by_operation",
+        "request_shape_mode",
+        "operation_constraints",
+        "recommended_request"
+      ]
+    },
     "composite_tools": [
       {
         "name": "compare_models",

package/generated/tools.json

@@ -6,7 +6,7 @@
     "openapi": "3.0.3",
     "title": "TokenLab AI Gateway",
     "version": "1.0.0",
-    "sha256": "586c32a9e47c4557977b92d73183518e986e70666f6530e2718ef5b7293a1706"
+    "sha256": "1b60d2976d994b4007a17984d9aa4ad4c11d791fb4e8096e1f86144bcee366f1"
   },
   "default_profile": "core",
   "profiles": [
@@ -2255,21 +2255,11 @@
           },
           "size": {
             "type": "string",
-            "default": "1024x1024",
-            "description": "Image size. For gpt-image-2, use auto or WIDTHxHEIGHT; custom dimensions must both be multiples of 16, longest edge <= 3840px, long/short ratio <= 3:1, and total pixels between 655,360 and 8,294,400."
+            "description": "Image size. Defaults are model-specific. For gpt-image-2, omit this field or use auto for automatic sizing, or send WIDTHxHEIGHT; custom dimensions must both be multiples of 16, longest edge <= 3840px, long/short ratio <= 3:1, and total pixels between 655,360 and 8,294,400."
           },
           "quality": {
             "type": "string",
-            "enum": [
-              "standard",
-              "hd",
-              "auto",
-              "low",
-              "medium",
-              "high"
-            ],
-            "default": "standard",
-            "description": "Image quality. GPT Image models such as gpt-image-2 use auto/low/medium/high. Other image families may use provider-specific values."
+            "description": "Image quality. Defaults and accepted values are model-specific. For gpt-image-2, omit this field or use auto for automatic quality, or send low, medium, or high. Other image families may use provider-specific values."
           },
           "style": {
             "type": "string",
@@ -5283,7 +5273,7 @@
         "core",
         "full"
       ],
-      "description": "Get model Retrieves a model instance, providing basic information about the model.",
+      "description": "Get model Retrieves current model details, including supported operations, request parameters, request endpoints, selector limits, and pricing when available. Non-chat integrations should read these current model-specific request details before creating a request.",
       "input_schema": {
         "type": "object",
         "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tokenlabai/mcp-server",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "OpenAPI-generated TokenLab MCP server with catalog, native AI, multimodal, resource, prompt, and async task support.",
   "type": "module",
   "engines": {
@@ -25,6 +25,7 @@
     "contract:generate": "node ./scripts/generate-contract.mjs",
     "contract:check": "node ./scripts/generate-contract.mjs --check",
     "contract:sync": "node ./scripts/sync-contract.mjs",
+    "version": "node ./scripts/sync-version.mjs && npm run contract:generate",
     "test": "node --check ./src/index.js && node --check ./scripts/generate-contract.mjs && npm run contract:check && node --test"
   },
   "keywords": [

package/scripts/generate-contract.mjs

@@ -314,6 +314,17 @@ for (const tool of compositeTools) {
   }
 }
 
+const liveModelContract = publicConfig.live_model_contract;
+if (!liveModelContract || liveModelContract.tool !== "get_model" || liveModelContract.endpoint !== "/v1/models/{model}") {
+  throw new Error("MCP public contract must use get_model as its live model-contract source");
+}
+if (!Array.isArray(liveModelContract.fields) || liveModelContract.fields.length === 0) {
+  throw new Error("MCP live model contract must list its public fields");
+}
+if (new Set(liveModelContract.fields).size !== liveModelContract.fields.length) {
+  throw new Error("MCP live model contract fields contain duplicates");
+}
+
 const profiles = Object.fromEntries(profileEntries.map(([profileName]) => {
   const endpointTools = tools.filter((tool) => tool.profiles.includes(profileName)).map((tool) => tool.name);
   const composite = compositeTools.filter((tool) => tool.profiles.includes(profileName)).map((tool) => tool.name);
@@ -373,6 +384,7 @@ const publicContract = {
   features: {
     structured_content: true,
     tool_annotations: true,
+    live_model_contract: liveModelContract,
     composite_tools: compositeTools,
     async_delivery_tools: tools.filter((tool) => tool.task).map((tool) => tool.name),
     resources: publicConfig.resources || [],

package/src/index.js

@@ -293,13 +293,21 @@ server.registerTool(
         executePublicJson(`/v1/models/${encoded}/pricing`).catch((error) => ({ error: error.message }))
       ]);
       if (include_raw) return { model, details, pricing };
+      const tokenlab = details?.tokenlab && typeof details.tokenlab === "object" ? details.tokenlab : {};
+      const requestContract = tokenlab.request_format_details
+        || tokenlab.request_format_summary
+        || tokenlab.public_contract
+        || tokenlab.public_contract_summary
+        || {};
       return {
         id: details.id || details.model || model,
-        request_endpoint: details.request_endpoint,
-        request_shape_mode: details.request_shape_mode,
-        supported_operations: details.supported_operations,
-        supported_parameters: details.supported_parameters,
-        recommended_request: details.recommended_request,
+        request_endpoint: requestContract.request_endpoint,
+        request_endpoint_by_operation: requestContract.request_endpoint_by_operation,
+        request_shape_mode: requestContract.request_shape_mode,
+        supported_operations: tokenlab.supported_operations || requestContract.public_operations,
+        supported_parameters: requestContract.supported_parameters,
+        operation_constraints: requestContract.operation_constraints,
+        recommended_request: requestContract.recommended_request || requestContract.recommended_request_summary,
         pricing
       };
     }));