Skip to main content
Glama

Why This Package?

@runapi.ai/kling-mcp is a focused Model Context Protocol server for the Kling model line on RunAPI. It gives MCP-compatible assistants direct access to 6 endpoints and 16 model variants without loading the full RunAPI catalog.

Use this per-model server when an agent should stay scoped to Kling. Use @runapi.ai/mcp when one assistant should discover every RunAPI model line.

kling-ai-avatar-v1-pro was retired on 2026-10-14T00:00:00Z. New requests return HTTP 410 before task creation or balance deduction. Existing tasks can still be queried. This model ID is not mapped to another model.

kling-v1-avatar-standard was retired on 2026-10-14T00:00:00Z. New requests return HTTP 410 before task creation or balance deduction. Existing tasks can still be queried. This model ID is not mapped to another model.


Related MCP server: @runapi.ai/elevenlabs-mcp

Install

Add it to Claude Code:

claude mcp add kling -s user -- npx -y @runapi.ai/kling-mcp

Use project scope when the server should be shared with a repository:

claude mcp add kling -s project -- npx -y @runapi.ai/kling-mcp

Codex, Cursor, Windsurf, VS Code, Roo Code, and other MCP hosts can use the same stdio command:

{
  "mcpServers": {
    "kling": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/kling-mcp"]
    }
  }
}

check_pricing works before sign-in. For task creation and status polling, ask your assistant to call the login tool. It opens a browser login and saves credentials to ~/.config/runapi/config.json, the same file used by runapi login. Headless and CI hosts can still set RUNAPI_API_KEY before starting the MCP host.

Ready-made examples are in examples/ for Claude, Cursor, Windsurf, VS Code, and Roo Code.


Tools

Tool

Auth

Purpose

ai_avatar

Yes

Create a Kling ai avatar task and optionally wait for a terminal status. Returns the task id, status, and output URLs.

edit_video

Yes

Create a Kling edit video task and optionally wait for a terminal status. Returns the task id, status, and output URLs.

extend_video

Yes

Create a Kling extend video task and optionally wait for a terminal status. Returns the task id, status, and output URLs.

image_to_video

Yes

Create a Kling image to video task and optionally wait for a terminal status. Returns the task id, status, and output URLs.

motion_control

Yes

Create a Kling motion control task and optionally wait for a terminal status. Returns the task id, status, and output URLs.

text_to_video

Yes

Create a Kling text to video task and optionally wait for a terminal status. Returns the task id, status, and output URLs.

get_task

Yes

Fetch the current status and latest payload for an existing task.

check_pricing

No

Look up current pricing for a Kling model and endpoint.


Models

Kling covers 16 model variants across 6 endpoints. Each tool accepts the models listed for it:

Tool

Models

ai_avatar

kling-ai-avatar-pro, kling-ai-avatar-standard

edit_video

kling-v3-omni-edit, kling-v3-omni-reference

extend_video

kling-v2.5-turbo-image-to-video-pro, kling-v2.5-turbo-text-to-video-pro

image_to_video

kling-o1, kling-v2.1-master-image-to-video, kling-v2.1-pro, kling-v2.1-standard, kling-v2.5-turbo-image-to-video-pro, kling-v2.6, kling-v3-omni, kling-v3-turbo-image-to-video

motion_control

kling-3.0, kling-v2.6

text_to_video

kling-3.0, kling-o1, kling-v2.1-master-text-to-video, kling-v2.5-turbo-text-to-video-pro, kling-v2.6, kling-v3-omni, kling-v3-omni-reference, kling-v3-turbo-text-to-video

Model availability can change between releases. Use check_pricing or the Kling model page for the current catalog view.


Agent Prompts

Ask your assistant in natural language; it can inspect pricing, create the task, and return the task id plus output URLs.

Create a task

Run a Kling ai avatar task with RunAPI.

The assistant can call check_pricing, then ai_avatar, and return the task id, status, and output URLs.

Submit without waiting

Create the task but don't wait for it to finish.

The assistant calls the create tool with wait: false and returns the task id. Check on it later with get_task.

Check pricing before creating

Check current Kling pricing, then create the task if it matches my request.

The assistant calls check_pricing and can link to the Kling model page for the canonical catalog entry.


Configuration

The server resolves auth in this order:

  1. RUNAPI_API_KEY environment variable, useful for headless and CI hosts

  2. ~/.config/runapi/config.json, created by the MCP login tool or runapi login

  3. No key, which still allows check_pricing

The config file is normally managed by login. A pre-provisioned headless config can use:

{
  "apiKey": "your_runapi_key"
}

Do not commit real API keys.


Resource

URL

Kling model page

https://runapi.ai/models/kling

npm package

@runapi.ai/kling-mcp

GitHub repository

runapi-ai/kling-mcp

RunAPI MCP overview

runapi.ai/mcp

RunAPI docs

runapi.ai/docs


License

Licensed under the Apache License, Version 2.0.

Available Tools

9 tools
ai_avatarC

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

Inputs: prompt (required), source_audio_url (required), source_image_url (required), wait, +4 more.

check_pricingC

Look up RunAPI pricing for the kling model line.

Inputs: model, action.

edit_videoC

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

Inputs: prompt (required), wait, model, timeout_ms, +9 more.

extend_videoC

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

Inputs: source_task_id (required), mode, wait, model, +4 more.

get_taskB

Fetch the current status and latest result payload for a kling task.

Inputs: action (required), task_id (required).

image_to_videoB

Create a Kling task on RunAPI (image to video). Returns a task id, status, and output URLs.

Inputs: prompt (required), first_frame_image_url (required), mode, wait, +15 more.

loginA

Authenticate RunAPI by opening a browser PKCE login flow and saving the API key to ~/.config/runapi/config.json.

Inputs: force.

motion_controlB

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

Inputs: source_image_url (required), output_resolution (required), reference_video_url (required), wait, +6 more.

text_to_videoB

Create a Kling task on RunAPI (text to video). Returns a task id, status, and output URLs.

Inputs: mode, wait, model, prompt, +19 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 9 tools

    Disambiguation4/5

    The generation tools (text_to_video, image_to_video, motion_control, ai_avatar, edit_video, extend_video) share near-identical descriptions differing only by the parenthetical task type, but their names clearly signal distinct modalities. login, get_task, and check_pricing are cleanly separate. Only mild overlap between the many generation variants.

    Naming Consistency4/5

    Nearly all names use snake_case, and the generation tools follow a consistent verb/resource-to-resource pattern. Slight inconsistency between imperative verbs (login, get_task, check_pricing) and the descriptive generation names, but nothing confusing.

    Tool Count5/5

    Nine tools is well-scoped for a video-generation API: one auth, one status lookup, one pricing, and six distinct generation modes. Each tool earns its place.

    Completeness3/5

    The surface covers auth, all major generation modes, task lookup, and pricing, but lacks task lifecycle management such as listing tasks, canceling, or deleting a task. Agents can poll get_task but cannot enumerate or abort tasks.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers