# io.github.runapi-builder/suno-mcp (npm · @runapi.ai/suno-mcp)

RunAPI MCP server for Suno: create tasks, poll status, check pricing.

- Trust score: 63/100 (medium)
- Change this week: +20
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@runapi.ai/suno-mcp`: 63/100 (this document), [markdown](https://verifymcp.io/servers/runapi-builder-suno-mcp/runapi-ai-suno-mcp.md), [page](https://verifymcp.io/servers/runapi-builder-suno-mcp/runapi-ai-suno-mcp)

## Channel facts

- Registry: `npm`
- Package: `@runapi.ai/suno-mcp`
- Version: `0.2.5`
- Transport: `stdio`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (Apache-2.0).
  - Actively maintained (last published 2 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 55/100
  - AI-judged instruction clarity (good).
  - 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.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 19/100
  - Stability check failed: the tool surface changed between 0.2.2 and 0.2.5: 0 tool removals, 1 breaking changes, 0 additions.
- **Tool Coverage**: 95/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 86% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add runapi-builder-suno-mcp -- npx -y @runapi.ai/suno-mcp
```

### Codex

```bash
codex mcp add runapi-builder-suno-mcp -- npx -y @runapi.ai/suno-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "runapi-builder-suno-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@runapi.ai/suno-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add runapi-builder-suno-mcp --command npx --arg -y --arg @runapi.ai/suno-mcp
```

### Hermes

```yaml
mcp_servers:
  runapi-builder-suno-mcp:
    command: "npx"
    args: ["-y", "@runapi.ai/suno-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "runapi-builder-suno-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@runapi.ai/suno-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 63, +38)

- [security regression] Provenance: unverified → fail
- [security regression] Stability: fail → unverified
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Install scripts: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [functional regression] Capabilities: pass → unverified
- [functional improvement] Schema quality: unverified → good
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] License: unverified → pass
- [functional] Licence: Apache-2.0

### 2026-08-01 (score 25, +7)

- [security regression] Stability: unverified → fail
- [functional improvement] MCP protocol: unverified → pass

### 2026-07-31 (score 18, +12)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 6, 0)

- [functional] 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.

### 2026-07-29 (score 6, 0)

- [functional] Package version: 0.2.3 → 0.2.4

### 2026-07-28 (score 6, −37)

- [security regression] Malware scan: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional] First check of Schema quality: unverified
- [functional] Package version: 0.2.2 → 0.2.3

### 2026-07-27 (score 43)

First indexed and scored.

## MCP tools (11)

### `login` (~52 tokens)

Authenticate RunAPI by opening a browser PKCE login flow and saving the API key to ~/.config/runapi/config.json.

Input parameters:

- `force` (boolean): Re-run browser login when the current credential comes from the local config file.

### `blend_lyrics` (~104 tokens)

Create a Suno task on RunAPI (blend lyrics). Returns a task id, status, and result payload.

Input parameters:

- `callback_url` (string): Webhook URL for async notifications.
- `lyrics_a` (string, required): First lyrics text to blend.
- `lyrics_b` (string, required): Second lyrics text to blend.
- `poll_interval_ms` (integer)
- `timeout_ms` (integer)
- `wait` (boolean): Poll until the task reaches a terminal status.

### `cover_audio` (~246 tokens)

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

Input parameters:

- `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, required): URL of the audio file to cover.
- `vocal_gender` (string): Vocal gender.
- `vocal_mode` (string, required): Vocal generation mode.
- `wait` (boolean): Poll until the task reaches a terminal status.
- `weirdness_constraint` (number): Weirdness constraint (0-1).

### `create_mashup` (~240 tokens)

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

Input parameters:

- `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, required): Two audio URLs to mashup.
- `vocal_gender` (string): Vocal gender.
- `vocal_mode` (string, required): Vocal generation mode.
- `wait` (boolean): Poll until the task reaches a terminal status.
- `weirdness_constraint` (number): Weirdness constraint (0-1).

### `extend_music` (~418 tokens)

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

Input parameters:

- `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, required): 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).

### `generate_lyrics` (~88 tokens)

Create a Suno task on RunAPI (generate lyrics). Returns a task id, status, and result payload.

Input parameters:

- `callback_url` (string): Webhook URL for async notifications.
- `poll_interval_ms` (integer)
- `prompt` (string, required): Lyrics generation prompt.
- `timeout_ms` (integer)
- `wait` (boolean): Poll until the task reaches a terminal status.

### `separate_audio_stems` (~139 tokens)

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

Input parameters:

- `audio_id` (string, required): 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, required): Source task ID.
- `timeout_ms` (integer)
- `type` (string): Stem separation mode.
- `wait` (boolean): Poll until the task reaches a terminal status.

### `text_to_music` (~257 tokens)

Create a Suno task on RunAPI (text to music). Returns a task id, status, and output URLs.

Input parameters:

- `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, required): Vocal generation mode.
- `wait` (boolean): Poll until the task reaches a terminal status.
- `weirdness_constraint` (number): Weirdness constraint (0-1).

### `text_to_sound` (~167 tokens)

Create a Suno task on RunAPI (text to sound). Returns a task id, status, and output URLs.

Input parameters:

- `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, required): 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.

### `get_task` (~53 tokens)

Fetch the current status and latest result payload for a suno task.

Input parameters:

- `action` (string, required): Asynchronous endpoint the task was created on.
- `task_id` (string, required): Task id returned when the task was created.

### `check_pricing` (~56 tokens)

Look up RunAPI pricing for the suno model line.

Input parameters:

- `action` (string): Endpoint name. Defaults to the endpoint that offers the model.
- `model` (string): Model slug. Defaults to the line's primary model.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/runapi-builder-suno-mcp/runapi-ai-suno-mcp#diagnostics

## Score history

- 2026-08-03: 63
- 2026-08-02: 63
- 2026-08-01: 25
- 2026-07-31: 18
- 2026-07-30: 6
- 2026-07-29: 6
- 2026-07-28: 6
- 2026-07-27: 43

## Links

- npm package: https://www.npmjs.com/package/@runapi.ai/suno-mcp
- Socket report: https://socket.dev/npm/package/@runapi.ai/suno-mcp
- Repository: https://github.com/runapi-ai/suno-mcp
- Changelog RSS feed: https://verifymcp.io/servers/runapi-builder-suno-mcp/runapi-ai-suno-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/runapi-builder-suno-mcp/runapi-ai-suno-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/runapi-builder-suno-mcp/runapi-ai-suno-mcp