io.github.runapi-builder/suno-mcp
NPM · @RUNAPI.AI/SUNO-MCP · SCANNED AUG 3
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 →
Supply Chain Security87
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree. 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 2 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability55
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 1939 tokens (~176/item across 11 items; 11 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 Management19
- Stability check failed: the tool surface changed between 0.2.2 and 0.2.5: 0 tool removals, 1 breaking changes, 0 additions. See how to fix → Fail
Tool Coverage95
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 86% of tool parameters carry a description.Partial
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · @runapi.ai/suno-mcp
claude mcp add runapi-builder-suno-mcp -- npx -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": {
"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.
- 2 Aug 26 +38
- Provenance: unverified → fail ▼ security
- Stability: fail → unverified ▼ security
- Known CVEs: unverified → partial ▲ security
- Install scripts: unverified → pass ▲ security
- Malware scan: unverified → pass ▲ security
- Capabilities: pass → unverified ▼ functional
- Schema quality: unverified → good ▲ functional
- Maintenance: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- License: unverified → pass ▲ functional
- Licence: Apache-2.0 functional
- 1 Aug 26 +7
- Stability: unverified → fail ▼ security
- MCP protocol: unverified → pass ▲ functional
- 31 Jul 26 +12
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 0
- Schema quality: Schema quality not yet verified: our sandbox run of this package did not complete, so we have no schema to assess. functional
- Tool coverage: Tool coverage not yet verified: our sandbox run of this package did not complete, so we have no tool definitions to assess. functional
- 29 Jul 26 0
- Package version: 0.2.3 → 0.2.4 functional
- 28 Jul 26 −37
- Malware scan: pass → unverified ▼ security
- Tool coverage: 100 → unverified ▼ functional
- First check of Schema quality: unverified functional
- Package version: 0.2.2 → 0.2.3 functional
- 27 Jul 26 43
First indexed and scored.
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 3 Aug 2026 · Analysed npm/@runapi.ai/[email protected]
Provenance none
Ecosystem: npm · Outcome: none
Dependencies 96 packages
96 packages in the resolved dependency tree · 96 deprecated · 29 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
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.
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 ~246
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 | string | — | 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 | string | — | Vocal gender. |
| vocal_mode | string | 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 ~240
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 | string | — | 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 | string | — | Vocal gender. |
| vocal_mode | string | 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 ~418
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 | string | yes | Inherit the source track's parameters (source) or supply custom ones (custom). |
| persona_id | string | — | Persona ID. |
| persona_type | string | — | 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 | string | — | 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.
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.
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.
separate_audio_stems ~139
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 | string | — | Target stem for advanced separation. Required when type is split_stem_advanced. |
| task_id | string | yes | Source task ID. |
| timeout_ms | integer | — | — |
| type | string | — | Stem separation mode. |
| wait | boolean | — | Poll until the task reaches a terminal status. |
No output schema declared.
No examples provided.
text_to_music ~257
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 | — | Duration in seconds. |
| 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 | string | — | 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 | string | — | Vocal gender. |
| vocal_mode | string | 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 ~167
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 | string | — | 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.