kling-mcp

motion_control

Create a Kling motion control task by submitting a source image and reference video, returning task ID, status, and output URLs.

Instructions

Create a Kling task on RunAPI (motion control). Returns a task id, status, and output URLs.

Input Schema

TableJSON Schema

Name	Required	Description
`wait`	No	Poll until the task reaches a terminal status.
`model`	No	RunAPI model slug for this model line.
`prompt`	No	Description prompt. Declared type: string.
`timeout_ms`	No
`callback_url`	No	Webhook URL for async notifications. Declared type: string.
`poll_interval_ms`	No
`source_image_url`	Yes	Subject image URL. Declared type: string.
`background_source`	No	Background source. Declared type: string. Known values: "video", "image".
`output_resolution`	Yes	Output resolution. Declared type: string. Known values: "720p", "1080p".
`reference_video_url`	Yes	Reference motion video URL. Declared type: string.
`character_orientation`	No	Character orientation. Declared type: string. Known values: "video", "image".

Schema Changelog

Changes observed during successful MCP inspections.

Changed15 schema fields changedv0.3.0Oct 1, 2026

addedInput schema / additionalProperties
```
Added value: +{}
```

removedInput schema / properties / background_source / anyOf

Removed value: -[
-  {
-    "const": "video",
-    "type": "string"
-  },
-  {
-    "const": "image",
-    "type": "string"
-  }
-]

changedInput schema / properties / background_source / description

Previous value: -"Background source."New value: +"Background source. Declared type: string. Known values: \"video\", \"image\"."

addedInput schema / properties / background_source / type
```
Added value: +"string"
```

changedInput schema / properties / callback_url / description

Previous value: -"Webhook URL for async notifications."New value: +"Webhook URL for async notifications. Declared type: string."

removedInput schema / properties / character_orientation / anyOf

Removed value: -[
-  {
-    "const": "video",
-    "type": "string"
-  },
-  {
-    "const": "image",
-    "type": "string"
-  }
-]

changedInput schema / properties / character_orientation / description

Previous value: -"Character orientation."New value: +"Character orientation. Declared type: string. Known values: \"video\", \"image\"."

addedInput schema / properties / character_orientation / type
```
Added value: +"string"
```

removedInput schema / properties / model / enum

Removed value: -[
-  "kling-3.0",
-  "kling-v2.6"
-]

removedInput schema / properties / output_resolution / anyOf

Removed value: -[
-  {
-    "const": "720p",
-    "type": "string"
-  },
-  {
-    "const": "1080p",
-    "type": "string"
-  }
-]

changedInput schema / properties / output_resolution / description

Previous value: -"Output resolution."New value: +"Output resolution. Declared type: string. Known values: \"720p\", \"1080p\"."

addedInput schema / properties / output_resolution / type
```
Added value: +"string"
```

changedInput schema / properties / prompt / description

Previous value: -"Description prompt."New value: +"Description prompt. Declared type: string."

changedInput schema / properties / reference_video_url / description

Previous value: -"Reference motion video URL."New value: +"Reference motion video URL. Declared type: string."

changedInput schema / properties / source_image_url / description

Previous value: -"Subject image URL."New value: +"Subject image URL. Declared type: string."

Changed13 schema fields changedv0.2.0Sep 30, 2026

removedInput schema / additionalProperties
```
Removed value: -false
```

addedInput schema / properties / background_source / anyOf

Added value: +[
+  {
+    "const": "video",
+    "type": "string"
+  },
+  {
+    "const": "image",
+    "type": "string"
+  }
+]

removedInput schema / properties / background_source / enum
```
Removed value: -[
-  "video",
-  "image"
-]
```
removedInput schema / properties / background_source / type
```
Removed value: -"string"
```

addedInput schema / properties / character_orientation / anyOf

Added value: +[
+  {
+    "const": "video",
+    "type": "string"
+  },
+  {
+    "const": "image",
+    "type": "string"
+  }
+]

