@tokenlabai/mcp-server 0.6.9 → 0.6.10

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

package/contract/openapi.json

@@ -977,6 +977,18 @@
               ]
             },
             "description": "Filter by material library class."
+          },
+          {
+            "name": "project_name",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128,
+              "default": "default"
+            },
+            "description": "Project scope for the material resource."
           }
         ],
         "responses": {
@@ -1042,6 +1054,18 @@
               "type": "string"
             },
             "example": "asset-20260720123456-qn7wr"
+          },
+          {
+            "name": "project_name",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128,
+              "default": "default"
+            },
+            "description": "Project scope for the material resource."
           }
         ],
         "responses": {
@@ -1193,6 +1217,18 @@
               "type": "string"
             },
             "example": "asset-20260720123456-qn7wr"
+          },
+          {
+            "name": "project_name",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128,
+              "default": "default"
+            },
+            "description": "Project scope for the material resource."
           }
         ],
         "responses": {
@@ -5538,6 +5574,18 @@
               ]
             },
             "description": "Filter by TokenLab material library class."
+          },
+          {
+            "name": "project_name",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128,
+              "default": "default"
+            },
+            "description": "Project scope for the material resource."
           }
         ],
         "responses": {
@@ -5610,6 +5658,18 @@
               "type": "string"
             },
             "example": "group-20260720123456-vrt01"
+          },
+          {
+            "name": "project_name",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128,
+              "default": "default"
+            },
+            "description": "Project scope for the material resource."
           }
         ],
         "responses": {
@@ -5748,6 +5808,18 @@
               "type": "string"
             },
             "example": "group-20260720123456-vrt01"
+          },
+          {
+            "name": "project_name",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128,
+              "default": "default"
+            },
+            "description": "Project scope for the material resource."
           }
         ],
         "responses": {
@@ -6192,7 +6264,7 @@
           "Seedance Volc Compatible"
         ],
         "summary": "Seedance Action dispatcher (POST)",
-        "description": "Dispatches Volc-style Action requests with TokenLab Bearer authentication. Real-person validation uses CreateVisualValidateSession and GetVisualValidateResult with Version=2024-01-01; these actions are POST-only.",
+        "description": "Dispatches Volc-style Action requests with TokenLab Bearer authentication. Real-person validation and material asset Actions use Version=2024-01-01 and are POST-only. The same POST contract is also available at the API root for endpoint-only migration from Volcengine.",
         "operationId": "dispatchVolcCompatibleSeedanceActionPost",
         "parameters": [
           {
@@ -6207,7 +6279,17 @@
                 "ListContentsGenerationsTasks",
                 "DeleteContentsGenerationsTasks",
                 "CreateVisualValidateSession",
-                "GetVisualValidateResult"
+                "GetVisualValidateResult",
+                "CreateAssetGroup",
+                "ListAssetGroups",
+                "GetAssetGroup",
+                "UpdateAssetGroup",
+                "DeleteAssetGroup",
+                "CreateAsset",
+                "ListAssets",
+                "GetAsset",
+                "UpdateAsset",
+                "DeleteAsset"
               ]
             }
           },
@@ -6233,6 +6315,9 @@
                   {
                     "$ref": "#/components/schemas/VolcGetVisualValidateResultRequest"
                   },
+                  {
+                    "$ref": "#/components/schemas/VolcMaterialActionRequest"
+                  },
                   {
                     "type": "object",
                     "additionalProperties": true
@@ -6244,7 +6329,7 @@
         },
         "responses": {
           "200": {
-            "description": "Action response. Content-generation actions return task JSON; real-person validation actions return the official ResponseMetadata + Result envelope.",
+            "description": "Action response. Content-generation actions return task JSON; real-person validation and material asset actions return the official ResponseMetadata + Result envelope.",
             "content": {
               "application/json": {
                 "schema": {
@@ -6263,6 +6348,9 @@
                     },
                     {
                       "$ref": "#/components/schemas/VolcGetVisualValidateResultResponse"
+                    },
+                    {
+                      "$ref": "#/components/schemas/VolcMaterialActionResponse"
                     }
                   ]
                 }
@@ -8281,6 +8369,13 @@
             "type": "string",
             "description": "TokenLab material group ID. Required for liveness_face materials; optional for aigc_avatar."
           },
+          "project_name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "default": "default",
+            "description": "Project scope for the material asset. Assets and groups are isolated by project inside the authenticated organization."
+          },
           "metadata": {
             "type": "object",
             "nullable": true,
@@ -8316,6 +8411,10 @@
             "nullable": true,
             "description": "TokenLab material group ID that owns this material asset."
           },
