Skip to main content
Glama
runapi-ai

suno-mcp

by runapi-ai
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

text_to_music

Create a Suno music generation task from text prompts, lyrics, or instrumental mode, returning a task ID, status, and output URLs for polling.

Instructions

Create a Suno task on RunAPI (text to music). 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 lyrics to sing. Declared type: string.
promptNoSong brief for automatic lyrics. Declared type: string.
voice_idNoRunAPI Voice handle. Declared type: string.
persona_idNoPersona ID. Declared type: string.
timeout_msNo
vocal_modeYesVocal generation mode. Declared type: string. Known values: "auto_lyrics", "exact_lyrics", "instrumental".
continue_atNoTimestamp in seconds to continue from. Declared type: number.
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.
duration_secondsNoPreferred duration in seconds; only available for Suno V5.5 custom requests. Declared type: integer.
poll_interval_msNo
weirdness_constraintNoWeirdness constraint (0-1). Declared type: number.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed37 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 / continue_at / description
      Previous value: -"Timestamp in seconds to continue from."New value: +"Timestamp in seconds to continue from. Declared type: number."
    • changedInput schema / properties / duration_seconds / description
      Previous value: -"Preferred duration in seconds; only available for Suno V5.5 custom requests."New value: +"Preferred duration in seconds; only available for Suno V5.5 custom requests. Declared type: integer."
    • removedInput schema / properties / duration_seconds / maximum
      Removed value: -360
    • removedInput schema / properties / duration_seconds / minimum
      Removed value: -10
    • changedInput schema / properties / duration_seconds / type
      Previous value: -"number"New value: +"integer"
    • changedInput schema / properties / lyrics / description
      Previous value: -"Exact lyrics to sing."New value: +"Exact 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: -"Song brief for automatic lyrics."New value: +"Song 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
    • 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 / voice_id / description
      Previous value: -"RunAPI Voice handle."New value: +"RunAPI Voice handle. Declared type: 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. Changed2 schema fields 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"
+]
    • addedInput schema / properties / voice_id
      Added value: +{
+  "description": "RunAPI Voice handle.",
+  "type": "string"
+}
  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
    • changedInput schema / properties / prompt / maxLength
      Previous value: -3000New 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. Changed16 schema fields changedv0.3.2
    • removedInput schema / additionalProperties
      Removed value: -false
    • changedInput schema / properties / duration_seconds / description
      Previous value: -"Duration in seconds."New value: +"Preferred duration in seconds; only available for Suno V5.5 custom requests."
    • addedInput schema / properties / duration_seconds / maximum
      Added value: +360
    • addedInput schema / properties / duration_seconds / minimum
      Added value: +10
    • 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 / prompt / maxLength
      Added value: +3000
    • 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. Changed16 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 / continue_at / description
      Added value: +"Timestamp in seconds to continue from."
    • addedInput schema / properties / duration_seconds / description
      Added value: +"Duration in seconds."
    • removedInput schema / properties / endpoint
      Removed value: -{
-  "type": "string"
-}
    • addedInput schema / properties / lyrics / description
      Added value: +"Exact 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: +"Song 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 / 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. Changed1 schema field changedv0.1.9
    • addedInput schema / properties / endpoint
      Added value: +{
+  "type": "string"
+}
  7. Changed7 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"
  8. First observedv0.1.0

TDQS

C2.9/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 disclosure burden. It hints at an async task model by naming a returned task id and status, but never explains that wait defaults to true and triggers polling to a terminal state, nor describes timeout/poll_interval behavior, cost implications, or failure modes for what is clearly a long-running job.

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 tight sentences with the operation front-loaded and return values trailing, and every clause carries information. It is appropriately short, though given the tool's complexity the brevity edges toward under-specification rather than pure efficiency.

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?

This is a 20-parameter, no-annotation, no-output-schema generation tool with an implicit async lifecycle. The description gives a one-line return summary but omits polling/wait semantics and any selection logic for the many mutually-influential fields (lyrics vs prompt vs vocal_mode), leaving meaningful gaps for an agent to fill.

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 90% across 20 parameters, so the schema already documents nearly everything, and per the rubric that establishes a baseline of 3. The description adds no parameter-level meaning beyond the schema (e.g., how lyrics conflicts with prompt under each vocal_mode), so it does not rise above baseline.

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

Purpose4/5

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

States a specific verb (Create) and resource (Suno task on RunAPI), plus a parenthetical that pins the modality (text to music), which distinguishes it from siblings like text_to_sound, cover_audio, or extend_music. It stops short of explicitly naming the sibling it should be chosen over, so it lands just below the top band.

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 guidance on when to use this versus text_to_sound, inspire_music, extend_music, or the other generation siblings, and no mention of prerequisites such as auth or how vocal_mode drives the request. The agent must infer routing entirely from the tool name.

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