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 a `prompt` describing the theme and the platform writes the title, lyrics and style for you, with an `instrumental` flag and an optional `style`
`generate_custom_song` — custom mode: supply your own `title`, `lyric` and style `tags` and get them set to music, or set `instrumental` and skip the lyrics
`check_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` (1.0.6 in pyproject); 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