+          "project_name": {
+            "type": "string",
+            "description": "Project scope for this material asset."
+          },
           "library_type": {
             "type": "string",
             "enum": [
@@ -8360,6 +8459,10 @@
           "created_at": {
             "type": "integer",
             "description": "Unix timestamp when the material asset record was created."
+          },
+          "updated_at": {
+            "type": "integer",
+            "description": "Unix timestamp when the material asset record was last updated."
           }
         }
       },
@@ -11783,6 +11886,13 @@
             "default": "aigc_avatar",
             "description": "Material library class. Direct creation supports aigc_avatar. Create liveness_face groups through CreateVisualValidateSession followed by GetVisualValidateResult."
           },
+          "project_name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "default": "default",
+            "description": "Project scope for the material group."
+          },
           "metadata": {
             "type": "object",
             "nullable": true,
@@ -11803,6 +11913,12 @@
             "nullable": true,
             "maxLength": 500
           },
+          "project_name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "default": "default"
+          },
           "metadata": {
             "type": "object",
             "nullable": true,
@@ -11836,6 +11952,10 @@
               "liveness_face"
             ]
           },
+          "project_name": {
+            "type": "string",
+            "description": "Project scope for this material group."
+          },
           "group_name": {
             "type": "string",
             "nullable": true
@@ -11855,6 +11975,10 @@
           "created_at": {
             "type": "integer",
             "format": "int64"
+          },
+          "updated_at": {
+            "type": "integer",
+            "format": "int64"
           }
         }
       },
@@ -11899,6 +12023,12 @@
               "Audio"
             ]
           },
+          "project_name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "default": "default"
+          },
           "metadata": {
             "type": "object",
             "nullable": true,
@@ -12891,6 +13021,186 @@
         },
         "additionalProperties": false
       },
