Skip to main content
Glama
runapi-ai

suno-mcp

by runapi-ai
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

cover_audio

Create a Suno cover task from an uploaded audio file URL via RunAPI, generating new vocals or instrumental versions. Returns a task ID, status, and output URLs.

Instructions

Create a Suno task on RunAPI (cover audio). Returns a task id, status, and output URLs.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
waitNoPoll until the task reaches a terminal status.
modelNoRunAPI model slug for this model line.
styleNoMusic style. Declared type: string.
titleNoMusic title. Declared type: string.
lyricsNoExact cover lyrics to sing. Declared type: string.
promptNoCover brief for automatic lyrics. Declared type: string.
persona_idNoPersona ID. Declared type: string.
timeout_msNo
upload_urlYesURL of the audio file to cover. Declared type: string.
vocal_modeYesVocal generation mode. Declared type: string. Known values: "auto_lyrics", "exact_lyrics", "instrumental".
audio_weightNoAudio weight (0-1). Declared type: number.
callback_urlNoWebhook URL for async notifications. Declared type: string.
persona_typeNoPersona type. Declared type: string. Known values: "style", "voice".
style_weightNoStyle adherence weight (0-1). Declared type: number.
vocal_genderNoVocal gender. Declared type: string. Known values: "male", "female".
negative_tagsNoStyles to avoid. Declared type: string.
poll_interval_msNo
weirdness_constraintNoWeirdness constraint (0-1). Declared type: number.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed32 schema fields changedv0.4.0
    • addedInput schema / additionalProperties
      Added value: +{}
    • changedInput schema / properties / audio_weight / description
      Previous value: -"Audio weight (0-1)."New value: +"Audio weight (0-1). Declared type: number."
    • removedInput schema / properties / audio_weight / maximum
      Removed value: -1
    • removedInput schema / properties / audio_weight / minimum
      Removed value: -0
    • changedInput schema / properties / callback_url / description
      Previous value: -"Webhook URL for async notifications."New value: +"Webhook URL for async notifications. Declared type: string."
    • changedInput schema / properties / lyrics / description
      Previous value: -"Exact cover lyrics to sing."New value: +"Exact cover lyrics to sing. Declared type: string."
    • removedInput schema / properties / lyrics / maxLength
      Removed value: -5000
    • removedInput schema / properties / model / enum
      Removed value: -[
-  "suno-v4",
-  "suno-v4.5",
-  "suno-v4.5-all",
-  "suno-v4.5-plus",
-  "suno-v5",
-  "suno-v5.5",
-  "suno-v6",
-  "suno-v6-mini",
-  "suno-v6-wild"
-]
    • changedInput schema / properties / negative_tags / description
      Previous value: -"Styles to avoid."New value: +"Styles to avoid. Declared type: string."
    • changedInput schema / properties / persona_id / description
      Previous value: -"Persona ID."New value: +"Persona ID. Declared type: string."
    • removedInput schema / properties / persona_type / anyOf
      Removed value: -[
-  {
-    "const": "style",
-    "type": "string"
-  },
-  {
-    "const": "voice",
-    "type": "string"
-  }
-]
    • changedInput schema / properties / persona_type / description
      Previous value: -"Persona type."New value: +"Persona type. Declared type: string. Known values: \"style\", \"voice\"."
    • addedInput schema / properties / persona_type / type
      Added value: +"string"
    • changedInput schema / properties / prompt / description
      Previous value: -"Cover brief for automatic lyrics."New value: +"Cover brief for automatic lyrics. Declared type: string."
    • removedInput schema / properties / prompt / maxLength
      Removed value: -5000
    • changedInput schema / properties / style / description
      Previous value: -"Music style."New value: +"Music style. Declared type: string."
    • removedInput schema / properties / style / maxLength
      Removed value: -1000
    • changedInput schema / properties / style_weight / description
      Previous value: -"Style adherence weight (0-1)."New value: +"Style adherence weight (0-1). Declared type: number."
    • removedInput schema / properties / style_weight / maximum
      Removed value: -1
    • removedInput schema / properties / style_weight / minimum
      Removed value: -0
    • changedInput schema / properties / title / description
      Previous value: -"Music title."New value: +"Music title. Declared type: string."
    • removedInput schema / properties / title / maxLength
      Removed value: -80
    • changedInput schema / properties / upload_url / description
      Previous value: -"URL of the audio file to cover."New value: +"URL of the audio file to cover. Declared type: string."
    • removedInput schema / properties / vocal_gender / anyOf
      Removed value: -[
-  {
-    "const": "male",
-    "type": "string"
-  },
-  {
-    "const": "female",
-    "type": "string"
-  }
-]
    • changedInput schema / properties / vocal_gender / description
      Previous value: -"Vocal gender."New value: +"Vocal gender. Declared type: string. Known values: \"male\", \"female\"."
    • addedInput schema / properties / vocal_gender / type
      Added value: +"string"
    • removedInput schema / properties / vocal_mode / anyOf
      Removed value: -[
-  {
-    "const": "auto_lyrics",
-    "type": "string"
-  },
-  {
-    "const": "exact_lyrics",
-    "type": "string"
-  },
-  {
-    "const": "instrumental",
-    "type": "string"
-  }
-]
    • changedInput schema / properties / vocal_mode / description
      Previous value: -"Vocal generation mode."New value: +"Vocal generation mode. Declared type: string. Known values: \"auto_lyrics\", \"exact_lyrics\", \"instrumental\"."
    • addedInput schema / properties / vocal_mode / type
      Added value: +"string"
    • changedInput schema / properties / weirdness_constraint / description
      Previous value: -"Weirdness constraint (0-1)."New value: +"Weirdness constraint (0-1). Declared type: number."
    • removedInput schema / properties / weirdness_constraint / maximum
      Removed value: -1
    • removedInput schema / properties / weirdness_constraint / minimum
      Removed value: -0
  2. Changed1 schema field changedv0.3.6
    • changedInput schema / properties / model / enum
      Previous value: -[
-  "suno-v4",
-  "suno-v4.5",
-  "suno-v4.5-all",
-  "suno-v4.5-plus",
-  "suno-v5",
-  "suno-v5.5"
-]New value: +[
+  "suno-v4",
+  "suno-v4.5",
+  "suno-v4.5-all",
+  "suno-v4.5-plus",
+  "suno-v5",
+  "suno-v5.5",
+  "suno-v6",
+  "suno-v6-mini",
+  "suno-v6-wild"
+]
  3. Changed10 schema fields changedv0.3.5
    • addedInput schema / properties / audio_weight / maximum
      Added value: +1
    • addedInput schema / properties / audio_weight / minimum
      Added value: +0
    • addedInput schema / properties / lyrics / maxLength
      Added value: +5000
    • addedInput schema / properties / prompt / maxLength
      Added value: +5000
    • addedInput schema / properties / style / maxLength
      Added value: +1000
    • addedInput schema / properties / style_weight / maximum
      Added value: +1
    • addedInput schema / properties / style_weight / minimum
      Added value: +0
    • addedInput schema / properties / title / maxLength
      Added value: +80
    • addedInput schema / properties / weirdness_constraint / maximum
      Added value: +1
    • addedInput schema / properties / weirdness_constraint / minimum
      Added value: +0
  4. Changed12 schema fields changedv0.3.2
    • removedInput schema / additionalProperties
      Removed value: -false
    • addedInput schema / properties / persona_type / anyOf
      Added value: +[
+  {
+    "const": "style",
+    "type": "string"
+  },
+  {
+    "const": "voice",
+    "type": "string"
+  }
+]
    • removedInput schema / properties / persona_type / enum
      Removed value: -[
-  "style",
-  "voice"
-]
    • removedInput schema / properties / persona_type / type
      Removed value: -"string"
    • addedInput schema / properties / poll_interval_ms / maximum
      Added value: +9007199254740991
    • addedInput schema / properties / timeout_ms / maximum
      Added value: +9007199254740991
    • addedInput schema / properties / vocal_gender / anyOf
      Added value: +[
+  {
+    "const": "male",
+    "type": "string"
+  },
+  {
+    "const": "female",
+    "type": "string"
+  }
+]
    • removedInput schema / properties / vocal_gender / enum
      Removed value: -[
-  "male",
-  "female"
-]
    • removedInput schema / properties / vocal_gender / type
      Removed value: -"string"
    • addedInput schema / properties / vocal_mode / anyOf
      Added value: +[
+  {
+    "const": "auto_lyrics",
+    "type": "string"
+  },
+  {
+    "const": "exact_lyrics",
+    "type": "string"
+  },
+  {
+    "const": "instrumental",
+    "type": "string"
+  }
+]
    • removedInput schema / properties / vocal_mode / enum
      Removed value: -[
-  "auto_lyrics",
-  "exact_lyrics",
-  "instrumental"
-]
    • removedInput schema / properties / vocal_mode / type
      Removed value: -"string"
  5. Changed14 schema fields changedv0.2.4
    • addedInput schema / properties / audio_weight / description
      Added value: +"Audio weight (0-1)."
    • addedInput schema / properties / callback_url / description
      Added value: +"Webhook URL for async notifications."
    • addedInput schema / properties / lyrics / description
      Added value: +"Exact cover lyrics to sing."
    • addedInput schema / properties / negative_tags / description
      Added value: +"Styles to avoid."
    • addedInput schema / properties / persona_id / description
      Added value: +"Persona ID."
    • addedInput schema / properties / persona_type / description
      Added value: +"Persona type."
    • addedInput schema / properties / prompt / description
      Added value: +"Cover brief for automatic lyrics."
    • addedInput schema / properties / style / description
      Added value: +"Music style."
    • addedInput schema / properties / style_weight / description
      Added value: +"Style adherence weight (0-1)."
    • addedInput schema / properties / title / description
      Added value: +"Music title."
    • addedInput schema / properties / upload_url / description
      Added value: +"URL of the audio file to cover."
    • addedInput schema / properties / vocal_gender / description
      Added value: +"Vocal gender."
    • addedInput schema / properties / vocal_mode / description
      Added value: +"Vocal generation mode."
    • addedInput schema / properties / weirdness_constraint / description
      Added value: +"Weirdness constraint (0-1)."
  6. Changed9 schema fields changedv0.1.2
    • addedInput schema / properties / callback_url / type
      Added value: +"string"
    • addedInput schema / properties / lyrics / type
      Added value: +"string"
    • addedInput schema / properties / negative_tags / type
      Added value: +"string"
    • addedInput schema / properties / persona_id / type
      Added value: +"string"
    • addedInput schema / properties / prompt / type
      Added value: +"string"
    • addedInput schema / properties / style / type
      Added value: +"string"
    • addedInput schema / properties / title / type
      Added value: +"string"
    • addedInput schema / properties / upload_url / type
      Added value: +"string"
    • changedInput schema / required
      Previous value: -[
-  "vocal_mode"
-]New value: +[
+  "upload_url",
+  "vocal_mode"
+]
  7. First observedv0.1.0

TDQS

C2.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden, yet it only says it returns a task id, status and output URLs. It does not disclose the asynchronous task lifecycle, the effect of the 'wait' polling flag, cost/credit implications, or whether an existing audio asset is consumed or a new one produced.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two short sentences, correctly front-loaded with the action before the return-value note. Nothing is redundant, though the second sentence is generic.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an 18-parameter, 2-required, annotation-free music generation tool with no output schema, the description omits the async/polling behavior, credential/API-key expectations, and any hint about which optional fields are mutually exclusive (lyrics vs prompt). It is far too thin for this complexity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 89%, so the schema already documents nearly every parameter (upload_url, vocal_mode, weights, callback_url, etc.). The description adds no parameter meaning, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a concrete verb+resource ('Create a Suno task... cover audio'), which is better than a tautology, but it never distinguishes this from sibling cover/transform tools like convert_audio, remaster_audio, or extend_music. An agent must infer the difference from the name alone.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no when-to-use guidance, no prerequisite (for example that an upload_url must first be obtained), and no mention of any alternative tool. Among ~20 audio siblings, this leaves routing entirely to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools