About RaoMusic
RaoMusic is an MCP server for AI agents that generates songs, vocals, instrumentals, and sound effects from text. It connects to seven music engines and includes cost estimates, generation status checks, and audio links.
Key features
- 01Generate songs and sound effects from text
- 02Use seven music engines
- 03Inspect engines, versions, and parameters
- 04Estimate credit costs before generation
- 05Check generation status and audio links
- 06List recent songs
Use cases
- 01Create lo-fi instrumentals for studying
- 02Make a sung birthday song
- 03Generate a game pickup sound effect
MCP support
RaoMusic exposes account, model, and music-generation tools through a Streamable HTTP MCP endpoint. Clients can sign in with OAuth or use an API key.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://www.raomusic.com/api/mcpclaude mcp add --transport http raomusic-raomusic https://www.raomusic.com/api/mcp{"mcpServers":{"raomusic-raomusic":{"type":"http","url":"https://www.raomusic.com/api/mcp"}}}Open in Cursor{"servers":{"raomusic-raomusic":{"type":"http","url":"https://www.raomusic.com/api/mcp"}}}Open in VS Code{"mcpServers":{"raomusic-raomusic":{"type":"http","url":"https://www.raomusic.com/api/mcp"}}}{"mcpServers":{"raomusic-raomusic":{"serverUrl":"https://www.raomusic.com/api/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMERaoMusic plugin
Generate full songs (vocals + instrumentals) and sound effects from text, right inside your AI agent.
RaoMusic gives agents one MCP server with seven music engines: Suno, Google Lyria, Mureka, MiniMax, ACE-Step, YuE and ElevenLabs. Your agent can check the credit cost before generating, start a song, wait for it to finish and hand you the download link.
- MCP endpoint:
https://www.raomusic.com/api/mcp(Streamable HTTP) - Sign-in: OAuth with your RaoMusic account (no API key needed). API keys are also supported, see raomusic.com/plugin.
- Pricing: generations use your RaoMusic credits, the same wallet as the website.
Install
Claude Code
claude plugin marketplace add raomusic/raomusic-plugin
claude plugin install raomusic@raomusic
Start a new session, run /mcp, select raomusic and sign in.
Codex
codex plugin marketplace add raomusic/raomusic-plugin
Then open the plugin browser, choose the RaoMusic marketplace and install raomusic.
Any other MCP client (Claude Desktop / claude.ai, ChatGPT, Cursor, VS Code, Windsurf…)
Add a remote (HTTP) MCP server with the URL https://www.raomusic.com/api/mcp and sign in when prompted. Client-by-client instructions: raomusic.com/plugin.
Tools
| Tool | What it does | Spends credits |
|---|---|---|
check_account | Credit balance, concurrency and API key limits | No |
list_models | Engines, versions, prices and parameter schemas | No |
estimate_credits | Exact credit cost of a generation | No |
generate_music | Starts a song or sound effect generation | Yes |
get_generation | Status and audio links for a generation | No |
list_songs | Your recent songs | No |
generate_music requires an idempotency key, so retrying after a timeout never charges twice.
Example prompts
- "Make a 90-second lo-fi instrumental for studying. Tell me the cost first."
- "Write and sing an upbeat pop birthday song for my friend Alex."
- "Generate a 3-second coin pickup sound effect for my game."
What's in this repository
.claude-plugin/– Claude Code plugin manifest and marketplaceplugin.json,mcp.json,.agents/plugins/marketplace.json– Agent Plugins / Codex manifests.mcp.json– MCP server configuration for Claude Codeskills/raomusic/– a skill that teaches the agent the quote → confirm → generate → poll workflow
The plugin contains no code that runs on your machine; it only points your agent at the RaoMusic MCP server.
Privacy and terms
- Privacy policy: https://www.raomusic.com/privacy
- Terms of service: https://www.raomusic.com/terms
- Support: https://www.raomusic.com
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.