kie-suno6-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KIE_AI_API_KEY | No | Kie.ai API key | |
| KIE_SUNO_CONFIG | No | Path to JSON config overriding env | |
| KIE_SUNO_ENV_FILE | No | .env file with KIE_AI_API_KEY | ~/.hermes/.env |
| KIE_SUNO_PROVIDER | No | Provider registry key | kieai |
| KIE_SUNO_TELEMETRY | No | Set 'on' to enable telemetry | off |
| KIE_SUNO_DOWNLOAD_DIR | No | Where download writes takes | cwd |
| KIE_SUNO_TELEMETRY_DIR | No | Where telemetry files are written | <repo>/.telemetry |
| KIE_SUNO_RETRY_DELAY_MS | No | Collision-retry delay | 35000 |
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 | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| suno_generateA | Submit text-to-music (Suno). Costs credits immediately (~12 for V6). Returns task_id. One task = 2 takes — do NOT submit twice for options. suno_poll/wait parse results from either resultJson (V6) or sunoData (observed live shape) automatically. |
| suno_uploadA | Upload an MP3 to the kie.ai CDN (file-stream-upload). Required first step before suno_cover or suno_upload_extend — third-party URLs fail with 'File fetch failed'. Free (no generation credits). |
| suno_coverC | Cover generation from an uploaded source (upload-cover). Supports personaId. Costs credits. Returns task_id. |
| suno_upload_extendB | Extend uploaded audio (upload-extend). continueAt is REQUIRED (seconds, 0 < continueAt < source duration). defaultParamFlag=false: uploadUrl+prompt+continueAt. defaultParamFlag=true: also style+title (instrumental=false). Model must match source model version. Costs credits. Returns task_id. |
| suno_extendA | Extend an existing Suno task's take (generate/extend). Omit custom fields to inherit source params (only audioId+model needed). In custom mode (any of prompt/style/title/continueAt set, or defaultParamFlag=true) ALL of prompt+style+title+continueAt are required — model must match the source model version. Costs credits. Returns task_id. |
| suno_personaA | Create a persona (voice fingerprint) from a SUCCESSFUL task's take. Costs credits. OBSERVED (2026-09-22): re-calling with the same taskId+audioId does NOT 409 — it returns the same personaId and OVERWRITES name+description in place. Always send the full intended description; a careless re-call pollutes it. |
| suno_pollB | Check a task (record-info). V6-aware: parses resultJson, gates on terminal status + non-empty audio, warns instead of tempting re-submission. Free. |
| suno_waitA | Block until a task is terminal (default poll 12s, max 900s). Returns final status + audio URLs. |
| suno_downloadA | Download all takes of a finished task with browser-UA (Cloudflare 403 avoidance) + sha256 two-take collision check (CDN race ~30s). Free. |
| suno_download_urlC | Download a single asset URL (browser-UA). |
| suno_creditsA | Current credit balance. Free, no-credit check for 402/433 triage. |
| suno_tasksB | Summarize poll status for a list of task ids in one call (free). |
| suno_infoB | Server self-description: provider, default model, download dir, available providers. Free. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 13 tools
Most tools target clear distinct actions: upload, generate, cover, extend, persona, poll/wait/download, credits. Some boundary overlap exists between suno_poll, suno_wait, and suno_tasks, and between suno_extend and suno_upload_extend, but descriptions clarify the different use cases.
All tools share the consistent suno_ prefix and use lowercase snake_case. The pattern mixes verbs (generate, upload, poll, wait) with nouns (info, tasks, persona, credits), which is a minor deviation from a strict verb_noun scheme.
13 tools is well-scoped for a Suno API server covering generation, extension, uploads, personas, status polling, downloads, and credit checks. Each tool addresses a meaningful part of the workflow without redundant bloat.
The toolset covers the full generation lifecycle: upload sources, create covers/extensions, submit text-to-music, create personas, poll/wait for results, and download outputs. Minor gaps like canceling in-progress tasks or listing previous tasks are not covered, but agents can complete primary workflows without dead ends.