# suno-mcp [Health: Active]

**Category:** 🎥 Multimedia Process  
**Repository:** https://github.com/runapi-ai/suno-mcp  
**GitHub Stars:** 1  
**npm Downloads (last month):** 1274  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/suno-mcp

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

## Tools
Capabilities this server exposes over MCP:

- **login** — Authenticate RunAPI by opening a browser PKCE login flow and saving the API key to ~/.config/runapi/config.json.
- **convert_audio** — Create a Suno task on RunAPI (convert audio). Returns a task id, status, and output URLs.
- **blend_lyrics** — Create a Suno task on RunAPI (blend lyrics). Returns a task id, status, and result payload.
- **cover_audio** — Create a Suno task on RunAPI (cover audio). Returns a task id, status, and output URLs.
- **create_mashup** — Create a Suno task on RunAPI (create mashup). Returns a task id, status, and output URLs.
- **extend_music** — Create a Suno task on RunAPI (extend music). Returns a task id, status, and output URLs.
- **generate_lyrics** — Create a Suno task on RunAPI (generate lyrics). Returns a task id, status, and result payload.
- **inspire_music** — Create a Suno task on RunAPI (inspire music). Returns a task id, status, and output URLs.
- **add_samples** — Create a Suno task on RunAPI (add samples). Returns a task id, status, and output URLs.
- **visualize_music** — Create a Suno task on RunAPI (visualize music). Returns a task id, status, and output URLs.
- **remaster_audio** — Create a Suno task on RunAPI (remaster audio). Returns a task id, status, and output URLs.
- **separate_audio_stems** — Create a Suno task on RunAPI (separate audio stems). Returns a task id, status, and output URLs.
- **stitch_audio** — Create a Suno task on RunAPI (stitch audio). Returns a task id, status, and output URLs.
- **text_to_music** — Create a Suno task on RunAPI (text to music). Returns a task id, status, and output URLs.
- **text_to_sound** — Create a Suno task on RunAPI (text to sound). Returns a task id, status, and output URLs.
- **generate_persona** — Run a synchronous Suno operation on RunAPI (generate persona). Returns the operation result.
- **boost_style** — Run a synchronous Suno operation on RunAPI (boost style). Returns the operation result.
- **get_timestamped_lyrics** — Run a synchronous Suno operation on RunAPI (get timestamped lyrics). Returns the operation result.
- **generate_voice** — Run a synchronous Suno operation on RunAPI (generate voice). Returns the operation result.
- **get_task** — Fetch the current status and latest result payload for a suno task.
- **check_pricing** — Look up RunAPI pricing for the suno model line.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

**Requires environment variables:** `RUNAPI_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What suno-mcp does

suno-mcp provides MCP access to Suno operations through RunAPI. Its tools cover text-to-music, text-to-sound, lyric generation, voice generation, audio conversion, covers, remastering, stem separation, mashups, stitching, visualization, personas, and other Suno workflows.

The package is scoped to the Suno model family instead of exposing the broader RunAPI catalog. Nine model variants are available across the supported endpoints, although model choices vary by tool. Some operations accept models such as suno-v4, suno-v4.5, suno-v5, suno-v5.5, suno-v6, and related variants.

## How it works

Install the package as an MCP server over stdio, then configure an MCP host to launch it with npx. An assistant can call `check_pricing` before submitting work, create a task with one of the asynchronous operation tools, and either wait for a terminal result or receive a task identifier immediately.

Asynchronous tools return task information and, depending on the operation, output URLs or a result payload. Use `get_task` to retrieve the latest status and payload for a task that was submitted without waiting. `generate_persona`, `boost_style`, `get_timestamped_lyrics`, and `generate_voice` run synchronously and return their operation results directly.

The server uses RunAPI authentication. Interactive login opens a browser and stores credentials in `~/.config/runapi/config.json`; the same configuration can be used by the RunAPI CLI. For headless or CI environments, set `RUNAPI_API_KEY` before starting the MCP host. Pricing lookup remains available without authentication.

## Setup and configuration

For Claude Code, add the server with:

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

Use project scope instead when the configuration should be shared with a repository. Other MCP hosts can launch the package with the equivalent stdio configuration:

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

After installation, ask the assistant to call the `login` tool for interactive authentication. A pre-provisioned configuration file may contain an `apiKey` field, but real credentials should not be committed to source control.

## Tools and capabilities

The operation tools include:

- `text_to_music` and `text_to_sound` for generating music or sound from text.
- `generate_lyrics`, `get_timestamped_lyrics`, `generate_voice`, and `generate_persona` for lyric, voice, timing, and persona workflows.
- `convert_audio`, `cover_audio`, `remaster_audio`, `separate_audio_stems`, `stitch_audio`, and `add_samples` for audio processing.
- `blend_lyrics`, `extend_music`, `inspire_music`, `create_mashup`, `visualize_music`, and `boost_style` for additional Suno transformations.
- `get_task` for checking an existing task and `check_pricing` for pricing by model and endpoint.

Most creation and processing tools can accept a `wait` option so the caller can choose between polling until completion and returning after submission. Tools that expose output URLs return them with the task status; lyric and blend operations return their result payloads.

## Limitations and notes

Authentication is needed for task creation and status polling, while `check_pricing` is the unauthenticated exception. Model availability and the set of models accepted by each endpoint can change between package releases, so pricing lookup or the Suno model page should be used for the current catalog. The server communicates with Suno through RunAPI and does not provide the full RunAPI model collection.

_Full upstream README: https://allmcps.com/mcp/suno-mcp/readme_