+      "VolcMaterialActionRequest": {
+        "type": "object",
+        "description": "PascalCase request body for the material Action selected by the Action query parameter. Required fields depend on the selected Action.",
+        "properties": {
+          "Id": {
+            "type": "string",
+            "description": "Asset or Asset Group identifier for get, update, and delete Actions."
+          },
+          "Name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 64
+          },
+          "Description": {
+            "type": "string",
+            "maxLength": 300
+          },
+          "GroupType": {
+            "type": "string",
+            "enum": [
+              "AIGC",
+              "LivenessFace"
+            ]
+          },
+          "GroupId": {
+            "type": "string"
+          },
+          "URL": {
+            "type": "string",
+            "format": "uri"
+          },
+          "AssetType": {
+            "type": "string",
+            "enum": [
+              "Image",
+              "Video",
+              "Audio"
+            ]
+          },
+          "Filter": {
+            "type": "object",
+            "properties": {
+              "GroupIds": {
+                "type": "array",
+                "maxItems": 100,
+                "items": {
+                  "type": "string"
+                }
+              },
+              "GroupType": {
+                "type": "string",
+                "enum": [
+                  "AIGC",
+                  "LivenessFace"
+                ]
+              },
+              "Statuses": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "Active",
+                    "Processing",
+                    "Failed"
+                  ]
+                }
+              },
+              "Name": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 64
+              }
+            },
+            "additionalProperties": false
+          },
+          "PageNumber": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 1
+          },
+          "PageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "default": 10
+          },
+          "SortBy": {
+            "type": "string",
+            "enum": [
+              "CreateTime",
+              "UpdateTime",
+              "GroupId"
+            ],
+            "default": "CreateTime"
+          },
+          "SortOrder": {
+            "type": "string",
+            "enum": [
+              "Desc",
+              "Asc"
+            ],
+            "default": "Desc"
+          },
+          "ProjectName": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "default": "default",
+            "description": "Project isolation scope within the authenticated organization."
+          }
+        },
+        "additionalProperties": false
+      },
+      "VolcMaterialResponseMetadata": {
+        "type": "object",
+        "required": [
+          "RequestId",
+          "Action",
+          "Version",
+          "Service",
+          "Region"
+        ],
+        "properties": {
+          "RequestId": {
+            "type": "string"
+          },
+          "Action": {
+            "type": "string",
+            "enum": [
+              "CreateAssetGroup",
+              "ListAssetGroups",
+              "GetAssetGroup",
+              "UpdateAssetGroup",
+              "DeleteAssetGroup",
+              "CreateAsset",
+              "ListAssets",
+              "GetAsset",
+              "UpdateAsset",
+              "DeleteAsset"
+            ]
+          },
+          "Version": {
+            "type": "string",
+            "enum": [
+              "2024-01-01"
+            ]
+          },
+          "Service": {
+            "type": "string",
+            "enum": [
+              "ark"
+            ]
+          },
+          "Region": {
+            "type": "string",
+            "enum": [
+              "cn-beijing"
+            ]
+          }
+        },
+        "additionalProperties": false
+      },
+      "VolcMaterialActionResponse": {
+        "type": "object",
+        "required": [
+          "ResponseMetadata",
+          "Result"
+        ],
+        "properties": {
+          "ResponseMetadata": {
+            "$ref": "#/components/schemas/VolcMaterialResponseMetadata"
+          },
+          "Result": {
+            "type": "object",
+            "description": "Action-dependent result. List Actions return Items, TotalCount, PageNumber, and PageSize; create and update Actions return Id; delete Actions return an empty object.",
+            "additionalProperties": true
+          }
+        },
+        "additionalProperties": false
+      },
       "VolcVisualValidationError": {
         "type": "object",
         "required": [

package/generated/public-contract.json

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

package/generated/tools.json

@@ -6,7 +6,7 @@
     "openapi": "3.0.3",
     "title": "TokenLab AI Gateway",
     "version": "1.0.0",
-    "sha256": "ca3a4d2897ad8a71e44194b629170678ce31ee678379617b2a4018fbff9ce900"
+    "sha256": "40661266d5b182d7a9f829ae480a1c86d5f141c2b75b25f40ba4bfdf50a42c08"
   },
   "default_profile": "core",
   "profiles": [
@@ -3059,6 +3059,13 @@
             "type": "string",
             "description": "TokenLab material group ID. Required for liveness_face materials; optional for aigc_avatar."
           },
+          "project_name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "default": "default",
+            "description": "Project scope for the material asset. Assets and groups are isolated by project inside the authenticated organization."
+          },
           "metadata": {
             "anyOf": [
               {
@@ -3087,6 +3094,7 @@
           "asset_type",
           "library_type",
           "group_id",
+          "project_name",
           "metadata"
         ],
         "files": []
@@ -3142,6 +3150,13 @@
             "default": "aigc_avatar",
             "description": "Material library class. Direct creation supports aigc_avatar. Create liveness_face groups through CreateVisualValidateSession followed by GetVisualValidateResult."
           },
+          "project_name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "default": "default",
+            "description": "Project scope for the material group."
+          },
           "metadata": {
             "anyOf": [
               {
@@ -3164,6 +3179,7 @@
           "group_name",
           "description",
           "library_type",
+          "project_name",
           "metadata"
         ],
         "files": []
@@ -4397,6 +4413,13 @@
         "properties": {
           "assetId": {
             "type": "string"
+          },
+          "project_name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "default": "default",
+            "description": "Project scope for the material resource."
           }
         },
         "required": [
@@ -4408,7 +4431,9 @@
         "path": [
           "assetId"
         ],
-        "query": [],
+        "query": [
+          "project_name"
+        ],
         "header": [],
         "body": [],
         "files": []
@@ -4440,6 +4465,13 @@
         "properties": {
           "groupId": {
             "type": "string"
+          },
+          "project_name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "default": "default",
+            "description": "Project scope for the material resource."
           }
         },
         "required": [
@@ -4451,7 +4483,9 @@
         "path": [
           "groupId"
         ],
-        "query": [],
+        "query": [
+          "project_name"
+        ],
         "header": [],
         "body": [],
         "files": []
@@ -4619,7 +4653,7 @@
       "profiles": [
         "full"
       ],
-      "description": "Seedance Action dispatcher (POST) Dispatches Volc-style Action requests with TokenLab Bearer authentication. Real-person validation uses CreateVisualValidateSession and GetVisualValidateResult with Version=2024-01-01; these actions are POST-only.",
+      "description": "Seedance Action dispatcher (POST) Dispatches Volc-style Action requests with TokenLab Bearer authentication. Real-person validation and material asset Actions use Version=2024-01-01 and are POST-only. The same POST contract is also available at the API root for endpoint-only migration from Volcengine.",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -4631,7 +4665,17 @@
               "ListContentsGenerationsTasks",
               "DeleteContentsGenerationsTasks",
               "CreateVisualValidateSession",
-              "GetVisualValidateResult"
+              "GetVisualValidateResult",
+              "CreateAssetGroup",
+              "ListAssetGroups",
+              "GetAssetGroup",
+              "UpdateAssetGroup",
+              "DeleteAssetGroup",
+              "CreateAsset",
+              "ListAssets",
+              "GetAsset",
+              "UpdateAsset",
+              "DeleteAsset"
             ]
           },
           "Version": {
@@ -4677,6 +4721,119 @@
                 },
                 "additionalProperties": false
               },
