@tokenlabai/mcp-server 0.6.6 → 0.6.8

package/generated/public-contract.json

@@ -5,7 +5,7 @@
     "id": "tokenlab-mcp-server",
     "name": "@tokenlabai/mcp-server",
     "title": "TokenLab MCP Server",
-    "version": "0.6.6",
+    "version": "0.6.8",
     "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": "d80d3da097ea6ba040e1ab85d00d95160f109ded7f2725e002f6dc86081dc812",
-    "tool_manifest_sha256": "c9bfa118cfbbd4beb9b79dcdf203ca2278ca88734432cd22f56dc6ae7be2b6f8"
+    "sha256": "66bfd771665f51aca0bd8a16cdec7c63712b529c4ff009d2b29cfdbb173e2602",
+    "tool_manifest_sha256": "c0ff1a3dfd194349349c2135ef26ff3b0e6631a4c2cb76a15898659298419a6c"
   },
   "profiles": {
     "catalog": {
@@ -84,11 +84,10 @@
     },
     "full": {
       "is_default": false,
-      "endpoint_tools": 76,
+      "endpoint_tools": 75,
       "composite_tools": 2,
-      "total_tools": 78,
+      "total_tools": 77,
       "tool_names": [
-        "bind_seedance_visual_validation_result",
         "cancel_anthropic_message_batch",
         "cancel_batch",
         "cancel_task",
@@ -110,9 +109,9 @@
         "create_response",
         "create_seedance_material_asset",
         "create_seedance_material_asset_group",
-        "create_seedance_visual_validation_session",
         "create_speech",
         "create_video",
+        "create_visual_validate_session",
         "create_volc_compatible_seedance_task",
         "create_world",
         "delete_anthropic_message_batch",
@@ -138,6 +137,7 @@
         "get_seedance_material_asset_group",
         "get_task_status",
         "get_video_task",
+        "get_visual_validate_result",
         "get_volc_compatible_seedance_task",
         "get_world",
         "get_world_media_asset",
@@ -149,7 +149,6 @@
         "list_models",
         "list_seedance_material_asset_groups",
         "list_seedance_material_assets",
-        "list_seedance_visual_validation_history",
         "list_volc_compatible_seedance_tasks",
         "list_worlds",
         "prepare_world_media_asset_upload",

package/generated/tools.json

@@ -6,7 +6,7 @@
     "openapi": "3.0.3",
     "title": "TokenLab AI Gateway",
     "version": "1.0.0",
-    "sha256": "d80d3da097ea6ba040e1ab85d00d95160f109ded7f2725e002f6dc86081dc812"
+    "sha256": "66bfd771665f51aca0bd8a16cdec7c63712b529c4ff009d2b29cfdbb173e2602"
   },
   "default_profile": "core",
   "profiles": [
@@ -14,89 +14,8 @@
     "core",
     "full"
   ],
-  "tool_count": 76,
+  "tool_count": 75,
   "tools": [
-    {
-      "name": "bind_seedance_visual_validation_result",
-      "title": "Bind Seedance real-person verification result",
-      "operation_id": "bindSeedanceVisualValidationResult",
-      "method": "POST",
-      "path": "/v1/videos/assets/visual-validation-results",
-      "content_type": "application/json",
-      "auth": "required",
-      "tags": [
-        "Video"
-      ],
-      "profiles": [
-        "full"
-      ],
-      "description": "Bind Seedance real-person verification result Binds a successful TokenLab real-person verification session to a TokenLab real-person material group. The request must include session_id and verification_token from the TokenLab callback redirect.",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "session_id": {
-            "type": "string",
-            "description": "TokenLab real-person verification session ID."
-          },
-          "verification_token": {
-            "type": "string",
-            "description": "TokenLab opaque token from the TokenLab callback redirect."
-          },
-          "group_name": {
-            "type": "string",
-            "minLength": 1,
-            "maxLength": 128,
-            "description": "Optional TokenLab display name for the bound real-person material group."
-          },
-          "description": {
-            "anyOf": [
-              {
-                "type": "string",
-                "maxLength": 500
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "metadata": {
-            "anyOf": [
-              {
-                "type": "object",
-                "additionalProperties": true
-              },
-              {
-                "type": "null"
-              }
-            ]
-          }
-        },
-        "required": [
-          "session_id",
-          "verification_token"
-        ],
-        "additionalProperties": false
-      },
-      "bindings": {
-        "path": [],
-        "query": [],
-        "header": [],
-        "body": [
-          "session_id",
-          "verification_token",
-          "group_name",
-          "description",
-          "metadata"
-        ],
-        "files": []
-      },
-      "annotations": {
-        "readOnlyHint": false,
-        "destructiveHint": false,
-        "idempotentHint": false,
-        "openWorldHint": true
-      }
-    },
     {
       "name": "cancel_anthropic_message_batch",
       "title": "Cancel message batch (Anthropic-compatible)",
@@ -3103,7 +3022,7 @@
       "profiles": [
         "full"
       ],
-      "description": "Create Seedance material asset Uploads one Seedance material asset URL into a TokenLab material group. Real-person assets require the TokenLab group_id returned by the real-person verification bind flow.",
+      "description": "Create Seedance material asset Uploads one Seedance material asset URL into a TokenLab material group. Real-person assets require the group_id mapped from Result.GroupId returned by GetVisualValidateResult.",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -3193,7 +3112,7 @@
       "profiles": [
         "full"
       ],
-      "description": "Create Seedance material asset group Creates a TokenLab Seedance virtual-avatar material group. Real-person material groups are created by the real-person verification bind flow.",
+      "description": "Create Seedance material asset group Creates a TokenLab Seedance virtual-avatar material group. Real-person material groups are created by GetVisualValidateResult after the H5 validation succeeds.",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -3221,7 +3140,7 @@
               "liveness_face"
             ],
             "default": "aigc_avatar",
-            "description": "Material library class. Direct creation supports aigc_avatar. Create liveness_face groups through real-person material verification."
+            "description": "Material library class. Direct creation supports aigc_avatar. Create liveness_face groups through CreateVisualValidateSession followed by GetVisualValidateResult."
           },
           "metadata": {
             "anyOf": [
@@ -3256,62 +3175,6 @@
         "openWorldHint": true
       }
     },
-    {
-      "name": "create_seedance_visual_validation_session",
-      "title": "Create Seedance real-person verification session",
-      "operation_id": "createSeedanceVisualValidationSession",
-      "method": "POST",
-      "path": "/v1/videos/assets/visual-validation-sessions",
-      "content_type": "application/json",
-      "auth": "required",
-      "tags": [
-        "Video"
-      ],
-      "profiles": [
-        "full"
-      ],
-      "description": "Create Seedance real-person verification session Creates a TokenLab real-person material verification H5 session. The response contains only TokenLab session fields. The session and H5 link are valid for 120 seconds; the binding token is delivered through the TokenLab callback redirect after the H5 flow completes.",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "callback_url": {
-            "type": "string",
-            "format": "uri",
-            "description": "Public HTTPS URL that TokenLab redirects to after the H5 verification flow. TokenLab appends session_id, verification_token, verification_status, and result_code."
-          },
-          "language": {
-            "type": "string",
-            "enum": [
-              "zh",
-              "en",
-              "zh-Hant"
-            ],
-            "default": "zh",
-            "description": "Language parameter appended to the returned H5 link."
-          }
-        },
-        "required": [
-          "callback_url"
-        ],
-        "additionalProperties": false
-      },
-      "bindings": {
-        "path": [],
-        "query": [],
-        "header": [],
-        "body": [
-          "callback_url",
-          "language"
-        ],
-        "files": []
-      },
-      "annotations": {
-        "readOnlyHint": false,
-        "destructiveHint": false,
-        "idempotentHint": false,
-        "openWorldHint": true
-      }
-    },
     {
       "name": "create_speech",
       "title": "Create speech",
@@ -3484,7 +3347,7 @@
           "image_url": {
             "type": "string",
             "format": "uri",
-            "description": "Publicly reachable image URL for image-to-video generation. Preferred over inline base64 in production. When the selected Seedance model can use the TokenLab material library, TokenLab prepares this image input as a reusable material before generation; if it is not ACTIVE within 60 seconds, the API returns 409 seedance_material_preparing with auto_material_asset_ids. If the selected model cannot use the material library, ordinary image inputs continue on the regular image path."
+            "description": "Publicly reachable image URL for image-to-video generation, or asset://asset-YYYYMMDDHHMMSS-xxxxx for an ACTIVE TokenLab Seedance material used as the first frame. Preferred over inline base64 in production. TokenLab verifies material ownership. When the selected Seedance model can use the TokenLab material library, TokenLab prepares ordinary image input as a reusable material before generation; if it is not ACTIVE within 60 seconds, the API returns 409 seedance_material_preparing with auto_material_asset_ids. If the selected model cannot use the material library, ordinary image inputs continue on the regular image path."
           },
           "video_url": {
             "type": "string",
@@ -3554,11 +3417,11 @@
           },
           "start_image": {
             "type": "string",
-            "description": "First frame image input for start-end-to-video flows. When the selected Seedance model can use the TokenLab material library, TokenLab prepares this image input as a reusable material before generation; if it is not ACTIVE within 60 seconds, the API returns 409 seedance_material_preparing with auto_material_asset_ids. If the selected model cannot use the material library, ordinary image inputs continue on the regular image path."
+            "description": "First frame image input for start-end-to-video flows. Seedance accepts a public image reference or asset://asset-YYYYMMDDHHMMSS-xxxxx for an ACTIVE TokenLab material owned by the requesting organization. When the selected Seedance model can use the TokenLab material library, TokenLab prepares ordinary image input as a reusable material before generation; if it is not ACTIVE within 60 seconds, the API returns 409 seedance_material_preparing with auto_material_asset_ids. If the selected model cannot use the material library, ordinary image inputs continue on the regular image path."
           },
           "end_image": {
             "type": "string",
-            "description": "Last frame image input for start-end-to-video flows. When the selected Seedance model can use the TokenLab material library, TokenLab prepares this image input as a reusable material before generation; if it is not ACTIVE within 60 seconds, the API returns 409 seedance_material_preparing with auto_material_asset_ids. If the selected model cannot use the material library, ordinary image inputs continue on the regular image path."
+            "description": "Last frame image input for start-end-to-video flows. Seedance accepts a public image reference or asset://asset-YYYYMMDDHHMMSS-xxxxx for an ACTIVE TokenLab material owned by the requesting organization. When the selected Seedance model can use the TokenLab material library, TokenLab prepares ordinary image input as a reusable material before generation; if it is not ACTIVE within 60 seconds, the API returns 409 seedance_material_preparing with auto_material_asset_ids. If the selected model cannot use the material library, ordinary image inputs continue on the regular image path."
           },
           "user": {
             "type": "string",
@@ -3614,7 +3477,7 @@
           },
           "reference_images": {
             "type": "array",
-            "description": "Canonical public reference-image field for reference-to-video conditioning. This endpoint currently allows up to 9 URLs or compatible data URLs; model-specific limits can be lower. xAI grok-imagine-video accepts up to 7 image references with duration capped at 10 seconds; grok-imagine-video-1.5 and grok-imagine-video-1.5-preview are image-to-video only and do not accept reference images. When the selected Seedance model can use the TokenLab material library, TokenLab prepares this image input as reusable material before generation; if it is not ACTIVE within 60 seconds, the API returns 409 seedance_material_preparing with auto_material_asset_ids. If the selected model cannot use the material library, ordinary image inputs continue on the regular image path.",
+            "description": "Canonical public reference-image field for reference-to-video conditioning. This endpoint currently allows up to 9 URLs, compatible data URLs, or for Seedance, asset://asset-YYYYMMDDHHMMSS-xxxxx URIs for ACTIVE TokenLab materials owned by the requesting organization; model-specific limits can be lower. xAI grok-imagine-video accepts up to 7 image references with duration capped at 10 seconds; grok-imagine-video-1.5 and grok-imagine-video-1.5-preview are image-to-video only and do not accept reference images. When the selected Seedance model can use the TokenLab material library, TokenLab prepares ordinary image input as reusable material before generation; if it is not ACTIVE within 60 seconds, the API returns 409 seedance_material_preparing with auto_material_asset_ids. If the selected model cannot use the material library, ordinary image inputs continue on the regular image path.",
             "minItems": 1,
             "maxItems": 9,
             "items": {
@@ -3623,7 +3486,7 @@
           },
           "material_asset_id": {
             "type": "string",
-            "description": "TokenLab Seedance material asset ID returned by /v1/videos/assets, by automatic image preparation, or by a real-person verification bind flow. Use it after the asset is ACTIVE with Seedance models that can use the TokenLab material library. The asset must belong to the current account."
+            "description": "TokenLab Seedance material asset ID returned by /v1/videos/assets, by automatic image preparation, or from a real-person group returned by GetVisualValidateResult. Use it after the asset is ACTIVE with Seedance models that can use the TokenLab material library. The asset must belong to the current account. This field is a generic reference input; to assign first-frame, last-frame, or reference-image semantics explicitly, put asset://<material_asset_id> in start_image, end_image, or reference_images."
           },
           "material_asset_ids": {
             "type": "array",
@@ -3850,6 +3713,64 @@
         ]
       }
     },
+    {
+      "name": "create_visual_validate_session",
+      "title": "Create visual validation session",
+      "operation_id": "dispatchVolcCompatibleSeedanceActionPost",
+      "method": "POST",
+      "path": "/api/v3",
+      "content_type": "application/json",
+      "auth": "required",
+      "tags": [
+        "Seedance Volc Compatible"
+      ],
+      "profiles": [
+        "full"
+      ],
+      "description": "Create a real-person visual validation session through the Volc-compatible Action API. Returns the official ResponseMetadata and Result shape with BytedToken, H5Link, and CallbackURL.",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "CallbackURL": {
+            "type": "string",
+            "format": "uri",
+            "description": "Public HTTPS URL opened by the H5 flow after validation. Official callback query names are preserved."
+          },
+          "ProjectName": {
+            "type": "string",
+            "default": "default",
+            "description": "Case-sensitive project name. Omit to use default."
+          }
+        },
+        "required": [
+          "CallbackURL"
+        ],
+        "additionalProperties": false
+      },
+      "bindings": {
+        "path": [],
+        "query": [
+          "Action",
+          "Version"
+        ],
+        "header": [],
+        "body": [
+          "CallbackURL",
+          "ProjectName"
+        ],
+        "files": []
+      },
+      "default_arguments": {
+        "Action": "CreateVisualValidateSession",
+        "Version": "2024-01-01"
+      },
+      "annotations": {
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "idempotentHint": false,
+        "openWorldHint": true
+      }
+    },
     {
       "name": "create_volc_compatible_seedance_task",
       "title": "Create Seedance task (Volc-compatible)",
@@ -3927,7 +3848,7 @@
                       "additionalProperties": true
                     }
                   ],
