https://suno.bi/api/mcp
SunoMV MCP · Claude · ChatGPT · Cursor · Codex
Let your AI assistant turn the song into a music video
Connect SunoMV to Claude, ChatGPT, Cursor, or any MCP client. Hand it a Suno link: it shows you storyboard stills first, shoots video and lip sync only after you like them, then exports the MP4 and emails you the link.
Pair it with the Suno MCP: song in, music video out
Suno's own MCP writes the song with your Suno account inside your assistant. SunoMV picks it up from there and makes the video. Connect both and nothing needs to be copied by hand.
1 · Suno MCP
https://api.suno.com/mcp
Generate, extend, or cover a song. Returns a Suno song link.
2 · SunoMV MCP
https://suno.bi/api/mcp
create_mv_project takes that link: aligns lyrics, writes the storyboard, draws stills, and shoots video once you approve.
3 · Your MV
suno.bi + email
export_mv renders in the background and emails you the link. The project page shows progress the whole way.
SunoMV is an independent EvergreenAI product, not affiliated with Suno, Inc. The Suno MCP is in beta and uses your own Suno account.
One step at a time: see the stills before the expensive part
After each step the assistant shows you the suno.bi project page and waits for your go-ahead. Paid tools quote a price first and only charge once you agree.
- 1
create_mv_projectFree for members; one-time song unlock otherwise
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_stillsPer image
Draw the storyboard stills, many shots per call. Omit shots to draw everything still missing.
- 3
shoot_clipsPer second of video
Turn scenes into video clips from their stills, after the user likes the stills. Never reshoots a scene that already has video.
- 4
lipsync_clipsPer scene
Optional: make the singer's mouth follow the vocals in sung scenes. Economy tier by default.
- 5
export_mvFree for members; one-time song unlock otherwise
Render the final MP4 in the background. The user gets an email with the link when it is ready.
Connect the MCP
Clients that can open a browser send you to the SunoMV sign-in on first use. New accounts can sign up right there.
https://suno.bi/api/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/mcpMake a 9:16 music video for this Suno song with SunoMV: <Suno song link>. Show me the stills before shooting any video.MCP tools
Seven tools with stable names. Stills, clips, and lip sync each take many shots or scenes per call.
create_mv_projectImport 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.Free for members; one-time song unlock otherwisegenerate_stillsDraw the storyboard stills, many shots per call. Omit shots to draw everything still missing.Per imageshoot_clipsTurn scenes into video clips from their stills, after the user likes the stills. Never reshoots a scene that already has video.Per second of videolipsync_clipsOptional: make the singer's mouth follow the vocals in sung scenes. Economy tier by default.Per sceneexport_mvRender the final MP4 in the background. The user gets an email with the link when it is ready.Free for members; one-time song unlock otherwiseget_mv_projectProgress, every shot and scene with status and image / video URLs, and nextStep.Freelist_my_mvsFinished music videos, newest first, with MP4 URLs.Free
Agent-readable quick reference
name: SunoMV MCP
what: turn a song (Suno link, suno.bi song, audio / video link) into a lyric music video
endpoint: https://suno.bi/api/mcp
transport: Streamable HTTP
auth: OAuth 2.1 + PKCE (discovery https://suno.bi/.well-known/oauth-protected-resource/api/mcp) or Bearer sk_mv_… from https://suno.bi/user/integration
flow: create_mv_project → generate_stills → (user approves) → shoot_clips → lipsync_clips (optional) → export_mv
rule: one step at a time; show the user projectUrl and ask before the next paid step
credits: paid tools quote first; call again with max_credits = quote.totalCredits after the user agrees; out of credits → https://suno.bi/shop
tools:
- create_mv_project: free for members; one-time song unlock otherwise
- generate_stills: per image
- shoot_clips: per second of video
- lipsync_clips: per scene
- export_mv: free for members; one-time song unlock otherwise
- get_mv_project: free
- list_my_mvs: free
pairs with: Suno MCP https://api.suno.com/mcp (song) → SunoMV (video)
skill: npx skills add mofa-si/sunomv-skill --skill song-to-mv
docs: https://suno.bi/mcp, https://suno.bi/skills, https://suno.bi/llms.txtFAQ
Does it work with the Suno MCP?
Yes. Suno's own MCP (https://api.suno.com/mcp, beta) makes the song with your Suno account; SunoMV makes the video. Connect both, then pass the Suno song link to create_mv_project. SunoMV is an independent product, not affiliated with Suno, Inc.
Will the agent spend my credits without asking?
No. Every paid tool returns a price first and charges nothing. It only charges when called again with max_credits at or above that price, which the agent should do only after you agree. Prices are the same as the buttons on suno.bi.
Why stills first, video later?
Stills are cheap and quick to judge. Video clips cost more per second, so the workflow shows you the storyboard first and only shoots the scenes you like.
How do I get the finished video?
export_mv renders in the background. You get an email with the link in a few minutes, and list_my_mvs returns the MP4 URL. The project page on suno.bi shows everything along the way.
What if I run out of credits?
The tool says so and links to https://suno.bi/shop. Members pay from their monthly allowance first, then from purchased credits.
Does my BibiGPT token work here?
No. SunoMV has its own OAuth and its own sk_mv_ keys. BibiGPT tokens are rejected on suno.bi, and SunoMV keys are rejected on bibigpt.co.