mcp.film

mcp.film / Model Hubs / Kie.ai MCP Server

Kie.ai MCP Server

Communityby Community (felores) / Kie.ai APIcreditsverified Oct 4, 2026

Run Veo, Seedance, Kling, Runway, Suno, ElevenLabs, FLUX and more through one local MCP.

What it does

Community MCP server and sibling CLI for Kie.ai's media API, covering image, video, music and speech models from one connector — 38 tools across image, video, audio and task utilities. Since v4 it no longer fires generations directly: the agent drafts a plan with prepare_media_generation, a human approves it, and submit_media_generation spends the credits. For filmmaker-agents that buys a spend checkpoint in front of a broad model shelf, at the cost of an extra round trip per shot.

Connect

Claude Code
claude mcp add kie-ai -e KIE_AI_API_KEY=YOUR_KEY -- npx -y @felores/kie-ai-mcp-server
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "kie-ai": {
      "command": "npx",
      "args": [
        "-y",
        "@felores/kie-ai-mcp-server"
      ],
      "env": {
        "KIE_AI_API_KEY": "YOUR_KEY_HERE"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "kie-ai": {
      "command": "npx",
      "args": [
        "-y",
        "@felores/kie-ai-mcp-server"
      ],
      "env": {
        "KIE_AI_API_KEY": "YOUR_KEY_HERE"
      }
    }
  }
}
Auth: api_key · env KIE_AI_API_KEY — https://kie.ai/api-key

Sample tools

prepare_media_generationsubmit_media_generationnano_banana_imageveo3_generate_videobytedance_seedance_videokling_videorunway_aleph_videosuno_generate_musicelevenlabs_ttslist_modelswait_for_tasklist_tasks

Field notes

MIT, npm @felores/kie-ai-mcp-server still 5.0.0 (Aug 23 2026), Node >=20, 79 stars. The repo was last pushed Aug 26 2026 — Wan 3.0 support and a separate @felores/kie-ai-openai-server package (a loopback HTTP server with OpenAI-shaped image/video routes, not MCP) landed in the monorepo but not in a new MCP release, and it has been quiet for five weeks since. v4.0.0 (Aug 18) disabled direct media tool calls by default in favour of approval-bound plans: prepare_media_generation validates and creates no provider task, a host confirmation form or `kie-cli --approve <plan-id>` clears it, then submit_media_generation runs it. Set KIE_AI_ALLOW_DIRECT_GENERATION=true to restore the old one-shot behaviour, which is what unattended agents will need. v5.0.0 moved to the split SDK v2 packages and raised the floor to Node >=20 (npm engines; the release notes say the same), returns failures as isError with structuredContent, and gates official MCP Tasks behind KIE_AI_MCP_TASKS=true. Stdio by default, but v5 ships first-class HTTP: MCP_TRANSPORT=http or --http, with MCP_HTTP_HOST/MCP_HTTP_PORT and an optional KIE_MCP_HTTP_TOKEN bearer — self-hosted only via the Dockerfile and Coolify compose, there is no vendor-hosted URL. Filter the 38 tools with KIE_AI_ENABLED_TOOLS, KIE_AI_TOOL_CATEGORIES=image,video or KIE_AI_DISABLED_TOOLS (that precedence order) or you will burn context on unused schemas. Caveat: Kie.ai is an aggregator/reseller path for models from many vendors; rights, availability and ToS safety depend on the underlying provider, and Midjourney/Suno-style access should be treated as gray until verified for your use case.

Also in Model Hubs

Used in

Model Shootout · Compare video and image models before spending the budget

Pairs well with