@tokenlabai/mcp-server 0.5.0 → 0.6.0

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.5.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.0 generates 76 endpoint tools; two composite discovery tools are registered at runtime.
 
 | Profile | Endpoint tools | Coverage |
 | --- | ---: | --- |
@@ -126,14 +126,14 @@ This repository includes `server.json` for the official MCP Registry.
 
 Release metadata:
 
-- npm package: `@tokenlabai/mcp-server@0.5.0`
+- npm package: `@tokenlabai/mcp-server@0.6.0`
 - MCP registry name: `io.github.hedging8563/tokenlab`
 - `package.json.mcpName`: `io.github.hedging8563/tokenlab`
 
 For a new release:
 
 1. Bump the matching versions in `package.json`, `package-lock.json`, and `server.json`.
-2. Push a matching tag such as `v0.5.0`.
+2. Push a matching tag such as `v0.6.0`.
 3. The publish workflow tests and publishes npm through trusted publishing, then publishes the MCP Registry entry through GitHub Actions OIDC.
 
 The same workflow can be run manually from `main` to republish only the current MCP Registry metadata. No npm or MCP Registry token is stored in GitHub.

package/contract/mcp-overlay.json

@@ -162,6 +162,16 @@
     "getPricing"
   ],
   "operation_overrides": {
+    "listModels": {
+      "default_arguments": {
+        "view": "compact"
+      },
+      "input_property_overrides": {
+        "view": {
+          "description": "Compact model-selection output is the MCP default. Set view to full only when the complete OpenAI-compatible list shape is required."
+        }
+      }
+    },
     "cancelAnthropicMessageBatch": {
       "annotations": {
         "readOnlyHint": false,

package/contract/openapi.json

@@ -1597,22 +1597,111 @@
           "Models"
         ],
         "summary": "List models",
-        "description": "Lists the currently available models. Default responses are trimmed for discovery. Non-chat models may include lightweight request-format metadata; `agent_preferences` appears only when `recommended_for` is present. Deprecated `lemondata` is still returned as a compatibility alias during the migration.",
+        "description": "Lists the currently available models. Use `view=compact` for model selection and `view=full` for the existing OpenAI-compatible discovery shape. Native API calls default to `full`; integrations may choose `compact` as their default. Non-chat recommendations are available through `recommended_for`.",
         "operationId": "listModels",
+        "parameters": [
+          {
+            "name": "provider",
+            "in": "query",
+            "required": false,
+            "description": "Filter by public model provider, for example openai, anthropic, google, or minimax.",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "tag",
+            "in": "query",
+            "required": false,
+            "description": "Filter by a public capability tag.",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "category",
+            "in": "query",
+            "required": false,
+            "description": "Filter by model category.",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "chat",
+                "embedding",
+                "translation",
+                "image",
+                "video",
+                "audio",
+                "tts",
+                "stt",
+                "rerank",
+                "3d",
+                "music"
+              ]
+            }
+          },
+          {
+            "name": "recommended_for",
+            "in": "query",
+            "required": false,
+            "description": "Sort supported non-chat models for a task category and include recommendation evidence.",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "image",
+                "video",
+                "music",
+                "3d",
+                "tts",
+                "stt",
+                "embedding",
+                "rerank",
+                "translation"
+              ]
+            }
+          },
+          {
+            "name": "view",
+            "in": "query",
+            "required": false,
+            "description": "Choose compact model-selection fields or the full OpenAI-compatible list shape.",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "compact",
+                "full"
+              ],
+              "default": "full"
+            }
+          }
+        ],
         "responses": {
           "200": {
             "description": "List of models",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/ModelsResponse"
+                  "oneOf": [
+                    {
+                      "$ref": "#/components/schemas/ModelsResponse"
+                    },
+                    {
+                      "$ref": "#/components/schemas/CompactModelsResponse"
+                    }
+                  ]
                 }
               }
             }
           },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "429": {
+            "$ref": "#/components/responses/RateLimitExceeded"
+          },
           "500": {
             "$ref": "#/components/responses/ServerError"
           }