-                  "description": "Image URL. The object form {\"url\":\"https://...\"} matches the official request shape; a plain string is accepted for convenience."
+                  "description": "Image reference. The object form {\"url\":\"https://...\"} matches the official request shape; a plain string is accepted for convenience. TokenLab also accepts asset://asset-YYYYMMDDHHMMSS-xxxxx URIs for ACTIVE materials owned by the requesting organization, and preserves the item's first_frame, last_frame, or reference_image role."
                 },
                 "video_url": {
                   "oneOf": [
@@ -3997,6 +3918,12 @@
               "additionalProperties": true
             }
           },
+          "material_asset_id": {
+            "type": "string",
+            "pattern": "^asset-\\d{14}-[a-z0-9]{5}$",
+            "maxLength": 128,
+            "description": "TokenLab compatibility shorthand for one ACTIVE Seedance material owned by the requesting organization. It is treated as the first frame and cannot be combined with other media inputs. For multiple materials, use content image_url items with explicit roles; top-level material_asset_ids is rejected as ambiguous."
+          },
           "ratio": {
             "type": "string",
             "enum": [
@@ -4112,6 +4039,7 @@
         "body": [
           "model",
           "content",
+          "material_asset_id",
           "ratio",
           "duration",
           "resolution",
@@ -4685,7 +4613,7 @@
       "profiles": [
         "full"
       ],
-      "description": "Seedance Action dispatcher (POST) Dispatches Volc-style Action requests. The Action and Version fields may be in the query string or JSON body.",
+      "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.",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -4695,12 +4623,59 @@
               "CreateContentsGenerationsTasks",
               "GetContentsGenerationsTask",
               "ListContentsGenerationsTasks",
-              "DeleteContentsGenerationsTasks"
+              "DeleteContentsGenerationsTasks",
+              "CreateVisualValidateSession",
+              "GetVisualValidateResult"
             ]
           },
           "Version": {
             "type": "string",
             "default": "2024-01-01"
+          },
+          "body": {
+            "anyOf": [
+              {
+                "type": "object",
+                "required": [
+                  "CallbackURL"
+                ],
+                "properties": {
+                  "CallbackURL": {
+                    "type": "string",
+                    "format": "uri",
+                    "description": "Public HTTPS URL opened by the H5 flow after validation. Official callback query names are preserved."
+                  },
+                  "ProjectName": {
+                    "type": "string",
+                    "default": "default",
+                    "description": "Case-sensitive project name. Omit to use default."
+                  }
+                },
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "required": [
+                  "BytedToken"
+                ],
+                "properties": {
+                  "BytedToken": {
+                    "type": "string",
+                    "description": "Opaque token returned by CreateVisualValidateSession. It is valid for 30 minutes and scoped to the authenticated organization, actor, and ProjectName."
+                  },
+                  "ProjectName": {
+                    "type": "string",
+                    "default": "default",
+                    "description": "Must match the ProjectName used to create the token."
+                  }
+                },
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "additionalProperties": true
+              }
+            ]
           }
         },
         "additionalProperties": false
