mcp.film

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

Kie.ai MCP Server

Communityby Community (felores) / Kie.ai APIcreditsverified Aug 24, 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_KEYhttps://kie.ai/api-key

Tools you'll see

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 5.0.0 published Aug 23 2026, pushed Aug 24 2026, 60 stars — two breaking releases since the last check, so re-read the README before reusing old configs. 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.

Pairs well with