Tunova MCP
An MCP server that enables AI agents to generate music using Suno AI models v6 and v5.5. It provides tools to generate songs from prompts, check song status, and wait for completion. The service operates on a prepaid token basis where users pay only for successful renders, with automatic refunds for failures.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://api.tunova.ai/mcpWhat its tools do
3 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Not annotated (3)
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Generate music from text prompts
- Check the status of a music generation job
- Wait for a song to complete rendering
- Generate lyrics only
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- Tunova 1.0.0
- MCP protocol negotiated in check
- 2025-06-18
- Tools
- 3 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
3 advertised
generate_song
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.
{
"type": "object",
"required": [
"prompt"
],
"properties": {
"tags": {
"type": "string",
"description": "Style/genre, e.g. 'lofi hip hop, mellow, rainy'. Most useful in custom mode."
},
"model": {
"enum": [
"v6",
"v5.5"
],
"type": "string",
"description": "Suno model: v6, or v5.5 as a compatibility alias for v6. Optional; the account default is unchanged."
},
"title": {
"type": "string",
"description": "Song title (custom mode)."
},
"custom": {
"type": "boolean",
"description": "false (default): describe the song and Suno writes everything. true: `prompt` is the literal lyrics, and `tags`/`title` are used."
},
"prompt": {
"type": "string",
"description": "What the song should be about (simple mode), or the exact lyrics (when custom=true)."
},
"instrumental": {
"type": "boolean",
"description": "If true, generate without vocals."
},
"idempotency_key": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Optional logical-request id. Reuse it to recover one submit; use a new value to intentionally generate the same song again or retry after a terminal failed job. When omitted, Tunova derives a stable key from the song arguments for safe automatic retries."
}
},
"additionalProperties": false
}wait_for_song
Wait 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.
{
"type": "object",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"description": "The job_id returned by generate_song."
},
"max_wait_seconds": {
"type": "number",
"description": "How long to wait before returning (default 45, max 55)."
}
},
"additionalProperties": false
}check_song
Get 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.
{
"type": "object",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"description": "The job_id returned by generate_song."
}
},
"additionalProperties": false
}Prompts
Not advertised
Resources
Not advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 296 ms
- 95th percentile latency
- 296 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 296 ms · metadata changed · 3 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http tunova-mcp https://api.tunova.ai/mcpCodex
codex mcp add tunova-mcp --url https://api.tunova.ai/mcpCursor
{
"mcpServers": {
"tunova-mcp": {
"url": "https://api.tunova.ai/mcp"
}
}
}Cline
{
"mcpServers": {
"tunova-mcp": {
"type": "streamableHttp",
"url": "https://api.tunova.ai/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"tunova-mcp": {
"type": "http",
"url": "https://api.tunova.ai/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http tunova-mcp https://api.tunova.ai/mcpClaude Desktop
https://api.tunova.ai/mcpWindsurf
{
"mcpServers": {
"tunova-mcp": {
"serverUrl": "https://api.tunova.ai/mcp"
}
}
}Let your agent find its tools
Find servers like Tunova MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.