@@ -4712,7 +4687,9 @@
           "Version"
         ],
         "header": [],
-        "body": [],
+        "body": [
+          "body"
+        ],
         "files": []
       },
       "annotations": {
@@ -5632,6 +5609,63 @@
         "openWorldHint": true
       }
     },
+    {
+      "name": "get_visual_validate_result",
+      "title": "Get visual validation result",
+      "operation_id": "dispatchVolcCompatibleSeedanceActionPost",
+      "method": "POST",
+      "path": "/api/v3",
+      "content_type": "application/json",
+      "auth": "required",
+      "tags": [
+        "Seedance Volc Compatible"
+      ],
+      "profiles": [
+        "full"
+      ],
+      "description": "Get the mapped real-person material GroupId through the Volc-compatible Action API after the H5 validation succeeds. The operation returns the official ResponseMetadata and Result shape.",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "BytedToken": {
+            "type": "string",
+            "description": "Opaque token returned by CreateVisualValidateSession. It is valid for 30 minutes and scoped to the authenticated organization, actor, and ProjectName."
+          },
+          "ProjectName": {
+            "type": "string",
+            "default": "default",
+            "description": "Must match the ProjectName used to create the token."
+          }
+        },
+        "required": [
+          "BytedToken"
+        ],
+        "additionalProperties": false
+      },
+      "bindings": {
+        "path": [],
+        "query": [
+          "Action",
+          "Version"
+        ],
+        "header": [],
+        "body": [
+          "BytedToken",
+          "ProjectName"
+        ],
+        "files": []
+      },
+      "default_arguments": {
+        "Action": "GetVisualValidateResult",
+        "Version": "2024-01-01"
+      },
+      "annotations": {
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      }
+    },
     {
       "name": "get_volc_compatible_seedance_task",
       "title": "Get Seedance task (Volc-compatible)",
@@ -6137,7 +6171,7 @@
       "profiles": [
         "full"
       ],
-      "description": "List Seedance material asset groups Lists Seedance material groups owned by the authenticated organization. Real-person groups are returned after a successful verification bind flow.",
+      "description": "List Seedance material asset groups Lists Seedance material groups owned by the authenticated organization. Real-person groups are returned after GetVisualValidateResult succeeds.",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -6258,55 +6292,6 @@
         "openWorldHint": true
       }
     },
