@tokenlabai/mcp-server 0.6.8 → 0.6.9

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.8 generates 75 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.9 generates 75 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.8`
+- npm package: `@tokenlabai/mcp-server@0.6.9`
 - MCP registry name: `io.github.hedging8563/tokenlab`
 - `package.json.mcpName`: `io.github.hedging8563/tokenlab`
 

package/contract/openapi.json

@@ -1759,7 +1759,8 @@
             "schema": {
               "type": "integer",
               "minimum": 1,
-              "maximum": 100
+              "maximum": 1000,
+              "default": 20
             },
             "description": "Maximum number of batches to return"
           }
@@ -1870,7 +1871,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/AnthropicMessageBatch"
+                  "$ref": "#/components/schemas/AnthropicDeletedMessageBatch"
                 }
               }
             }
@@ -3322,8 +3323,19 @@
           "Files"
         ],
         "summary": "Upload file",
-        "description": "Uploads a JSONL batch input file or an image input file that can be referenced by file_id in supported image edit requests.",
+        "description": "Uploads a TokenLab/OpenAI-compatible batch or image file. With anthropic-beta: files-api-2025-04-14, uploads an Anthropic Files resource without a purpose field and returns Anthropic file metadata.",
         "operationId": "uploadFile",
+        "parameters": [
+          {
+            "name": "anthropic-beta",
+            "in": "header",
+            "required": false,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Include files-api-2025-04-14 to use Anthropic Files API mode."
+          }
+        ],
         "requestBody": {
           "required": true,
           "content": {
@@ -3331,8 +3343,7 @@
               "schema": {
                 "type": "object",
                 "required": [
-                  "file",
-                  "purpose"
+                  "file"
                 ],
                 "properties": {
                   "file": {
@@ -3346,7 +3357,7 @@
                       "user_data",
                       "vision"
                     ],
-                    "description": "Use batch for Batch API JSONL files. Use user_data or vision for image files that will be referenced from image edits."
+                    "description": "Required in TokenLab/OpenAI-compatible mode: use batch for Batch API JSONL files, or user_data/vision for image edits. Omit in Anthropic Files mode."
                   },
                   "model": {
                     "type": "string",
@@ -3363,7 +3374,14 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/FileObject"
+                  "oneOf": [
+                    {
+                      "$ref": "#/components/schemas/FileObject"
+                    },
+                    {
+                      "$ref": "#/components/schemas/AnthropicFileObject"
+                    }
+                  ]
                 }
               }
             }
@@ -3392,7 +3410,8 @@
             "schema": {
               "type": "integer",
               "minimum": 1,
-              "maximum": 100
+              "maximum": 1000,
+              "default": 20
             }
           },
           {
@@ -3402,6 +3421,30 @@
               "type": "string"
             }
           },
+          {
+            "name": "after_id",
+            "in": "query",
+            "schema": {
+              "type": "string"
+            },
+            "description": "Anthropic Files cursor. Return files after this public file id. Requires the Anthropic Files beta header and cannot be combined with before_id."
+          },
+          {
+            "name": "before_id",
+            "in": "query",
+            "schema": {
+              "type": "string"
+            },
+            "description": "Anthropic Files cursor. Return files before this public file id. Requires the Anthropic Files beta header and cannot be combined with after_id."
+          },
+          {
+            "name": "scope_id",
+            "in": "query",
+            "schema": {
+              "type": "string"
+            },
+            "description": "Reserved Anthropic Files scope cursor. TokenLab currently returns an explicit unsupported error rather than silently ignoring this value."
+          },
           {
             "name": "purpose",
             "in": "query",
@@ -3415,6 +3458,15 @@
               ]
             },
             "description": "Optional file purpose filter. batch and batch_output cover Batch API files; user_data and vision cover TokenLab image/reference file bindings. Anthropic Files API mode is selected by Anthropic headers rather than this query parameter."
+          },
+          {
+            "name": "anthropic-beta",
+            "in": "header",
+            "required": false,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Include files-api-2025-04-14 to use Anthropic Files API mode."
           }
         ],
         "responses": {
@@ -3423,7 +3475,14 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/FileListResponse"
+                  "oneOf": [
+                    {
+                      "$ref": "#/components/schemas/FileListResponse"
+                    },
+                    {
+                      "$ref": "#/components/schemas/AnthropicFileListResponse"
+                    }
+                  ]
                 }
               }
             }
@@ -3449,6 +3508,15 @@
             "schema": {
               "type": "string"
             }
+          },
+          {
+            "name": "anthropic-beta",
+            "in": "header",
+            "required": false,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Include files-api-2025-04-14 to use Anthropic Files API mode."
           }
         ],
         "responses": {
@@ -3457,7 +3525,14 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/FileObject"
+                  "oneOf": [
+                    {
+                      "$ref": "#/components/schemas/FileObject"
+                    },
+                    {
+                      "$ref": "#/components/schemas/AnthropicFileObject"
+                    }
+                  ]
                 }
               }
             }
@@ -3483,6 +3558,15 @@
               "type": "string"
             },
             "description": "File ID returned by the Files API."
+          },
+          {
+            "name": "anthropic-beta",
+            "in": "header",
+            "required": false,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Include files-api-2025-04-14 to use Anthropic Files API mode."
           }
         ],
         "responses": {
@@ -3491,7 +3575,14 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/FileDeletedObject"
+                  "oneOf": [
+                    {
+                      "$ref": "#/components/schemas/FileDeletedObject"
+                    },
+                    {
+                      "$ref": "#/components/schemas/AnthropicDeletedFile"
+                    }
+                  ]
                 }
               }
             }
@@ -8557,6 +8648,7 @@
                   "unauthorized",
                   "invalid_api_key",
                   "expired_api_key",
+                  "permission_error",
                   "insufficient_balance",
                   "quota_exceeded",
                   "invalid_request_error",
@@ -10132,6 +10224,118 @@
           }
         }
       },
+      "AnthropicFileObject": {
+        "type": "object",
+        "required": [
+          "id",
+          "type",
+          "filename",
+          "mime_type",
+          "size_bytes",
+          "created_at"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "example": "file_01ABC123"
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "file"
+            ]
+          },
+          "filename": {
+            "type": "string"
+          },
+          "mime_type": {
+            "type": "string"
+          },
+          "size_bytes": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "downloadable": {
+            "type": "boolean"
+          },
+          "scope": {
+            "type": "object",
+            "nullable": true,
+            "required": [
+              "id",
+              "type"
+            ],
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "type": {
+                "type": "string",
+                "enum": [
+                  "session"
+                ]
+              }
+            },
+            "additionalProperties": true
+          }
+        },
+        "additionalProperties": true
+      },
+      "AnthropicFileListResponse": {
+        "type": "object",
+        "required": [
+          "data",
+          "first_id",
+          "last_id",
+          "has_more"
+        ],
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/AnthropicFileObject"
+            }
+          },
+          "first_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "last_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "has_more": {
+            "type": "boolean"
+          }
+        },
+        "additionalProperties": true
+      },
+      "AnthropicDeletedFile": {
+        "type": "object",
+        "required": [
+          "id"
+        ],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "file_deleted"
+            ]
+          }
+        },
+        "additionalProperties": true
+      },
       "BatchRequestCounts": {
         "type": "object",
         "required": [
@@ -10741,18 +10945,26 @@
                   "$ref": "#/components/schemas/AnthropicMessagesRequest"
                 }
               },
-              "additionalProperties": false
+              "additionalProperties": true
             }
           }
         },
-        "additionalProperties": false
+        "additionalProperties": true
       },
       "AnthropicMessageBatch": {
         "type": "object",
         "description": "Anthropic-compatible message batch object relayed from the provider.",
         "required": [
           "id",
-          "type"
+          "type",
+          "processing_status",
+          "request_counts",
+          "ended_at",
+          "created_at",
+          "expires_at",
+          "cancel_initiated_at",
+          "archived_at",
+          "results_url"
         ],
         "properties": {
           "id": {
@@ -10789,6 +11001,16 @@
             "type": "string",
             "description": "ISO timestamp when the batch expires, when available"
           },
+          "cancel_initiated_at": {
+            "type": "string",
+            "nullable": true,
+            "description": "ISO timestamp when cancellation was initiated, when available"
+          },
+          "archived_at": {
+            "type": "string",
+            "nullable": true,
+            "description": "ISO timestamp when the batch was archived, when available"
+          },
           "results_url": {
             "type": "string",
             "nullable": true,
@@ -10797,8 +11019,34 @@
         },
         "additionalProperties": true
       },
+      "AnthropicDeletedMessageBatch": {
+        "type": "object",
+        "required": [
+          "id",
+          "type"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Deleted Message Batch identifier"
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "message_batch_deleted"
+            ]
+          }
+        },
+        "additionalProperties": true
+      },
       "AnthropicMessageBatchListResponse": {
         "type": "object",
+        "required": [
+          "data",
+          "has_more",
+          "first_id",
+          "last_id"
+        ],
         "properties": {
           "data": {
             "type": "array",

package/generated/public-contract.json

@@ -5,7 +5,7 @@
     "id": "tokenlab-mcp-server",
     "name": "@tokenlabai/mcp-server",
     "title": "TokenLab MCP Server",
-    "version": "0.6.8",
+    "version": "0.6.9",
     "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": "66bfd771665f51aca0bd8a16cdec7c63712b529c4ff009d2b29cfdbb173e2602",
-    "tool_manifest_sha256": "c0ff1a3dfd194349349c2135ef26ff3b0e6631a4c2cb76a15898659298419a6c"
+    "sha256": "ca3a4d2897ad8a71e44194b629170678ce31ee678379617b2a4018fbff9ce900",
+    "tool_manifest_sha256": "344685636da44b3ba93589a8e64536148561f63cd26a75bd5dd59e6f072b132f"
   },
   "profiles": {
     "catalog": {

package/generated/tools.json

@@ -6,7 +6,7 @@
     "openapi": "3.0.3",
     "title": "TokenLab AI Gateway",
     "version": "1.0.0",
-    "sha256": "66bfd771665f51aca0bd8a16cdec7c63712b529c4ff009d2b29cfdbb173e2602"
+    "sha256": "ca3a4d2897ad8a71e44194b629170678ce31ee678379617b2a4018fbff9ce900"
   },
   "default_profile": "core",
   "profiles": [
@@ -905,7 +905,7 @@
                   }
                 }
               },
-              "additionalProperties": false
+              "additionalProperties": true
             }
           }
         },
@@ -4304,6 +4304,10 @@
           "file_id": {
             "type": "string",
             "description": "File ID returned by the Files API."
+          },
+          "anthropic-beta": {
+            "type": "string",
+            "description": "Include files-api-2025-04-14 to use Anthropic Files API mode."
           }
         },
         "required": [
@@ -4316,7 +4320,9 @@
           "file_id"
         ],
         "query": [],
-        "header": [],
+        "header": [
+          "anthropic-beta"
+        ],
         "body": [],
         "files": []
       },
@@ -5888,7 +5894,8 @@
           "limit": {
             "type": "integer",
             "minimum": 1,
-            "maximum": 100,
+            "maximum": 1000,
+            "default": 20,
             "description": "Maximum number of batches to return"
           }
         },
@@ -5980,11 +5987,24 @@
           "limit": {
             "type": "integer",
             "minimum": 1,
-            "maximum": 100
+            "maximum": 1000,
+            "default": 20
           },
           "after": {
             "type": "string"
           },
+          "after_id": {
+            "type": "string",
+            "description": "Anthropic Files cursor. Return files after this public file id. Requires the Anthropic Files beta header and cannot be combined with before_id."
+          },
+          "before_id": {
+            "type": "string",
+            "description": "Anthropic Files cursor. Return files before this public file id. Requires the Anthropic Files beta header and cannot be combined with after_id."
+          },
+          "scope_id": {
+            "type": "string",
+            "description": "Reserved Anthropic Files scope cursor. TokenLab currently returns an explicit unsupported error rather than silently ignoring this value."
+          },
           "purpose": {
             "type": "string",
             "enum": [
@@ -5994,6 +6014,10 @@
               "vision"
             ],
             "description": "Optional file purpose filter. batch and batch_output cover Batch API files; user_data and vision cover TokenLab image/reference file bindings. Anthropic Files API mode is selected by Anthropic headers rather than this query parameter."
+          },
+          "anthropic-beta": {
+            "type": "string",
+            "description": "Include files-api-2025-04-14 to use Anthropic Files API mode."
           }
         },
         "additionalProperties": false
@@ -6003,9 +6027,14 @@
         "query": [
           "limit",
           "after",
+          "after_id",
+          "before_id",
+          "scope_id",
           "purpose"
         ],
-        "header": [],
+        "header": [
+          "anthropic-beta"
+        ],
         "body": [],
         "files": []
       },
@@ -6828,6 +6857,10 @@
         "properties": {
           "file_id": {
             "type": "string"
+          },
+          "anthropic-beta": {
+            "type": "string",
+            "description": "Include files-api-2025-04-14 to use Anthropic Files API mode."
           }
         },
         "required": [
@@ -6840,7 +6873,9 @@
           "file_id"
         ],
         "query": [],
-        "header": [],
+        "header": [
+          "anthropic-beta"
+        ],
         "body": [],
         "files": []
       },
@@ -7339,10 +7374,14 @@
         "core",
         "full"
       ],
-      "description": "Upload file Uploads a JSONL batch input file or an image input file that can be referenced by file_id in supported image edit requests.",
+      "description": "Upload file Uploads a TokenLab/OpenAI-compatible batch or image file. With anthropic-beta: files-api-2025-04-14, uploads an Anthropic Files resource without a purpose field and returns Anthropic file metadata.",
       "input_schema": {
         "type": "object",
         "properties": {
+          "anthropic-beta": {
+            "type": "string",
+            "description": "Include files-api-2025-04-14 to use Anthropic Files API mode."
+          },
           "file": {
             "type": "string",
             "description": "Pass local file path."
@@ -7354,7 +7393,7 @@
               "user_data",
               "vision"
             ],
-            "description": "Use batch for Batch API JSONL files. Use user_data or vision for image files that will be referenced from image edits."
+            "description": "Required in TokenLab/OpenAI-compatible mode: use batch for Batch API JSONL files, or user_data/vision for image edits. Omit in Anthropic Files mode."
           },
           "model": {
             "type": "string",
@@ -7362,15 +7401,16 @@
           }
         },
         "required": [
-          "file",
-          "purpose"
+          "file"
         ],
         "additionalProperties": false
       },
       "bindings": {
         "path": [],
         "query": [],
-        "header": [],
+        "header": [
+          "anthropic-beta"
+        ],
         "body": [
           "file",
           "purpose",

package/package.json

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