removedInput schema / properties / character_orientation / enum
```
Removed value: -[
-  "video",
-  "image"
-]
```
removedInput schema / properties / character_orientation / type
```
Removed value: -"string"
```

addedInput schema / properties / output_resolution / anyOf

Added value: +[
+  {
+    "const": "720p",
+    "type": "string"
+  },
+  {
+    "const": "1080p",
+    "type": "string"
+  }
+]

removedInput schema / properties / output_resolution / enum
```
Removed value: -[
-  "720p",
-  "1080p"
-]
```
removedInput schema / properties / output_resolution / type
```
Removed value: -"string"
```
addedInput schema / properties / poll_interval_ms / maximum
```
Added value: +9007199254740991
```
addedInput schema / properties / timeout_ms / maximum
```
Added value: +9007199254740991
```

changedInput schema / required

Previous value: -[
-  "source_image_url",
-  "reference_video_url"
-]New value: +[
+  "source_image_url",
+  "reference_video_url",
+  "output_resolution"
+]

Changed8 schema fields changedv0.1.13Jul 29, 2026
- addedInput schema / properties / background_source / description
```
Added value: +"Background source."
```
- addedInput schema / properties / callback_url / description
```
Added value: +"Webhook URL for async notifications."
```
- addedInput schema / properties / character_orientation / description
```
Added value: +"Character orientation."
```
- changedInput schema / properties / model / enum
```
Previous value: -[
-  "kling-3.0"
-]New value: +[
+  "kling-3.0",
+  "kling-v2.6"
+]
```
- addedInput schema / properties / output_resolution / description
```
Added value: +"Output resolution."
```
- addedInput schema / properties / prompt / description
```
Added value: +"Description prompt."
```
- addedInput schema / properties / reference_video_url / description
```
Added value: +"Reference motion video URL."
```
- addedInput schema / properties / source_image_url / description
```
Added value: +"Subject image URL."
```
Changed5 schema fields changedv0.1.2Jun 23, 2026
- addedInput schema / properties / callback_url / type
```
Added value: +"string"
```
- addedInput schema / properties / prompt / type
```
Added value: +"string"
```
- addedInput schema / properties / reference_video_url / type
```
Added value: +"string"
```
- addedInput schema / properties / source_image_url / type
```
Added value: +"string"
```
- addedInput schema / required
```
Added value: +[
+  "source_image_url",
+  "reference_video_url"
+]
```
First observedv0.1.1Jun 23, 2026

TDQS

C2.9/5.0

Behavior2/5

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

With no annotations, the description carries the full behavioral burden yet only discloses the return shape. It omits that this is an async generation job, that 'wait' defaults to polling, whether it costs credits, and how timeouts/callbacks behave — all of which are behavioral traits an agent must know.

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?

Two short sentences, front-loaded with the action and resource, followed by the return shape. No waste, though it is arguably under-specified rather than efficiently complete.

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

Completeness3/5

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

For an 11-parameter async generation tool with no annotations and no output schema, the description partially compensates by naming the return values (task id, status, output URLs). However it leaves usage, polling behavior, and cost/auth context unaddressed.

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 82%, so the schema already documents most parameters (including the three required URLs and enum-like known values). The description adds no parameter meaning beyond what the schema provides, which is the baseline 3 for high coverage.

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

Purpose4/5

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

States a specific verb and resource: 'Create a Kling task on RunAPI (motion control)'. The purpose is clear, but it does not differentiate from siblings like image_to_video, text_to_video, or edit_video, which are also task-creating tools on the same platform.

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

Usage Guidelines2/5

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

No when-to-use guidance is given. The '(motion control)' parenthetical hints that a source image and reference video drive motion, but the description never says when to choose this over image_to_video or text_to_video, nor does it state prerequisites or exclusions.

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

Deploy Server

motion_control

Instructions

Input Schema

Schema Changelog

TDQS

Other Tools