RaoMusic

io.github.raomusicv1.0.0Updated Oct 8, 2026

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

VerifiedStreamable HTTPWeb executableAI & MLMedia & Design

Overview

AI-generated overview

Lets an assistant generate full songs with vocals, instrumentals and sound effects from text prompts through the RaoMusic service.

What it does
RaoMusic exposes one remote MCP server that fronts seven music engines, including Suno, Google Lyria, Mureka, MiniMax, ACE-Step, YuE and ElevenLabs. Tools cover checking account credit balance and limits, listing engines with prices and parameter schemas, estimating the exact credit cost of a generation, starting a song or sound effect, polling its status for audio links, and listing recent songs. Generation is asynchronous: the agent starts a job, waits, then hands back a download link.
When to use it
Useful when an assistant should produce original audio on demand, such as background music, a short jingle, a sung birthday song, or a game sound effect. Worth adding if you already hold RaoMusic credits and want music generation available inside your agent rather than through a separate website.
Requirements
A remote Streamable HTTP MCP endpoint at the RaoMusic service; no local runtime or package is installed. Sign-in is OAuth with a RaoMusic account, and API keys are also supported. Generations draw on RaoMusic credits from the same wallet as the website, so a funded account is needed.
Before you install
Generating music spends RaoMusic credits, so costs should be checked before starting a job; the estimate tool reports the exact cost. The generate tool requires an idempotency key so retries after a timeout are not charged twice. Sign-in grants the server access to your RaoMusic account and credit balance, and prompts and generated audio are handled by a third-party service.

Installation

In SourceWeft

  1. Open RaoMusic in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "raomusic": {
      "type": "http",
      "url": "https://www.raomusic.com/api/mcp"
    }
  }
}

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

bash
claude plugin marketplace add raomusic/raomusic-pluginclaude 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

ToolWhat it doesSpends credits
check_accountCredit balance, concurrency and API key limitsNo
list_modelsEngines, versions, prices and parameter schemasNo
estimate_creditsExact credit cost of a generationNo
generate_musicStarts a song or sound effect generationYes
get_generationStatus and audio links for a generationNo
list_songsYour recent songsNo

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

License

MIT

Source: README.md at commit 567ad0a

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.0LatestOct 8, 2026