@@ -8356,7 +8445,180 @@
         "required": [
           "object",
           "data"
-        ]
+        ],
+        "additionalProperties": false
+      },
+      "CompactModelsResponse": {
+        "type": "object",
+        "description": "Compact model-selection response used by TokenLab MCP and other agent integrations.",
+        "properties": {
+          "object": {
+            "type": "string",
+            "enum": [
+              "list"
+            ]
+          },
+          "view": {
+            "type": "string",
+            "enum": [
+              "compact"
+            ]
+          },
+          "count": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "data": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/CompactModelListItem"
+            }
+          }
+        },
+        "required": [
+          "object",
+          "view",
+          "count",
+          "data"
+        ],
+        "additionalProperties": false
+      },
+      "CompactModelListItem": {
+        "type": "object",
+        "description": "Fields needed to shortlist a model before calling get_model or get_model_pricing.",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Model identifier"
+          },
+          "provider": {
+            "type": "string",
+            "description": "Public model provider"
+          },
+          "category": {
+            "type": "string"
+          },
+          "capabilities": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "max_input_tokens": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "max_output_tokens": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "pricing": {
+            "type": "object",
+            "properties": {
+              "unit": {
+                "type": "string"
+              },
+              "currency": {
+                "type": "string",
+                "enum": [
+                  "USD"
+                ]
+              },
+              "input_per_1m": {
+                "type": "string"
+              },
+              "output_per_1m": {
+                "type": "string"
+              },
+              "per_request": {
+                "type": "string"
+              },
+              "min_price": {
+                "type": "string",
+                "description": "Minimum TokenLab price for a structured pricing model."
+              },
+              "max_price": {
+                "type": "string",
+                "description": "Maximum TokenLab price for a structured pricing model."
+              },
+              "has_complex_pricing": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "unit",
+              "currency",
+              "has_complex_pricing"
+            ],
+            "additionalProperties": false
+          },
+          "status": {
+            "type": "string",
+            "description": "Public model lifecycle stage."
+          },
+          "latest": {
+            "type": "boolean"
+          },
+          "supported_operations": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "request_endpoint": {
+            "type": "string"
+          },
+          "recommendation": {
+            "type": "object",
+            "properties": {
+              "preferred_rank": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "success_rate_24h": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "sample_count_24h": {
+                "type": "integer"
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "ready",
+                  "insufficient_samples"
+                ]
+              }
+            },
+            "required": [
+              "preferred_rank",
+              "success_rate_24h",
+              "sample_count_24h",
+              "status"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "required": [
+          "id",
+          "provider",
+          "category",
+          "capabilities",
+          "max_input_tokens",
+          "max_output_tokens",
+          "pricing",
+          "status",
+          "latest"
+        ],
+        "additionalProperties": false
       },
       "Model": {
         "type": "object",
@@ -8383,15 +8645,6 @@
           },
           "tokenlab": {
             "$ref": "#/components/schemas/ModelTokenLabExtension"
-          },
-          "lemondata": {
-            "allOf": [
-              {
-                "$ref": "#/components/schemas/ModelLemondataExtension"
-              }
-            ],
-            "deprecated": true,
-            "description": "Deprecated alias for tokenlab. Retained for compatibility during the TokenLab migration."
           }
         },
         "required": [
@@ -9857,87 +10110,6 @@
           }
         }
       },
-      "ModelListLemondataExtension": {
-        "type": "object",
-        "description": "TokenLab discovery fields for the list route. Detail-only metadata such as capability flags, pricing provenance, full model details, and empty recommendation snapshots are omitted.",
-        "properties": {
-          "aliases": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            }
-          },
-          "pricing": {
-            "type": "object",
-            "additionalProperties": true
-          },
-          "capabilities": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            }
-          },
-          "providers": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            }
-          },
-          "max_input_tokens": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "max_output_tokens": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "category": {
-            "type": "string"
-          },
-          "pricing_unit": {
-            "type": "string"
-          },
-          "cache_pricing": {
-            "type": [
-              "object",
-              "null"
-            ],
-            "additionalProperties": true
-          },
-          "has_complex_pricing": {
-            "type": "boolean"
-          },
-          "pricing_summary": {
-            "type": [
-              "object",
-              "null"
-            ],
-            "additionalProperties": true
-          },
-          "agent_preferences": {
-            "type": "object",
-            "additionalProperties": true
-          },
-          "request_format_summary": {
-            "$ref": "#/components/schemas/ModelListRequestFormatSummary"
-          }
-        },
-        "required": [
-          "aliases",
-          "pricing",
-          "capabilities",
-          "max_input_tokens",
-          "max_output_tokens",
-          "category",
-          "pricing_unit",
-          "has_complex_pricing"
-        ],
-        "additionalProperties": false
-      },
       "ModelListItem": {
         "type": "object",
         "properties": {
@@ -9961,15 +10133,6 @@
             "description": "Model provider",
             "example": "openai"
           },
-          "lemondata": {
-            "allOf": [
-              {
-                "$ref": "#/components/schemas/ModelListLemondataExtension"
-              }
-            ],
-            "deprecated": true,
-            "description": "Deprecated alias for tokenlab. Retained for compatibility during the TokenLab migration."
-          },
           "tokenlab": {
             "$ref": "#/components/schemas/ModelListTokenLabExtension"
           }
@@ -9983,89 +10146,6 @@
         ],
         "additionalProperties": false
       },
