io.github.runapi-builder/suno-mcp
NPM · @RUNAPI.AI/SUNO-MCP · SCANNED SEP 24
RunAPI MCP server for Suno: create tasks, poll status, check pricing.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security98
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 31 of 97 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (Apache-2.0).Pass
- Actively maintained (last published 7 days ago).Pass
- Security-disclosure policy not yet verified: we couldn't inspect the source repository.Unverified
Schema Quality & AI Usability63
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 2503 tokens (~156/item across 16 items; 16 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management90
- Stability observed for 27 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage94
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 83% of tool parameters carry a description.Partial
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 16 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 17 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the io.github.runapi-builder/suno-mcp server?
io.github.runapi-builder/suno-mcp runs locally as an npm package, launched with npx -y @runapi.ai/suno-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · @runapi.ai/suno-mcp
claude mcp add runapi-builder-suno-mcp -- npx -y @runapi.ai/suno-mcp
{
"mcpServers": {
"runapi-builder-suno-mcp": {
"command": "npx",
"args": [
"-y",
"@runapi.ai/suno-mcp"
]
}
}
} {
"servers": {
"runapi-builder-suno-mcp": {
"command": "npx",
"args": [
"-y",
"@runapi.ai/suno-mcp"
]
}
}
} codex mcp add runapi-builder-suno-mcp -- npx -y @runapi.ai/suno-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"runapi-builder-suno-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"@runapi.ai/suno-mcp"
],
"enabled": true
}
}
} openclaw mcp add runapi-builder-suno-mcp --command npx --arg -y --arg @runapi.ai/suno-mcp
mcp_servers:
runapi-builder-suno-mcp:
command: "npx"
args: ["-y", "@runapi.ai/suno-mcp"] {
"McpServers": {
"runapi-builder-suno-mcp": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"@runapi.ai/suno-mcp"
]
}
}
} assistant mcp add runapi-builder-suno-mcp -t stdio -c npx -a -y @runapi.ai/suno-mcp
{
"mcpServers": {
"runapi-builder-suno-mcp": {
"command": "npx",
"args": [
"-y",
"@runapi.ai/suno-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 24 Sept 26 +1
- Security disclosure: fail → unverified ▼ functional
- 22 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.
- 21 Sept 26 −3
- Stability: pass → 0.80 functional
- 20 Sept 26 0
- Stability: 0.97 → pass security
- Security disclosure: unverified → fail ▼ functional
- 19 Sept 26 +1
- Security disclosure: fail → unverified ▼ functional
- 17 Sept 26 −1
- Security disclosure: unverified → fail ▼ functional
- Stability: pass → 0.90 functional
- 16 Sept 26 0
- Stability: 0.97 → pass security
- Security disclosure: fail → unverified ▼ functional
- 15 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 24 Sept 2026 · Analysed npm/@runapi.ai/suno-mcp@0.3.5
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Background: How many MCP packages publish verified provenance →
Dependencies 97 packages
| Packages resolved | 97 |
|---|---|
| Stale | 31 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
add_samples ~156
Create a Suno task on RunAPI (add samples). Returns a task id, status, and output URLs.
| Name | Type | Req | Description |
|---|---|---|---|
| audio_url | string | yes | URL of the audio file to sample. |
| callback_url | string | – | Webhook URL for async notifications. |
| end_seconds | number | yes | End of the sample range in seconds; must exceed start_seconds. |
| model | string | – | RunAPI model slug for this model line. |
| poll_interval_ms | integer | – | – |
| prompt | string | – | Optional description of the sample to add. |
| start_seconds | number | yes | Start of the sample range in seconds. |
| timeout_ms | integer | – | – |
| wait | boolean | – | Poll until the task reaches a terminal status. |
No output schema declared.
No examples provided.
blend_lyrics ~104
Create a Suno task on RunAPI (blend lyrics). Returns a task id, status, and result payload.
| Name | Type | Req | Description |
|---|---|---|---|
| callback_url | string | – | Webhook URL for async notifications. |
| lyrics_a | string | yes | First lyrics text to blend. |
| lyrics_b | string | yes | Second lyrics text to blend. |
| poll_interval_ms | integer | – | – |
| timeout_ms | integer | – | – |
| wait | boolean | – | Poll until the task reaches a terminal status. |
No output schema declared.
No examples provided.
check_pricing ~56
Look up RunAPI pricing for the suno model line.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | – | Endpoint name. Defaults to the endpoint that offers the model. |
| model | string | – | Model slug. Defaults to the line's primary model. |
No output schema declared.
No examples provided.
cover_audio ~240
Create a Suno task on RunAPI (cover audio). Returns a task id, status, and output URLs.
| Name | Type | Req | Description |
|---|---|---|---|
| audio_weight | number | – | Audio weight (0-1). |
| callback_url | string | – | Webhook URL for async notifications. |
| lyrics | string | – | Exact cover lyrics to sing. |
| model | string | – | RunAPI model slug for this model line. |
| negative_tags | string | – | Styles to avoid. |
| persona_id | string | – | Persona ID. |
| persona_type | – | – | Persona type. |
| poll_interval_ms | integer | – | – |
| prompt | string | – | Cover brief for automatic lyrics. |
| style | string | – | Music style. |
| style_weight | number | – | Style adherence weight (0-1). |
| timeout_ms | integer | – | – |
| title | string | – | Music title. |
| upload_url | string | yes | URL of the audio file to cover. |
| vocal_gender | – | – | Vocal gender. |
| vocal_mode | – | yes | Vocal generation mode. |
| wait | boolean | – | Poll until the task reaches a terminal status. |
| weirdness_constraint | number | – | Weirdness constraint (0-1). |
No output schema declared.
No examples provided.
create_mashup ~234
Create a Suno task on RunAPI (create mashup). Returns a task id, status, and output URLs.
| Name | Type | Req | Description |
|---|---|---|---|
| audio_weight | number | – | Audio weight (0-1). |
| callback_url | string | – | Webhook URL for async notifications. |
| lyrics | string | – | Exact mashup lyrics to sing. |
| model | string | – | RunAPI model slug for this model line. |
| persona_id | string | – | Persona ID. |
| persona_type | – | – | Persona type. |
| poll_interval_ms | integer | – | – |
| prompt | string | – | Mashup brief for automatic lyrics. |
| style | string | – | Music style. |
| style_weight | number | – | Style adherence weight (0-1). |
| timeout_ms | integer | – | – |
| title | string | – | Music title. |
| upload_url_list | array | yes | Two audio URLs to mashup. |
| vocal_gender | – | – | Vocal gender. |
| vocal_mode | – | yes | Vocal generation mode. |
| wait | boolean | – | Poll until the task reaches a terminal status. |
| weirdness_constraint | number | – | Weirdness constraint (0-1). |
No output schema declared.
No examples provided.
extend_music ~412
Create a Suno task on RunAPI (extend music). Returns a task id, status, and output URLs.
| Name | Type | Req | Description |
|---|---|---|---|
| audio_id | string | – | Source audio ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url. |
| audio_url | string | – | Source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url. |
| audio_weight | number | – | Audio weight (0-1). |
| callback_url | string | – | Webhook URL for async notifications. |
| continue_at | number | – | Seconds into the source to continue from. Required in custom parameter mode. |
| instrumental | boolean | – | When true, generate without vocals. |
| lyrics | string | – | Exact lyrics. Only allowed when extending uploaded audio in custom parameter mode. |
| model | string | – | RunAPI model slug for this model line. |
| negative_tags | string | – | Styles to avoid. |
| parameter_mode | – | yes | Inherit the source track's parameters (source) or supply custom ones (custom). |
| persona_id | string | – | Persona ID. |
| persona_type | – | – | Persona type. |
| poll_interval_ms | integer | – | – |
| prompt | string | – | Extension brief. Cannot be combined with lyrics. |
| style | string | – | Style preset. Required in custom parameter mode. |
| style_weight | number | – | Style adherence weight (0-1). |
| task_id | string | – | Source task ID to extend. Provide one of task_id, audio_id, audio_url, or upload_url. |
| timeout_ms | integer | – | – |
| title | string | – | Song title. Required in custom parameter mode. |
| upload_url | string | – | Uploaded source audio URL to extend. Provide one of task_id, audio_id, audio_url, or upload_url. |
| vocal_gender | – | – | Vocal gender. |
| wait | boolean | – | Poll until the task reaches a terminal status. |
| weirdness_constraint | number | – | Weirdness constraint (0-1). |
No output schema declared.
No examples provided.
generate_lyrics ~88
Create a Suno task on RunAPI (generate lyrics). Returns a task id, status, and result payload.
| Name | Type | Req | Description |
|---|---|---|---|
| callback_url | string | – | Webhook URL for async notifications. |
| poll_interval_ms | integer | – | – |
| prompt | string | yes | Lyrics generation prompt. |
| timeout_ms | integer | – | – |
| wait | boolean | – | Poll until the task reaches a terminal status. |
No output schema declared.
No examples provided.
generate_persona ~73
Run a synchronous Suno operation on RunAPI (generate persona). Returns the operation result.
| Name | Type | Req | Description |
|---|---|---|---|
| audio_id | string | yes | Audio ID within the source task. |
| description | string | yes | Persona description. |
| name | string | yes | Persona name. |
| task_id | string | yes | Source task ID with reference vocals. |
No output schema declared.
No examples provided.
get_task ~53
Fetch the current status and latest result payload for a suno task.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | Asynchronous endpoint the task was created on. |
| task_id | string | yes | Task id returned when the task was created. |
No output schema declared.
No examples provided.
inspire_music ~111
Create a Suno task on RunAPI (inspire music). Returns a task id, status, and output URLs.
| Name | Type | Req | Description |
|---|---|---|---|
| audio_urls | array | yes | One to four audio URLs that guide the new music. |
| callback_url | string | – | Webhook URL for async notifications. |
| model | string | – | RunAPI model slug for this model line. |
| poll_interval_ms | integer | – | – |
| timeout_ms | integer | – | – |
| wait | boolean | – | Poll until the task reaches a terminal status. |
No output schema declared.
No examples provided.
login ~52
Authenticate RunAPI by opening a browser PKCE login flow and saving the API key to ~/.config/runapi/config.json.
| Name | Type | Req | Description |
|---|---|---|---|
| force | boolean | – | Re-run browser login when the current credential comes from the local config file. |
No output schema declared.
No examples provided.
remaster_audio ~121
Create a Suno task on RunAPI (remaster audio). Returns a task id, status, and output URLs.
| Name | Type | Req | Description |
|---|---|---|---|
| audio_id | string | yes | Audio ID within the source task. |
| callback_url | string | – | Webhook URL for async notifications. |
| model | string | – | RunAPI model slug for this model line. |
| poll_interval_ms | integer | – | – |
| source_task_id | string | yes | Completed source task ID. |
| timeout_ms | integer | – | – |
| wait | boolean | – | Poll until the task reaches a terminal status. |
No output schema declared.
No examples provided.
separate_audio_stems ~135
Create a Suno task on RunAPI (separate audio stems). Returns a task id, status, and output URLs.
| Name | Type | Req | Description |
|---|---|---|---|
| audio_id | string | yes | Audio ID within the source task. |
| callback_url | string | – | Webhook URL for async notifications. |
| poll_interval_ms | integer | – | – |
| stem_name | – | – | Target stem for advanced separation. Required when type is split_stem_advanced. |
| task_id | string | yes | Source task ID. |
| timeout_ms | integer | – | – |
| type | – | – | Stem separation mode. |
| wait | boolean | – | Poll until the task reaches a terminal status. |
No output schema declared.
No examples provided.
stitch_audio ~120
Create a Suno task on RunAPI (stitch audio). Returns a task id, status, and output URLs.
| Name | Type | Req | Description |
|---|---|---|---|
| audio_id | string | yes | Audio ID within the source task. |
| callback_url | string | – | Webhook URL for async notifications. |
| model | string | – | RunAPI model slug for this model line. |
| poll_interval_ms | integer | – | – |
| source_task_id | string | yes | Completed source task ID. |
| timeout_ms | integer | – | – |
| wait | boolean | – | Poll until the task reaches a terminal status. |
No output schema declared.
No examples provided.
text_to_music ~264
Create a Suno task on RunAPI (text to music). Returns a task id, status, and output URLs.
| Name | Type | Req | Description |
|---|---|---|---|
| audio_weight | number | – | Audio weight (0-1). |
| callback_url | string | – | Webhook URL for async notifications. |
| continue_at | number | – | Timestamp in seconds to continue from. |
| duration_seconds | number | – | Preferred duration in seconds; only available for Suno V5.5 custom requests. |
| lyrics | string | – | Exact lyrics to sing. |
| model | string | – | RunAPI model slug for this model line. |
| negative_tags | string | – | Styles to avoid. |
| persona_id | string | – | Persona ID. |
| persona_type | – | – | Persona type. |
| poll_interval_ms | integer | – | – |
| prompt | string | – | Song brief for automatic lyrics. |
| style | string | – | Music style. |
| style_weight | number | – | Style adherence weight (0-1). |
| timeout_ms | integer | – | – |
| title | string | – | Music title. |
| vocal_gender | – | – | Vocal gender. |
| vocal_mode | – | yes | Vocal generation mode. |
| wait | boolean | – | Poll until the task reaches a terminal status. |
| weirdness_constraint | number | – | Weirdness constraint (0-1). |
No output schema declared.
No examples provided.
text_to_sound ~165
Create a Suno task on RunAPI (text to sound). Returns a task id, status, and output URLs.
| Name | Type | Req | Description |
|---|---|---|---|
| callback_url | string | – | Webhook URL for async notifications. |
| grab_lyrics | boolean | – | Capture lyric subtitles. Default false. |
| model | string | – | RunAPI model slug for this model line. |
| poll_interval_ms | integer | – | – |
| prompt | string | yes | Sound description (max 500 characters). |
| sound_key | – | – | Musical key. |
| sound_loop | boolean | – | When true, produce loopable audio. Default false. |
| sound_tempo | number | – | Tempo in BPM (1-300). |
| timeout_ms | integer | – | – |
| wait | boolean | – | Poll until the task reaches a terminal status. |
No output schema declared.
No examples provided.
What is the io.github.runapi-builder/suno-mcp server?
io.github.runapi-builder/suno-mcp is listed in the public MCP registry as io.github.runapi-builder/suno-mcp. RunAPI MCP server for Suno: create tasks, poll status, check pricing. This page covers its npm package (@runapi.ai/suno-mcp).
Is the io.github.runapi-builder/suno-mcp server safe to use?
io.github.runapi-builder/suno-mcp scores 80 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 24 September 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.runapi-builder/suno-mcp server expose?
io.github.runapi-builder/suno-mcp exposes 16 tools: login, add_samples, blend_lyrics, cover_audio, create_mashup, and 11 more. Their descriptions and schemas cost roughly 2,384 tokens of context every time the server is loaded.
Is the io.github.runapi-builder/suno-mcp server still maintained?
io.github.runapi-builder/suno-mcp is still listed as active in the MCP registry. We last reached this channel on 24 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the io.github.runapi-builder/suno-mcp server under?
io.github.runapi-builder/suno-mcp declares the Apache-2.0 licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.