kie-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KIE_API_KEY | Yes | Your kie.ai API key | |
| KIE_MCP_PORT | No | Port for HTTP mode (default: 3100) | |
| KIE_CALLBACK_URL | No | Callback URL sent with Suno generation requests (kie.ai requires the field; results are fetched by polling regardless). Defaults to an inert placeholder — set this only if you want to receive the callbacks yourself | |
| KIE_PROJECT_ROOT | No | Server-wide default for where generated files are saved (default: server cwd; files go to $KIE_PROJECT_ROOT/kie/assets/raw/). Per-call download_dir (absolute path) on any file-writing tool overrides this | |
| KIE_MAX_CONCURRENT | No | Max simultaneous task-creation calls (default 4). Excess parallel generations queue inside the server instead of hitting kie.ai's rate limits — parallel tool calls are safe | |
| KIE_POLL_BUDGET_AUDIO | No | Blocking-mode polling budget for audio tools, in seconds (default: 300) | |
| KIE_POLL_BUDGET_IMAGE | No | Blocking-mode polling budget for image tools, in seconds (default: 600) | |
| KIE_POLL_BUDGET_VIDEO | No | Blocking-mode polling budget for video tools, in seconds (default: 900) | |
| KIE_POLL_BUDGET_SPEECH | No | Blocking-mode polling budget for speech tools, in seconds (default: 300) |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| generate_imageA | Generate an image using kie.ai (47+ models). Downloads to kie/assets/raw/. MODEL GUIDE: Architecture/blueprints→gpt4o or nano-banana-2 (reasoning). Game art/3D→seedream/4.5 or 5-lite. Character sheets→ideogram/character. Text/logos→ideogram/v3 (best text). Photo editing→flux-kontext-pro. Anime→qwen (3cr cheapest). Fast drafts→nano-banana-2-lite (4cr, ~4s, NEW). Upscale→recraft/crisp-upscale (2cr). BG removal→recraft/remove-background. Cheapest→z-image,qwen (3cr). Best quality→nano-banana-pro (24cr), flux-kontext-max (100cr). Use list_models filter="use-case" to explore. |
| list_modelsA | List all available kie.ai models with their aspect ratios and model-specific options |
| check_taskA | Check the status of a kie.ai generation task by taskId |
| list_tasksB | List recent image generation tasks from this session |
| check_creditsB | Check remaining kie.ai account credits |
| download_resultC | Download a completed task result to kie/assets/raw/ |
| list_raw_assetsA | List all files in kie/assets/raw/ waiting to be processed |
| generate_videoA | Generate a video using kie.ai (86+ models). Downloads to kie/assets/raw/. MODEL GUIDE: Best cinematic→veo-3/text-to-video (50cr/s, audio). Fast+cheap→grok-imagine-video-1-5-preview (1.6-3cr/s, audio, NEW), wan/flash-image-to-video (2cr/s). Budget cinematic→hailuo-standard (4cr/s). Budget multimodal refs→bytedance/seedance-2-mini (9.5cr/s @480p). 30s single takes→bytedance/seedance-2-5 (NEW). Budget all-rounder w/ audio+templates+extend→pixverse-v6 family (4-9.6cr/s, NEW; I2V is its strength; transition=first/last-frame morph). Multilingual lip-synced dialogue→happyhorse-1-1 T2V/I2V/R2V (NEW). Fast Kling→kling/v3-turbo (18cr/s, audio, NEW). Image-to-video→veo-3/image-to-video, kling/image-to-video. Avatar/talking head→omnihuman-1-5 (premium, NEW), kling/ai-avatar-pro, infinitalk/from-audio. Re-dub existing footage→volcengine/video-to-video-lip-sync (8cr/s, NEW). Motion control→kling/motion-control, wan/animate-move. Extend video→use veo_extend or runway_extend tools. NOTE: Sora 2 family is paused upstream by kie.ai (June 2026) — not usable. Use list_models filter="use-case" to explore. |
| generate_musicA | Generate music using Suno via kie.ai. Supports V5.5 (custom style), V5 (best quality), V4.5+, V4.5, V4. Up to 8 minutes. Great for game music stems, ambient tracks, and jingles. Polls until done and downloads to kie/assets/raw/. |
| generate_sfxA | Generate a sound effect from text via Suno V5 (kie.ai removed the ElevenLabs sound-effect model). Great for game sounds: UI clicks, magic spells, item pickups, explosions. For loop/BPM/key control use generate_sounds instead. Downloads to kie/assets/raw/. |
| generate_gemini_ttsA | NEW — Google Gemini native TTS via kie.ai: style-directed speech from natural-language direction, 30 named voices, up to 2 speakers, inline tone tags like [whispers]/[laughs] (flash model). ~4.2 credits per MINUTE of audio — cheaper than all ElevenLabs tiers. Simple mode: pass text (+ optional voice_name). Dialogue mode: pass speakers + dialogue_turns. model=flash is most expressive (keep expected audio <60s — quality degrades on long takes); model=pro is more stable for multi-minute narration. Downloads to kie/assets/raw/. |
| generate_ttsA | Generate speech from text using ElevenLabs via kie.ai. Supports Turbo 2.5 (fast) and Multilingual V2 (high quality). Downloads to kie/assets/raw/. |
| generate_dialogueA | Generate multi-speaker dialogue using ElevenLabs Text-to-Dialogue V3 via kie.ai. Great for conversations between characters. Downloads to kie/assets/raw/. |
| audio_isolationB | Isolate vocals or audio from background noise using ElevenLabs via kie.ai. Input an audio URL, get clean isolated audio back. |
| extend_musicA | Extend/continue an existing Suno track from a specific point. Requires audioId from a previous generate_music task. |
| cover_audioB | Create an AI cover from uploaded audio — custom vocals, style, and instrumentation via Suno. |
| add_instrumentalB | Add instrumental backing to uploaded vocal audio via Suno. |
| add_vocalsC | Add AI vocals to uploaded instrumental audio via Suno. |
| replace_sectionC | Replace a time range in a Suno track with new AI-generated content. |
| generate_lyricsB | Generate song lyrics from a prompt using Suno AI (max 200 characters). Returns text, no file download. |
| convert_to_wavC | Convert a Suno track to lossless WAV format. Downloads to kie/assets/raw/. |
| separate_vocalsB | Separate vocals from instrumentals, or split into individual stems. Downloads to kie/assets/raw/. |
| generate_midiA | Export a Suno track to MIDI notation. Downloads .mid file to kie/assets/raw/. |
| create_music_videoB | Generate an MP4 music video visualization from a Suno track. Downloads to kie/assets/raw/. |
| generate_soundsC | Generate loopable sound effects with BPM, key, and loop control via Suno. Downloads to kie/assets/raw/. |
| generate_personaA | NEW — Create a Suno Persona (reusable music character) from an existing Suno track. Requires taskId from V3.6+ generation. |
| generate_mashupB | NEW — Mashup up to 2 Suno tracks into one new track. Provide audioIds from previous generations. |
| boost_styleA | NEW — Convert concise style input (e.g. "Pop, Mysterious") into enhanced style description for music generation. |
| prepare_voice_cloneA | EXPERIMENTAL (#20) — STEP 1 of Suno custom-voice cloning (FREE). Submit a clean vocal sample; polls to |
| create_voice_cloneA | EXPERIMENTAL (#20) — STEP 2 — after the voice owner records the verification phrase from prepare_voice_clone, submit that recording to finish the voice. On success returns a voiceId usable in generate_music. Unverified end-to-end. |
| regenerate_voice_cloneB | EXPERIMENTAL (#20) — retry a failed/incomplete custom-voice task by its task_id. |
| get_timestamped_lyricsA | NEW — Get word-level timestamped lyrics from a Suno track. Useful for karaoke, captioning, or sync. |
| generate_cover_artA | NEW — Generate album cover art image for an existing Suno music track. One call per taskId only. |
| create_omni_voiceB | NEW — Create a reusable voice character for Gemini Omni video generation. Returns kieAudioId for use in generate_video audio_ids. |
| create_omni_characterB | NEW — Create a reusable visual character for Gemini Omni video generation. Combines image + optional voice. Returns characterId. |
| upload_extend_audioA | NEW — Extend uploaded audio (NOT a Suno track) with new AI-generated content. For Suno tracks, use extend_music instead. |
| speech_to_textA | Transcribe audio to text using ElevenLabs Scribe v1. Supports diarization and audio event tagging. Returns transcription text. |
| upload_fileA | Upload a file to kie.ai and get a public URL back. Use this to upload local images/audio/video before passing them to generation tools. Supports URL upload, base64 upload. Files expire after 3 days. |
| veo_extendC | Extend an existing Veo 3.1 video with additional content. Requires taskId from a previous Veo generation. |
| veo_upscale_1080pA | Upscale a Veo 3.1 video to 1080p resolution. Requires taskId from a completed Veo generation. |
| veo_upscale_4kA | Upscale a Veo 3.1 video to 4K resolution. Takes 5-10 minutes. Requires taskId from completed Veo generation. |
| runway_extendB | Extend an existing Runway Aleph video with continuation content. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/elibarnett/kie-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server