RaoMusic README

RaoMusic 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

Terminal

claude plugin marketplace add raomusic/raomusic-plugin
claude plugin install raomusic@raomusic

Start a new session, run /mcp, select raomusic and sign in.

Codex

bash

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 marketplace
plugin.json, mcp.json, .agents/plugins/marketplace.json – Agent Plugins / Codex manifests
.mcp.json – MCP server configuration for Claude Code
skills/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