song-to-mv

Agent skill · Claude Code · Codex · Cursor · Gemini CLI

song-to-mv: the agent skill that turns a song into a music video, step by step

The MCP gives your agent the tools; the skill tells it how to use them: stills first, video and lip sync only after you approve, then export — with a price quote before every paid step. Open source, MIT.

Install
npx skills add mofa-si/sunomv-skill --skill song-to-mv

What the skill makes your agent do

One step, then ask

After each step it shows you the suno.bi project page, says what changed, and waits for your go-ahead. It never runs the whole chain on its own.

Quote before charging

Paid tools return a price first. Only after you agree does it call again with max_credits. Prices match the buttons on suno.bi.

Stills before video

Stills are cheap and quick to judge; video is billed per second. It shoots only the scenes you liked.

Five steps to a finished MV

  1. 1

    create_mv_project

    Import a Suno link, a suno.bi song or any audio / video link; align the lyrics; write the storyboard. Same song again returns the same project.

  2. 2

    generate_stills

    Draw the storyboard stills, many shots per call. Omit shots to draw everything still missing.

  3. 3

    shoot_clips

    Turn scenes into video clips from their stills, after the user likes the stills. Never reshoots a scene that already has video.

  4. 4

    lipsync_clips

    Optional: make the singer's mouth follow the vocals in sung scenes. Economy tier by default.

  5. 5

    export_mv

    Render the final MP4 in the background. The user gets an email with the link when it is ready.

Install

The skill has no tools of its own; it works with the SunoMV MCP. In Claude Code the plugin is easiest: it installs both at once.

Claude Code plugin (MCP + skill)
/plugin marketplace add mofa-si/sunomv-skill
/plugin install sunomv@sunomv
Skill only (Claude Code, Codex, Cursor, Gemini CLI, …)
npx skills add mofa-si/sunomv-skill --skill song-to-mv

Then connect the MCP

  1. Open Claude → Settings → Connectors → Add custom connector.
  2. Paste the MCP URL and click Connect.
  3. Sign in to SunoMV in the browser window and approve. No account yet? Sign up in the same window.
MCP URL
https://suno.bi/api/mcp
  1. Add the server from a terminal. The browser sign-in opens on the first tool call.
  2. Or install the plugin: it adds the same server plus the skill.
Terminal
claude mcp add --transport http sunomv https://suno.bi/api/mcp
Plugin (inside Claude Code)
/plugin marketplace add mofa-si/sunomv-skill
/plugin install sunomv@sunomv
  1. Settings → Apps & Connectors → Advanced settings → turn on Developer mode.
  2. Create connector, paste the MCP URL, choose OAuth.
  3. Sign in to SunoMV when asked.
MCP URL
https://suno.bi/api/mcp
  1. Add this to ~/.codex/config.toml.
  2. Then run codex mcp login sunomv to sign in.
~/.codex/config.toml
[mcp_servers.sunomv]
url = "https://suno.bi/api/mcp"
Sign in
codex mcp login sunomv
  1. Grok Bot has no config file. Send the sentence below to your Bot and say "custom server", otherwise it looks in the plugin marketplace, where SunoMV is not listed.
  2. Check the name and URL it repeats back, click Add it, then sign in to SunoMV on the card it shows. If it only shows a token card, paste the sk_mv_ key from https://suno.bi/user/integration there, never into the chat.
  3. Type @ in the chat and attach sunomv to the task. Do not run grok mcp add — that is Grok Build.
Send to Grok Bot
Add a custom MCP server called sunomv at https://suno.bi/api/mcp
  1. Grok Build is the terminal coding CLI. Run grok mcp add, or put it in ~/.grok/config.toml. OAuth runs on first use.
  2. For the always-on Grok Bot, do not use this command — see the Grok Bot tab.
Grok Build CLI
grok mcp add --transport http sunomv https://suno.bi/api/mcp
grok mcp add --transport http sunomv https://suno.bi/api/mcp --header "Authorization: Bearer sk_mv_…"
~/.grok/config.toml
[mcp_servers.sunomv]
url = "https://suno.bi/api/mcp"
  1. Add this to .cursor/mcp.json in the project root (or Cursor Settings → MCP).
  2. Cursor asks you to sign in to SunoMV after saving.
.cursor/mcp.json
{
  "mcpServers": {
    "sunomv": {
      "type": "http",
      "url": "https://suno.bi/api/mcp"
    }
  }
}
  1. Add .vscode/mcp.json in your workspace.
  2. Copilot uses OAuth; a Bearer header skips the sign-in prompt.
.vscode/mcp.json
{
  "servers": {
    "sunomv": {
      "type": "http",
      "url": "https://suno.bi/api/mcp"
    }
  }
}
  1. Any MCP client that speaks Streamable HTTP works. Hosts that can open a browser use OAuth 2.1 with PKCE, and new accounts can register during sign-in.
  2. Headless hosts: get a sk_mv_ key at https://suno.bi/user/integration and send it as Authorization: Bearer. Keys start with sk_mv_ and only work on suno.bi.
Remote MCP server URL
https://suno.bi/api/mcp
mcp.json (OAuth)
{
  "mcpServers": {
    "sunomv": {
      "type": "http",
      "url": "https://suno.bi/api/mcp"
    }
  }
}
mcp.json (Bearer)
{
  "mcpServers": {
    "sunomv": {
      "type": "http",
      "url": "https://suno.bi/api/mcp",
      "headers": { "Authorization": "Bearer sk_mv_…" }
    }
  }
}
Skill (any coding agent)
npx skills add mofa-si/sunomv-skill --skill song-to-mv

Try it

If the Suno MCP is connected too, ask it to write the song first and hand it to SunoMV.

Say to your agent
Make a 9:16 music video for this Suno song with SunoMV: <Suno song link>. Show me the stills before shooting any video.