-      "ModelLemondataExtension": {
-        "type": "object",
-        "description": "TokenLab extension fields for the detail route, including pricing, capabilities, recommendation metadata, and detailed non-chat request metadata.",
-        "properties": {
-          "aliases": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            }
-          },
-          "pricing": {
-            "type": "object",
-            "additionalProperties": true
-          },
-          "capabilities": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            }
-          },
-          "providers": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            }
-          },
-          "max_input_tokens": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "max_output_tokens": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "category": {
-            "type": "string"
-          },
-          "pricing_unit": {
-            "type": "string"
-          },
-          "cache_pricing": {
-            "type": [
-              "object",
-              "null"
-            ],
-            "additionalProperties": true
-          },
-          "has_complex_pricing": {
-            "type": "boolean"
-          },
-          "supported_operations": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            }
-          },
-          "pricing_summary": {
-            "type": [
-              "object",
-              "null"
-            ],
-            "additionalProperties": true
-          },
-          "pricing_provenance": {
-            "type": [
-              "object",
-              "null"
-            ],
-            "additionalProperties": true
-          },
-          "request_format_summary": {
-            "$ref": "#/components/schemas/NonChatRequestFormatSummary"
-          },
-          "request_format_details": {
-            "$ref": "#/components/schemas/NonChatRequestFormatDetails"
-          }
-        },
-        "additionalProperties": true
-      },
       "ModelPricingResponse": {
         "type": "object",
         "properties": {

package/generated/public-contract.json

@@ -5,7 +5,7 @@
     "id": "tokenlab-mcp-server",
     "name": "@tokenlabai/mcp-server",
     "title": "TokenLab MCP Server",
-    "version": "0.5.0",
+    "version": "0.6.0",
     "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": "f494fcfb2b4d67aaddc88a2ec164739c807bb59331a7e5270fd9d9fa282745e0",
-    "tool_manifest_sha256": "a2690dd92f5e7dbc47ce4fe25b327eaafd4848224f0e329bee0f1c2797c4521d"
+    "sha256": "586c32a9e47c4557977b92d73183518e986e70666f6530e2718ef5b7293a1706",
+    "tool_manifest_sha256": "e38134c2fa2489313f79dbefae73808ff8222d7009f1eb81c0c958f09d2c8677"
   },
   "profiles": {
     "catalog": {

package/generated/tools.json

@@ -6,7 +6,7 @@
     "openapi": "3.0.3",
     "title": "TokenLab AI Gateway",
     "version": "1.0.0",
-    "sha256": "f494fcfb2b4d67aaddc88a2ec164739c807bb59331a7e5270fd9d9fa282745e0"
+    "sha256": "586c32a9e47c4557977b92d73183518e986e70666f6530e2718ef5b7293a1706"
   },
   "default_profile": "core",
   "profiles": [
@@ -6054,19 +6054,78 @@
         "core",
         "full"
       ],
-      "description": "List models Lists the currently available models. Default responses are trimmed for discovery. Non-chat models may include lightweight request-format metadata; `agent_preferences` appears only when `recommended_for` is present. Deprecated `lemondata` is still returned as a compatibility alias during the migration.",
+      "description": "List models Lists the currently available models. Use `view=compact` for model selection and `view=full` for the existing OpenAI-compatible discovery shape. Native API calls default to `full`; integrations may choose `compact` as their default. Non-chat recommendations are available through `recommended_for`.",
       "input_schema": {
         "type": "object",
-        "properties": {},
+        "properties": {
+          "provider": {
+            "type": "string",
+            "description": "Filter by public model provider, for example openai, anthropic, google, or minimax."
+          },
+          "tag": {
+            "type": "string",
+            "description": "Filter by a public capability tag."
+          },
+          "category": {
+            "type": "string",
+            "enum": [
+              "chat",
+              "embedding",
+              "translation",
+              "image",
+              "video",
+              "audio",
+              "tts",
+              "stt",
+              "rerank",
+              "3d",
+              "music"
+            ],
+            "description": "Filter by model category."
+          },
+          "recommended_for": {
+            "type": "string",
+            "enum": [
+              "image",
+              "video",
+              "music",
+              "3d",
+              "tts",
+              "stt",
+              "embedding",
+              "rerank",
+              "translation"
+            ],
+            "description": "Sort supported non-chat models for a task category and include recommendation evidence."
+          },
+          "view": {
+            "type": "string",
+            "enum": [
+              "compact",
+              "full"
+            ],
+            "default": "compact",
+            "description": "Compact model-selection output is the MCP default. Set view to full only when the complete OpenAI-compatible list shape is required."
+          }
+        },
         "additionalProperties": false
       },
       "bindings": {
         "path": [],
-        "query": [],
+        "query": [
+          "provider",
+          "tag",
+          "category",
+          "recommended_for",
+          "view"
+        ],
         "header": [],
         "body": [],
         "files": []
       },
+      "default_arguments": {
+        "view": "compact"
+      },
       "annotations": {
         "readOnlyHint": true,
         "destructiveHint": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tokenlabai/mcp-server",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "OpenAPI-generated TokenLab MCP server with catalog, native AI, multimodal, resource, prompt, and async task support.",
   "type": "module",
   "engines": {

package/scripts/generate-contract.mjs

@@ -216,6 +216,17 @@ function applyInputOverrides(schema, bindings, override) {
     if (!schema.properties[name]) throw new Error(`Cannot override unknown MCP argument: ${name}`);
     schema.properties[name] = { ...schema.properties[name], ...patch };
   }
+  for (const [name, value] of Object.entries(override.default_arguments || {})) {
+    if (!schema.properties[name]) throw new Error(`Cannot default unknown MCP argument: ${name}`);
+    const property = schema.properties[name];
+    if (Array.isArray(property.enum) && !property.enum.includes(value)) {
+      throw new Error(`Default MCP argument ${name} is outside its enum`);
+    }
+    if (Object.hasOwn(property, "const") && property.const !== value) {
+      throw new Error(`Default MCP argument ${name} does not match its const value`);
+    }
+    schema.properties[name] = { ...schema.properties[name], default: value };
+  }
 }
 
 function annotations(method) {
@@ -262,6 +273,7 @@ for (const [operationId, indexed] of operations) {
       description,
       input_schema: schema,
       bindings,
+      ...(override.default_arguments ? { default_arguments: override.default_arguments } : {}),
       annotations: { ...annotations(indexed.method), ...(override.annotations || {}) },
       ...(override.task ? { task: override.task } : {})
     });

package/src/index.js

@@ -109,12 +109,14 @@ async function appendMultipart(form, name, value, isFile) {
 }
 
 function collectArguments(tool, input) {
-  const pathArguments = Object.fromEntries(tool.bindings.path.map((name) => [name, input[name]]));
-  const queryArguments = Object.fromEntries(tool.bindings.query.map((name) => [name, input[name]]));
-  const headerArguments = Object.fromEntries(tool.bindings.header.map((name) => [name, input[name]]));
+  const resolvedInput = { ...(tool.default_arguments || {}), ...input };
+
+  const pathArguments = Object.fromEntries(tool.bindings.path.map((name) => [name, resolvedInput[name]]));
+  const queryArguments = Object.fromEntries(tool.bindings.query.map((name) => [name, resolvedInput[name]]));
+  const headerArguments = Object.fromEntries(tool.bindings.header.map((name) => [name, resolvedInput[name]]));
   const bodyArguments = tool.bindings.body.includes("body")
-    ? input.body
-    : Object.fromEntries(tool.bindings.body.map((name) => [name, input[name]]));
+    ? resolvedInput.body
+    : Object.fromEntries(tool.bindings.body.map((name) => [name, resolvedInput[name]]));
   return { pathArguments, queryArguments, headerArguments, bodyArguments };
 }