-    {
-      "name": "list_seedance_visual_validation_history",
-      "title": "List Seedance real-person verification history",
-      "operation_id": "listSeedanceVisualValidationHistory",
-      "method": "GET",
-      "path": "/v1/videos/assets/visual-validation-sessions",
-      "content_type": null,
-      "auth": "required",
-      "tags": [
-        "Video"
-      ],
-      "profiles": [
-        "full"
-      ],
-      "description": "List Seedance real-person verification history Lists TokenLab real-person material verification history for the authenticated organization. The response contains only TokenLab IDs and session status fields.",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "page_size": {
-            "type": "integer",
-            "minimum": 1,
-            "maximum": 100,
-            "default": 20,
-            "description": "Maximum number of history records to return."
-          },
-          "page_token": {
-            "type": "string",
-            "description": "Pagination token from a previous response."
-          }
-        },
-        "additionalProperties": false
-      },
-      "bindings": {
-        "path": [],
-        "query": [
-          "page_size",
-          "page_token"
-        ],
-        "header": [],
-        "body": [],
-        "files": []
-      },
-      "annotations": {
-        "readOnlyHint": true,
-        "destructiveHint": false,
-        "idempotentHint": true,
-        "openWorldHint": true
-      }
-    },
     {
       "name": "list_volc_compatible_seedance_tasks",
       "title": "List Seedance tasks (Volc-compatible)",

package/package.json

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