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.
npx skills add mofa-si/sunomv-skill --skill song-to-mvWhat 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
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
generate_stills
Draw the storyboard stills, many shots per call. Omit shots to draw everything still missing.
- 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
lipsync_clips
Optional: make the singer's mouth follow the vocals in sung scenes. Economy tier by default.
- 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.
/plugin marketplace add mofa-si/sunomv-skill
/plugin install sunomv@sunomvnpx skills add mofa-si/sunomv-skill --skill song-to-mvThen connect the MCP
- Open Claude → Settings → Connectors → Add custom connector.
- Paste the MCP URL and click Connect.
- Sign in to SunoMV in the browser window and approve. No account yet? Sign up in the same window.
https://suno.bi/api/mcp- Add the server from a terminal. The browser sign-in opens on the first tool call.
- Or install the plugin: it adds the same server plus the skill.
claude mcp add --transport http sunomv https://suno.bi/api/mcp/plugin marketplace add mofa-si/sunomv-skill
/plugin install sunomv@sunomv- Settings → Apps & Connectors → Advanced settings → turn on Developer mode.
- Create connector, paste the MCP URL, choose OAuth.
- Sign in to SunoMV when asked.
https://suno.bi/api/mcp- Add this to ~/.codex/config.toml.
- Then run codex mcp login sunomv to sign in.
[mcp_servers.sunomv]
url = "https://suno.bi/api/mcp"codex mcp login sunomv- 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.
- 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.
- Type @ in the chat and attach sunomv to the task. Do not run grok mcp add — that is Grok Build.
Add a custom MCP server called sunomv at https://suno.bi/api/mcp- Grok Build is the terminal coding CLI. Run grok mcp add, or put it in ~/.grok/config.toml. OAuth runs on first use.
- For the always-on Grok Bot, do not use this command — see the Grok Bot tab.
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_…"[mcp_servers.sunomv]
url = "https://suno.bi/api/mcp"- Add this to .cursor/mcp.json in the project root (or Cursor Settings → MCP).
- Cursor asks you to sign in to SunoMV after saving.
{
"mcpServers": {
"sunomv": {
"type": "http",
"url": "https://suno.bi/api/mcp"
}
}
}- Add .vscode/mcp.json in your workspace.
- Copilot uses OAuth; a Bearer header skips the sign-in prompt.
{
"servers": {
"sunomv": {
"type": "http",
"url": "https://suno.bi/api/mcp"
}
}
}- 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.
- 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.
https://suno.bi/api/mcp{
"mcpServers": {
"sunomv": {
"type": "http",
"url": "https://suno.bi/api/mcp"
}
}
}{
"mcpServers": {
"sunomv": {
"type": "http",
"url": "https://suno.bi/api/mcp",
"headers": { "Authorization": "Bearer sk_mv_…" }
}
}
}npx skills add mofa-si/sunomv-skill --skill song-to-mvTry it
If the Suno MCP is connected too, ask it to write the song first and hand it to SunoMV.
Make a 9:16 music video for this Suno song with SunoMV: <Suno song link>. Show me the stills before shooting any video.