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. Generate-then-refine by named region→grok-imagine-image-2-0/text-to-image (4cr, #2 Arena T2I+edit, NEW) then grok_segment_map (free) + grok_image_edit (4cr). 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 (6-8cr/s measured; alias of wan/2-6-flash). 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 (image-to-image, image-to-video, reference/ingredient inputs). PREFER file_path for local files. Files expire after 3 days (kie temp storage). |
| grok_segment_mapA | FREE (0 credits). Segment a Grok Imagine Image 2.0 generation into NAMED regions for targeted editing. Returns each region's index, semantic name (e.g. "red apple", "wooden table"), and mask PNG URL. Workflow: generate_image model="grok-imagine-image-2-0/text-to-image" → grok_segment_map (this, free) → grok_image_edit with the mask_indexs you want changed. Only works on task_ids from a Grok Image 2.0 generation. |
| grok_image_editA | Edit ONLY selected regions of a Grok Imagine Image 2.0 generation (4 credits). Pass the source task_id, an edit prompt describing the desired end state of the masked region(s), and mask_indexs — the region indices from grok_segment_map (run it first, free, and pick regions by NAME; do not guess indices). Everything outside the masks is preserved. Returns a new full image; the result task_id can itself be segmented/edited again for iterative refinement at 4 cr per round. Downloads to kie/assets/raw/. |
| 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 | |