What a Suno MCP server is, which tools it exposes to Claude (generate, wait, search, sound effects) and when to use the hosted SunoBoard server or the open-source npm package.
01MCP in one paragraph
The Model Context Protocol is a standard way for AI assistants to call tools. A server describes its tools (name, inputs, what they do) and the assistant decides when to call them. A Suno MCP server turns "make me a synthwave track for my racing level" into a real generation request and then hands the finished audio link back to the chat. Comparing options? See our honest Suno API alternative page.
02The tools Claude gets
The SunoBoard server exposes these tools. Claude chains them on its own: it generates, waits, then shows you the link.
- generate_music
style, title, lyrics or instrumental. Returns a task id. - wait_for_music
polls until the two variations are ready and returns the audio links. - get_music_status
one status check for a task id. - list_recent_music
your latest generations, handy for "give me the links from yesterday". - search_library
finds tracks in your library by words in the prompt or title. - generate_sfx
short sound effects from 0.5 to 10 seconds (coins, whooshes, UI clicks, footsteps). - get_usage
how many credits you have left this month (get_credits shows the balance of your own Suno key, if you added one). - get_referral_link
your invite link (both of you get bonus credits).
03Hosted or local?
- Hosted (mcp.sunoboard.com)
no Suno key needed, works as a custom connector in Claude.ai, tracks are saved in your SunoBoard library with their prompts. Uses your SunoBoard plan. - Local (@yellowkode/suno-mcp on npm)
runs on your machine with your own sunoapi.org key. Good if you want everything under your account and do not need the library or the web player.
04Things people automate with it
Because Claude keeps the context of the conversation, one message can drive a whole batch:
Here is the scene list of my short film: (1) opening drone shot over the city, (2) chase in the subway, (3) quiet rooftop conversation, (4) sunrise ending. Use SunoBoard to generate one instrumental cue per scene, wait for all of them and give me a table with scene, mood and both links.
Search my SunoBoard library for tracks with "boss" in the prompt and list them with their links and dates.
05Good prompts for tool use
Say "use SunoBoard" the first time so Claude picks the right tool, ask it to wait until the track is ready, and give the style in concrete words (genre, tempo, instruments, mood). The prompt guide on this blog has a full formula.













