generate_prompt_songLABSCO SUMMARY
Two modes, and the polling already handled.
The split between inspiration mode and custom mode is the right one: either you have lyrics or you do not, and the tool surface reflects that instead of making you fill in blanks you do not care about. Because the server polls internally, a call can occupy the client for minutes — the timeout setting is the knob to reach for before assuming something is broken.
What it is
The MusicMCP.AI platform's own MCP server. It handles the asynchronous nature of music generation for you — the call submits the job, polls the platform every two seconds until every track is finished, and returns the completed results — so from the client's side one call produces finished songs.
What you get
generate_prompt_song— inspiration mode: give apromptdescribing the theme and the platform writes the title, lyrics and style for you, with aninstrumentalflag and an optionalstylegenerate_custom_song— custom mode: supply your owntitle,lyricand styletagsand get them set to music, or setinstrumentaland skip the lyricscheck_credit_balance— confirm the key is valid and see how many credits are left, free to call- A health check on the platform's API, also free
- Every generation returns two variations, each with a title, download URL, cover image, duration, style tags and the lyrics
Requirements
A MusicMCP.AI API key, supplied as MUSICMCP_API_KEY; MUSICMCP_API_URL and TIME_OUT_SECONDS are optional. The package is aimusic-mcp (version 1.0.6); the documented client entry runs uvx aimusic-mcp, and pip install aimusic-mcp works too. Generation costs 5 credits and produces 2 songs, and credits are not consumed when a generation fails. Typical generation takes several minutes, and the default timeout is 600 seconds — raise TIME_OUT_SECONDS if you hit it.
Setup effort
One command plus a key — uvx aimusic-mcp, then supply credentials
USE CASES
01
Getting a track from a one-line idea
Describe the mood or subject and let the platform write the title, lyrics and style, then take the download URL.
02
Setting lyrics you already wrote
Supply the title, the full lyrics and the style tags, and get two versions back to choose between.
03
Making background music with no vocals
Set the instrumental flag with a style so the result is a bed rather than a song.
04
Checking what a session will cost before running it
Read the remaining credit balance, which costs nothing, before starting a batch of generations.
4 tools
Listed in project docs. Your client may show a different list.
generate_custom_songcheck_credit_balancecheck_api_healthBEFORE YOU INSTALL
What to know first
Tools you get
4 tools named in the project's documentation.
Requires
- uvx on PATH
- MUSICMCP_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
uvx aimusic-mcpMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"MusicMCP.AI": {
"command": "uvx",
"args": [
"aimusic-mcp"
],
"env": {
"MUSICMCP_API_KEY": "<YOUR_MUSICMCP_API_KEY>",
"MUSICMCP_API_URL": "https://www.musicmcp.ai/api",
"TIME_OUT_SECONDS": "600"
}
}
}
}
