Clip Studio MCP

quote_video_lab

Read-only

Quote a Video Lab setup. Does not generate or charge. Paid generate needs this quote. FLUX 3 Edit clip uses mode=edit_video plus a source MP4 (sourceAssetIds, sourceClipId, or sourceVideoUrl). Duration and aspect follow the source; output is 720p. Keeps the source clip’s audio. Clips must be MP4, under 15 seconds and 50 MB.

Input Schema

TableJSON Schema

Name	Required	Description
`fps`	No	Frames per second when the catalog lists that control.
`mode`	No	Input mode: text_to_video, image_to_video, first_last_frame, reference_to_video, or edit_video (FLUX 3 Edit clip). Must be supported by the chosen model.
`seed`	No	Seed when the catalog lists that control.
`style`	No	Style id when the catalog lists that control. Omit or none for the default look.
`prompt`	Yes	What to film. At least 3 characters, up to 8,192 UTF-8 bytes. For edit_video, describe the change to the source clip.
`inputMode`	No	Same as mode: text_to_video, image_to_video, first_last_frame, reference_to_video, or edit_video.
`modelSlug`	Yes	Video Lab model slug from list_video_lab_models (for example seedance-2-5, minimax-h3, grok-imagine-video-1-5).
`multiShot`	No	Multi-shot / intelligent shot type when the catalog lists that control.
`resolution`	No	Output resolution from the model catalog (720p, 1080p, and other listed values). edit_video is 720p.
`aspectRatio`	No	Frame size from the model catalog (21:9, 16:9, 9:16, 1:1, and other listed ratios). edit_video keeps the source clip’s aspect.
`audioEnabled`	No	Whether the model should generate native audio, when the catalog lists audio as optional. edit_video keeps the source clip’s audio.
`sourceClipId`	No	Library clip id to import as the edit_video source MP4 when you do not already have a generation-asset id.
`klingElements`	No	Kling 3 Pro / Kling 3 4K subject packs. Each element needs a frontal still and supporting references. The first primary still is the start frame when startImageAssetId is omitted. Do not send leftover stills as sourceAssetIds references on those models.
`negativePrompt`	No	Negative prompt when list_video_lab_models lists that control for the mode.
`sourceAssetIds`	No	Generation-asset ids from complete_generation_asset. Start/end/reference stills, or sourceAssetIds[0] as the edit_video MP4.
`sourceVideoUrl`	No	Public MP4 URL to import as the edit_video source when you do not have a library clip or asset id. Under 15 seconds and 50 MB.
`durationSeconds`	No	Clip length in seconds. Must be in the chosen model’s duration range. edit_video takes duration from the source MP4.
`endImageAssetId`	No	End-frame generation-asset id. Same as sourceAssetIds[1] for first_last_frame.
`promptEnhancement`	No	Prompt expansion when the catalog lists that control. false maps to fal disabled on MiniMax H3 and H3 Max.
`startImageAssetId`	No	Start-frame generation-asset id. Same as sourceAssetIds[0] for image_to_video and first_last_frame.
`sourceVideoAssetId`	No	Source MP4 generation-asset id for edit_video. Same as sourceAssetIds[0] for that mode.
`referenceImageAssetIds`	No	Reference stills for reference_to_video. Do not send leftover stills here on Kling 3 Pro / Kling 3 4K when klingElements is set.

Output Schema

TableJSON Schema

Name	Required	Description
`credits`	No	Usage this quote would consume from this month’s generation allowance (internal units).
`quoteId`	Yes	Quote id. Pass this to the matching generate tool. Quotes expire.
`expiresAt`	No	ISO timestamp when this quote expires.
`normalizedInput`	No	Normalized Video Lab setup this quote locked in.

Schema Changelog

Changes observed during successful MCP inspections.

Changed15 schema fields changedSep 27, 2026

addedInput schema / properties / endImageAssetId

Added value: +{
+  "description": "End-frame generation-asset id. Same as sourceAssetIds[1] for first_last_frame.",
+  "type": "string"
+}

addedInput schema / properties / fps

Added value: +{
+  "description": "Frames per second when the catalog lists that control.",
+  "type": "number"
+}

addedInput schema / properties / inputMode

Added value: +{
+  "description": "Same as mode: text_to_video, image_to_video, first_last_frame, reference_to_video, or edit_video.",
+  "type": "string"
+}

