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) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| 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