+              {
+                "type": "object",
+                "description": "PascalCase request body for the material Action selected by the Action query parameter. Required fields depend on the selected Action.",
+                "properties": {
+                  "Id": {
+                    "type": "string",
+                    "description": "Asset or Asset Group identifier for get, update, and delete Actions."
+                  },
+                  "Name": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 64
+                  },
+                  "Description": {
+                    "type": "string",
+                    "maxLength": 300
+                  },
+                  "GroupType": {
+                    "type": "string",
+                    "enum": [
+                      "AIGC",
+                      "LivenessFace"
+                    ]
+                  },
+                  "GroupId": {
+                    "type": "string"
+                  },
+                  "URL": {
+                    "type": "string",
+                    "format": "uri"
+                  },
+                  "AssetType": {
+                    "type": "string",
+                    "enum": [
+                      "Image",
+                      "Video",
+                      "Audio"
+                    ]
+                  },
+                  "Filter": {
+                    "type": "object",
+                    "properties": {
+                      "GroupIds": {
+                        "type": "array",
+                        "maxItems": 100,
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "GroupType": {
+                        "type": "string",
+                        "enum": [
+                          "AIGC",
+                          "LivenessFace"
+                        ]
+                      },
+                      "Statuses": {
+                        "type": "array",
+                        "items": {
+                          "type": "string",
+                          "enum": [
+                            "Active",
+                            "Processing",
+                            "Failed"
+                          ]
+                        }
+                      },
+                      "Name": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 64
+                      }
+                    },
+                    "additionalProperties": false
+                  },
+                  "PageNumber": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "default": 1
+                  },
+                  "PageSize": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 100,
+                    "default": 10
+                  },
+                  "SortBy": {
+                    "type": "string",
+                    "enum": [
+                      "CreateTime",
+                      "UpdateTime",
+                      "GroupId"
+                    ],
+                    "default": "CreateTime"
+                  },
+                  "SortOrder": {
+                    "type": "string",
+                    "enum": [
+                      "Desc",
+                      "Asc"
+                    ],
+                    "default": "Desc"
+                  },
+                  "ProjectName": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "default": "default",
+                    "description": "Project isolation scope within the authenticated organization."
+                  }
+                },
+                "additionalProperties": false
+              },
               {
                 "type": "object",
                 "additionalProperties": true
@@ -5443,6 +5600,13 @@
         "properties": {
           "assetId": {
             "type": "string"
+          },
+          "project_name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "default": "default",
+            "description": "Project scope for the material resource."
           }
         },
         "required": [
@@ -5454,7 +5618,9 @@
         "path": [
           "assetId"
         ],
-        "query": [],
+        "query": [
+          "project_name"
+        ],
         "header": [],
         "body": [],
         "files": []
@@ -5486,6 +5652,13 @@
         "properties": {
           "groupId": {
             "type": "string"
+          },
+          "project_name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "default": "default",
+            "description": "Project scope for the material resource."
           }
         },
         "required": [
@@ -5497,7 +5670,9 @@
         "path": [
           "groupId"
         ],
-        "query": [],
+        "query": [
+          "project_name"
+        ],
         "header": [],
         "body": [],
         "files": []
@@ -6227,6 +6402,13 @@
               "liveness_face"
             ],
             "description": "Filter by TokenLab material library class."
+          },
+          "project_name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "default": "default",
+            "description": "Project scope for the material resource."
           }
         },
         "additionalProperties": false
@@ -6237,7 +6419,8 @@
           "page_size",
           "page_token",
           "status",
-          "library_type"
+          "library_type",
+          "project_name"
         ],
         "header": [],
         "body": [],
@@ -6297,6 +6480,13 @@
               "liveness_face"
             ],
             "description": "Filter by material library class."
+          },
+          "project_name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "default": "default",
+            "description": "Project scope for the material resource."
           }
         },
         "additionalProperties": false
@@ -6308,7 +6498,8 @@
           "page_token",
           "group_id",
           "status",
-          "library_type"
+          "library_type",
+          "project_name"
         ],
         "header": [],
         "body": [],
@@ -7246,6 +7437,12 @@
               "Audio"
             ]
           },
+          "project_name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "default": "default"
+          },
           "metadata": {
             "anyOf": [
               {
@@ -7274,6 +7471,7 @@
           "asset_url",
           "asset_name",
           "asset_type",
+          "project_name",
           "metadata"
         ],
         "files": []
@@ -7322,6 +7520,12 @@
               }
             ]
           },
+          "project_name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "default": "default"
+          },
           "metadata": {
             "anyOf": [
               {
@@ -7348,6 +7552,7 @@
         "body": [
           "group_name",
           "description",
+          "project_name",
           "metadata"
         ],
         "files": []

package/package.json

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