Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "tunova": {
      "type": "http",
      "url": "https://api.tunova.ai/mcp",
      "headers": {
        "X-API-Key": "${X_API_KEY}",
        "Authorization": "${X_API_KEY}"
      }
    }
  }
}

claude mcp add --transport http tunova https://api.tunova.ai/mcp --header "X-API-Key: ${X_API_KEY}" --header "Authorization: ${X_API_KEY}"

[mcp_servers.tunova]
url = "https://api.tunova.ai/mcp"
env_http_headers = { "X-API-Key" = "X_API_KEY", "Authorization" = "X_API_KEY" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "tunova": {
      "type": "remote",
      "url": "https://api.tunova.ai/mcp",
      "enabled": true,
      "headers": {
        "X-API-Key": "{env:X_API_KEY}",
        "Authorization": "{env:X_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "tunova": {
      "type": "http",
      "url": "https://api.tunova.ai/mcp",
      "headers": {
        "X-API-Key": "${X_API_KEY}",
        "Authorization": "${X_API_KEY}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=tunova&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBpLnR1bm92YS5haS9tY3AiLCJoZWFkZXJzIjp7IlgtQVBJLUtleSI6IiR7WF9BUElfS0VZfSIsIkF1dGhvcml6YXRpb24iOiIke1hfQVBJX0tFWX0ifX0%3D"
}

{
  "servers": {
    "tunova": {
      "type": "http",
      "url": "https://api.tunova.ai/mcp",
      "headers": {
        "X-API-Key": "${X_API_KEY}",
        "Authorization": "${X_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "tunova": {
      "httpUrl": "https://api.tunova.ai/mcp",
      "headers": {
        "X-API-Key": "${X_API_KEY}",
        "Authorization": "${X_API_KEY}"
      }
    }
  }
}

extensions:
  "tunova":
    enabled: true
    name: "tunova"
    type: streamable_http
    uri: "https://api.tunova.ai/mcp"
    headers:
      "X-API-Key": "${X_API_KEY}"
      "Authorization": "${X_API_KEY}"
    timeout: 300

Placeholders to fill from your own secret store: ${X_API_KEY}, ${X_API_KEY}. The registry never accepts secret values.

Quality 79 / 100good

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene71 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
fail
tools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
fail
tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: generate_song (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); wait_for_song (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); check_song (readOnlyHint, destructiveHint, idempotentHint, openWorldHint)
pass
tools.token_costabout 606 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability100 · weight 15

pass
stability.changes1 tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

3 tools, about 606 tokens to load them all · tool set 2d0ffffa7806 · tools last changed 2026-10-15 · checked 2026-10-19 10:20 UTC

Tool changes

2026-10-15generate_songchangedinput schema

Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 86 / 100

provenance80

liveness98

freshness65

hygiene100

+repository +namespace-matches-repo +reachable +uptime-95% ~updated-106d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://api.tunova.ai/mcp` streamable-http	api_key `${X_API_KEY}`	yes	95%	265 ms	2025-06-18	2026-10-19

Tools (3)

`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.
`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.
`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.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "io.github.erliona/tunova",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-07-09/server.schema.json",
  "remotes": [
    {
      "url": "https://api.tunova.ai/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "X-API-Key",
          "isSecret": true,
          "isRequired": true,
          "description": "Your Tunova API key (sk_live_…). Get one free at https://tunova.ai"
        }
      ]
    }
  ],
  "version": "0.1.1",
  "repository": {
    "url": "https://github.com/erliona/tunova-sdk",
    "source": "github"
  },
  "description": "Generate Suno AI music (v5.5) from any MCP client. Async; billed only on success."
}