# RaoMusic [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/raomusic/raomusic-plugin  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/raomusic

## Description
Generate full songs with vocals, instrumentals and sound effects from text.

## Tools
Capabilities this server exposes over MCP:

- **check_account** — Credit balance, concurrency and API key limits
- **list_models** — Engines, versions, prices and parameter schemas
- **estimate_credits** — Exact credit cost of a generation
- **generate_music** — Starts a song or sound effect generation
- **get_generation** — Status and audio links for a generation
- **list_songs** — Your recent songs

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

## What RaoMusic MCP server does

RaoMusic MCP server lets an AI agent request complete songs, including vocals and instrumentals, as well as sound effects from text prompts. Generated audio is handled through the RaoMusic service rather than by code running locally. The service uses credits from the same wallet associated with the RaoMusic website.

The available generation engines include Suno, Google Lyria, Mureka, MiniMax, ACE-Step, YuE, and ElevenLabs. Agents can inspect the available engines, their versions, prices, and parameter schemas before selecting an option. Typical requests include a lo-fi instrumental, a sung birthday song, or a short game sound effect.

## How it works

The server is available at `https://www.raomusic.com/api/mcp` as a Streamable HTTP MCP endpoint. After connecting, an agent can check the account, review model information, and calculate the exact credit cost before starting a generation. The generation operation requires an idempotency key, which prevents a retry after a timeout from charging the same request twice.

Once a request starts, the agent can query its status with `get_generation`. That response includes audio links when the generation is ready, allowing the agent to hand the resulting files or links to the user. `list_songs` provides access to the account’s recent songs.

## Setup and configuration

RaoMusic MCP server uses OAuth with a RaoMusic account, so an API key is not required for the standard sign-in flow. API keys are supported as an alternative through the RaoMusic plugin configuration. The README does not specify environment variable names for either authentication method.

Claude Code users can add the RaoMusic plugin marketplace and install the `raomusic` plugin, then start a new session and authenticate through `/mcp`. Codex users can add the marketplace and install the plugin from its plugin browser. Other supported MCP clients can add the remote HTTP server using the endpoint URL and sign in when prompted.

The repository contains plugin and MCP manifests, but no executable generation code. It points the agent to the hosted RaoMusic endpoint.

## Tools and capabilities

RaoMusic MCP server exposes these operations:

- `check_account`: Reports credit balance, concurrency, and API key limits without spending credits.
- `list_models`: Shows available engines, versions, prices, and parameter schemas.
- `estimate_credits`: Calculates the exact cost of a proposed generation.
- `generate_music`: Starts a song or sound-effect generation and spends credits.
- `get_generation`: Retrieves generation status and audio links without spending credits.
- `list_songs`: Lists recent songs associated with the account.

A documented agent workflow is to quote the cost, confirm the request, generate the audio, and poll until completion. The service supports both full songs and sound effects, but the material does not describe editing, mixing, or local rendering features.

## Limitations and notes

Generation requests consume RaoMusic credits, while account checks, model lookup, estimates, status checks, and song listings do not. Account concurrency and API key limits may affect requests. Authentication, billing, privacy, and terms are handled by RaoMusic; consult its service documentation for details that are not defined in this repository.

The repository is licensed under MIT. It documents Claude Code, Codex, Claude Desktop, claude.ai, ChatGPT, Cursor, VS Code, and Windsurf as client options, but client-specific setup steps beyond the plugin commands are not included here.

_Full upstream README: https://allmcps.com/mcp/raomusic/readme_