io.github.erlionaPublished by GitHub account erlionav0.1.1Updated Nov 2, 2026
Generate Suno AI music (v5.5) from any MCP client. Async; billed only on success.
Hosted MCP server that lets an assistant generate Suno AI music tracks from a text prompt and retrieve the finished audio URLs.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.erliona%2Ftunova/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"tunova": {
"type": "http",
"url": "https://api.tunova.ai/mcp",
"headers": {
"X-API-Key": "<YOUR_API_KEY>"
}
}
}
}Tiny, zero-dependency clients + MCP manifest for the Tunova music API — generate music with Suno (v5.5) over a simple REST or MCP interface. Generation is async and billed only on success: a failed render refunds itself.
python/tunova.py — stdlib only, Python 3.8+.node/tunova.ts — Node 18+ (fetch built in).server.json — hosted Streamable-HTTP server at https://api.tunova.ai/mcp.Get a key (50 free tokens, no card) at https://tunova.ai. Full reference: https://api.tunova.ai/docs · live status: https://tunova.ai/status.
Tunova is an independent service, not affiliated with or endorsed by Suno. Tracks come from paid Suno plans; review Suno's terms for your use case.
Prefer no install? python/tunova.py is stdlib-only — vendor the single file and import it.
Both generate() calls submit a job and poll until the track is delivered. Prefer fire-and-forget?
Use submit() with a callback_url and take an HMAC-signed webhook instead.
Tools: generate_song · wait_for_song · check_song. Same API key, same billed-on-success rule.
If you pass callback_url, Tunova POSTs the terminal job with
X-Webhook-Signature: sha256=<hmac> over <X-Webhook-Timestamp>.<rawBody>, keyed with your
whsec_… secret (view/rotate it on the dashboard's API-keys page). Verify against the raw body
before parsing — both SDKs ship a verifier (Tunova.verify_webhook / verifyWebhook).
MIT — see LICENSE. The SDK code is yours to use freely; your use of the Tunova API is governed by the terms.
Source: README.md at commit 580dbd0
Start generating a song with Suno. Returns immediately with a job_id — a full render takes 1-3 minutes, so this does NOT return audio. After calling this, call wait_for_song with the returned job_id to get the audio URL when ready. Costs 10 tokens, billed only on success.
tagsmodeltitlecustompromptrequiredinstrumentalidempotency_keyWait for a song job to finish and return the audio when ready. Polls server-side for up to ~45 seconds. If the song is ready, returns the clips with audio URLs. If it is still rendering, returns its status so you can call wait_for_song again with the same job_id. Safe to call repeatedly — it only reads status, never starts a new song.
job_idrequiredmax_wait_secondsGet the current status of a song job by job_id — a single check with no waiting. Returns the audio URLs if complete, an error if it failed, or 'processing' if still rendering.
job_idrequired100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
pip install tunovafrom tunova import Tunova
t = Tunova("sk_live_…")job = t.generate("warm lo-fi piano to study to", model="v5.5")print(job["clips"][0]["audio_url"] if job["status"] == "complete" else job["error"])npm i tunovaimport { Tunova } from "tunova";
const t = new Tunova(process.env.TUNOVA_API_KEY!);const job = await t.generate("warm lo-fi piano to study to", { model: "v5.5" });console.log(job.status === "complete" ? job.clips[0]?.audio_url : job.error);claude mcp add --transport http tunova https://api.tunova.ai/mcp \ --header "X-API-Key: sk_live_…"