# kie-mcp

Wires kie.ai into your coding agent so it can generate images, video and audio from chat, picking a model for the job and showing what it costs.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Author: elibarnett
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/elibarnett/kie-mcp
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/kie-mcp

## What it does

kie-mcp is an MCP server that sits on top of the kie.ai API. Your agent gets a catalogue of image, video and audio models, and each entry carries a credit and USD price, notes on where the model is weak, prompt tactics and comparisons against rivals. Ask which option is cheapest for lip sync and it answers.

Version 5.0 added vertical profiles. There are ten of them, covering architecture and interiors, game assets, advertising, product photography, branding, short-form social video, audio branding and more. A profile hands back the questions a specialist would ask, a routing table per deliverable with live costs, and prompt formulas. In Claude the profiles double as slash commands, for instance `/kie-art:architecture`.

You need Node.js 18+ and a kie.ai API key. Two transports are supported: stdio for local use and HTTP Streamable for remote clients. HTTP mode wants a bearer token and binds to `127.0.0.1` by default. Guard that token like a password, since whoever holds it can burn your kie credits and pull media off the server's disk.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `KIE_API_KEY`, `KIE_PROJECT_ROOT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env KIE_API_KEY=<KIE_API_KEY> --env KIE_PROJECT_ROOT=<KIE_PROJECT_ROOT> --transport stdio kie-mcp -- npx -y kie-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add kie-mcp --env KIE_API_KEY=<KIE_API_KEY> --env KIE_PROJECT_ROOT=<KIE_PROJECT_ROOT> -- npx -y kie-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kie-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "kie-mcp"
            ],
            "env": {
                "KIE_API_KEY": "<KIE_API_KEY>",
                "KIE_PROJECT_ROOT": "<KIE_PROJECT_ROOT>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "kie-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "kie-mcp"
            ],
            "env": {
                "KIE_API_KEY": "<KIE_API_KEY>",
                "KIE_PROJECT_ROOT": "<KIE_PROJECT_ROOT>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e KIE_API_KEY=<KIE_API_KEY> -e KIE_PROJECT_ROOT=<KIE_PROJECT_ROOT> kie-mcp npx -y kie-mcp
```
Replace <…> with your own values

## When to use it
- generate a text-heavy layout image without testing models by hand
- turn a scene description into a short clip
- find a model that lip-syncs to an existing audio track
- upscale footage to 4K
- recolour a wall in a room photo

## Example prompts
- Generate a brand presentation board for a perfume launch
- Lip-sync this audio to my character image

## Similar
- [mediagen](https://affpapa.org/en/nevibecode/mcp/mediagen.md) — MCP server · ★ 51
- [lovart-api](https://affpapa.org/en/nevibecode/skills/lovart-api.md) — skill · 1400 installs
- [fal-kling-o3](https://affpapa.org/en/nevibecode/skills/fal-kling-o3.md) — skill · 2700 installs
- [cinematography](https://affpapa.org/en/nevibecode/skills/cinematography.md) — skill · 1100 installs
- [muapi-media-generation](https://affpapa.org/en/nevibecode/skills/muapi-media-generation.md) — skill · 1100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md