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
GitHubRead SKILL.mdMCP docs

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

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.