addedInput schema / properties / klingElements

Added value: +{
+  "description": "Kling 3 Pro / Kling 3 4K subject packs. Each element needs a frontal still and supporting references. The first primary still is the start frame when startImageAssetId is omitted. Do not send leftover stills as sourceAssetIds references on those models.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "primaryImageAssetId": {
+        "description": "Frontal still generation-asset id from complete_generation_asset.",
+        "type": "string"
+      },
+      "referenceImageAssetIds": {
+        "description": "Supporting stills for this Kling subject.",
+        "items": {
+          "description": "Supporting still generation-asset id.",
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "primaryImageAssetId"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedInput schema / properties / modelSlug / description

Previous value: -"Video Lab model slug from list_video_lab_models (for example seedance-2-0, minimax-h3, grok-imagine-1-5)."New value: +"Video Lab model slug from list_video_lab_models (for example seedance-2-5, minimax-h3, grok-imagine-video-1-5)."

addedInput schema / properties / multiShot

Added value: +{
+  "description": "Multi-shot / intelligent shot type when the catalog lists that control.",
+  "type": "boolean"
+}

addedInput schema / properties / negativePrompt

Added value: +{
+  "description": "Negative prompt when list_video_lab_models lists that control for the mode.",
+  "type": "string"
+}

changedInput schema / properties / prompt / description

Previous value: -"What to film. Up to 8,192 UTF-8 bytes. For edit_video, describe the change to the source clip."New value: +"What to film. At least 3 characters, up to 8,192 UTF-8 bytes. For edit_video, describe the change to the source clip."

addedInput schema / properties / prompt / minLength
```
Added value: +3
```

addedInput schema / properties / promptEnhancement

Added value: +{
+  "description": "Prompt expansion when the catalog lists that control. false maps to fal disabled on MiniMax H3 and H3 Max.",
+  "type": "boolean"
+}

addedInput schema / properties / referenceImageAssetIds

Added value: +{
+  "description": "Reference stills for reference_to_video. Do not send leftover stills here on Kling 3 Pro / Kling 3 4K when klingElements is set.",
+  "items": {
+    "description": "Reference still generation-asset id.",
+    "type": "string"
+  },
+  "type": "array"
+}

addedInput schema / properties / seed

Added value: +{
+  "description": "Seed when the catalog lists that control.",
+  "type": "number"
+}

addedInput schema / properties / sourceVideoAssetId

Added value: +{
+  "description": "Source MP4 generation-asset id for edit_video. Same as sourceAssetIds[0] for that mode.",
+  "type": "string"
+}

addedInput schema / properties / startImageAssetId

Added value: +{
+  "description": "Start-frame generation-asset id. Same as sourceAssetIds[0] for image_to_video and first_last_frame.",
+  "type": "string"
+}

addedInput schema / properties / style

Added value: +{
+  "description": "Style id when the catalog lists that control. Omit or none for the default look.",
+  "type": "string"
+}

First observedSep 20, 2026

TDQS

A4.1/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, destructiveHint=false, so the safety profile is covered. The description still adds real context beyond them: the financial distinction ('does not charge'), the edit_video mode's input requirements, and the MP4/<15s/<50MB acceptance limits for source clips.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded correctly: purpose, then the no-charge/no-generate boundary, then the prerequisite, then mode-specific detail. Dense but every sentence is on-topic; the edit_video block partially duplicates schema text, which is the only mild waste.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need no explanation. For a 22-parameter tool with only 2 required, the description covers the quote's role and the trickiest mode (edit_video) adequately, though it says nothing about the other modes (first_last_frame, reference_to_video) or model/Kling-specific input combinations.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The description's edit_video guidance (duration, aspect, 720p, audio all follow the source; source may come from sourceAssetIds, sourceClipId, or sourceVideoUrl) largely restates what the individual parameter descriptions already say, adding only slight connective value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Quote a Video Lab setup') and immediately bounds it ('Does not generate or charge'), which cleanly separates it from generate_video_lab and the other quote_* siblings. The sibling relationship is made explicit: 'Paid generate needs this quote.'

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives a clear precondition for use — the quote must precede a paid generate — which tells the agent where this tool sits in the workflow. It does not name generate_video_lab directly or state when a quote is unnecessary, so it stops short of full when/when-not routing.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Clip Studio MCP tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?