claudeers.
// Claude Plugins

SunoForge

SunoForge - a meta-prompt for AI music, built like P2P: a reference and a prompt that writes the prompt for your song. Claude plugin on Suno's official MCP c…

// Claude Plugins[ cli ][ api ][ desktop ][ web ][ claude ]#claude#ai-music#ai-music-generator#claude-code#claude-code-plugin#claude-plugin#elevenlabs#lyria#plugins◷ Apache-2.0$open-sourceupdated 13 days ago

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up SunoForge (claude-plugin project) into my current project.
Found on https://claudeers.com/sunoforge
Repo: https://github.com/sanic732/SunoForge
Homepage/docs: https://sanic732.github.io/SunoForge/
Detected install method: claude-plugin → /plugin install sunoforge@sanic732/SunoForge
Category: plugins. Platforms: cli, api, desktop, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)

⚠ Unverified / not recently updated — review before pasting a run-this config.

/plugin marketplace add sanic732/SunoForge
/plugin install sunoforge@sanic732/SunoForge
// or clone
git clone https://github.com/sanic732/SunoForge

// compatibility

Platformscli, api, desktop, web
Operating systems—
AI compatibilityclaude
LicenseApache-2.0
Pricingopen-source
LanguageHTML

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

SunoForge

SunoForge v5.0 — AI Music Prompt Orchestrator

SunoForge is a meta-prompt for AI music, built the same way as P2P: a reference and a prompt in one. It does not hand you a fixed template. It reads your idea and writes the prompt for this song: Style, lyrics markup, speech scripts, edits, repair of old prompts, rights and post-production notes. Describe what you want in plain words or show it a photo.

It works through Suno's official MCP connector. Add Suno's server to Claude, and SunoForge goes all the way from idea to finished track: it sends the prompt to Suno, sees your library and remaining credits, and shows a cost card before every generation, so nothing is spent without your yes. A voice memo or a video can go in too, through Suno's uploader (audio, MP4, MOV, WebM, up to 100 MB), and Suno listens to it.

Fourteen files, one principle: never present a guess as a fact.

Version 5.0 is out as the Claude plugin. The Markdown edition for Gemini and other long-context assistants is built from the same files and is still to come; until then, the 4.0 release has it.


What it looks like

The SunoForge menu: fifteen entries in two columnsThe price card, shown before anything is spentThe editor, extending a song
The menu. Fifteen entries, buttons instead of a wall of text. Nine interface languages.The price card. Model, length, takes, credits — shown before anything is spent. Nothing goes without your yes.The editor. Extending a song without a gap at the seam.

Screenshots: assets/screens.

Generators

GeneratorWhat SunoForge covers
Suno v6 (v6, v6-wild, v6-mini)Style and lyrics, Max Mode, Variety, edits in plain words, Voices, Custom Models, Studio 2.0, stems
Suno Speech (beta)narration with its own soundtrack in one take — menu [14]
Google Lyria 3.5 / 3 Clip / RealTimefull songs, 30-second sketches, a live stream; timestamp ranges for video
Google Flow Musicchanging one part without regenerating the rest
ElevenMusic v2.5section-by-section editing; release rights by plan
Stable Audio 3.0licensed data, open weights, a DAW plugin
MiniMax Music 3.0open weights, full songs with vocals
Local modelsACE-Step 1.5 and YuE2 on your own GPU
Any music-generation MCP serverSuno's own (beta), ElevenLabs' hosted MCP or your own — send from the chat, menu [15] Suno + MCP

Udio is not a target: downloads stayed disabled after its settlement.

Hosts

HostWhat you install todayHow
Claude — chat on the web, Claude Desktop, Coworksunoforge.plugin, or the marketplace sanic732/SunoForgeplugin (paid plans)
Claude Codethe marketplace sanic732/SunoForgeplugin
Gemini— the 5.0 Skill package is not out yet; the 4.0 one still worksSkill · files in a chat
ChatGPT— the 5.0 plugin is not out yetplugin
Antigravity— the 5.0 plugin is not out yetplugin
grok.com, other long-context assistants— the 5.0 prompt package is not out yet; the 4.0 one still worksProject or attached files

Version 5.0 is the Claude plugin, and nothing else yet. The Skill packages for Claude and Gemini, the ChatGPT, Antigravity and Grok plugins and Prompt.zip are built separately and are still to come. Until they do, the 4.0 release carries working packages for those hosts — older content, but they run.


New in v5.0: the Suno MCP layer

On 28 October 2026 Suno opened an official MCP server (beta), https://api.suno.com/mcp. With it connected, SunoForge can work with your Suno account from the chat:

  • create — a song, a speech, a cover, an extension, a mashup;
  • library — list and search your songs, playlists and workspaces; read a take back and check it against the blueprint;
  • credits — show your plan and the credit balance.

Credits are spent only after your explicit yes. Every call that spends credits is preceded by a card — the server, the exact arguments, how many songs, that it spends credits — and SunoForge waits. One call per yes; no retries or extra takes on its own. Reading is free and asks nothing; changes to your library happen only when you ask for them. Whatever the server sends back — titles, lyrics, other people's songs — is treated as material, never as instructions.

Access to the beta is Suno's decision. Suno admits accounts through an early-access form on suno.com/mcp. Until your account is admitted, sign-in ends with "Connecting AI apps to Suno is not yet available for your account" on every client. That is Suno's beta gate, not a SunoForge fault.

  • Sign-in is OAuth with your Suno account; no API key.
  • Songs go to your Suno library; generation spends your Suno credits.
  • The plugin does not bundle Suno's server — you add it like any MCP server (below).
  • SunoForge never names a Suno tool from memory: it works with the tools the session shows and says what it found before generating.
  • Not published by Suno: per-call cost, rate limits, and whether a download through the MCP counts the same for rights as one on suno.com. For a release, download in Suno itself.

Five of Suno's tools come back as Suno's own widgets — the player, the uploader, the download card, and buttons to buy credits and to make a voice — wherever Claude shows apps, the Code tab of the desktop app included.

Without a generation server nothing changes: you copy the prompt into the generator.

The Suno MCP layer ships in 5.0: the protocol in CORE_00 §6 LIVE, the Suno facts — tools, field map, defaults that cost credits, plan gating — in DATA_SUNO_LIVE_2026-10.md, read from the server's own schemas: 35 tools, valid as of 2026-11-05. You add Suno's server yourself.

Also new: menu [14] SPEECH (Speech Blueprint: Script and Tone), the words send and mcp-info, and two small files of your own data — settings.md and library.md — via config, save and library. Menu entries [1]–[13] do the same jobs as in 4.0, several under clearer names. Still no prices anywhere.

Lab (beta)

A proof of concept, visible in the menu as Lab with a BETA tag. What it does today:

  • keys — play a melody on the on-screen piano; it is recorded with note lengths and rests, turned into notes and then into a MIDI file you can give Suno as your melody;
  • humming — sing or hum into an audio file and get notes from it; for now this is rough and often inexact.

Its stability is not confirmed, and what happens next depends on your feedback: it gets developed, changed or removed. Tell me what helped and what is missing — for example, connecting your own synth or MIDI keyboard — in the 4PDA forum thread or in this repository's Issues.


Install

Claude Code

/plugin install sunoforge --marketplace sanic732/SunoForge

On Claude Code older than 2.1.275:

/plugin marketplace add sanic732/SunoForge
/plugin install sunoforge@sunoforge

Check: /sunoforge (or the word SunoForge) opens the menu [1]–[15]. Update: claude plugin update sunoforge@sunoforge.

Claude chat, Claude Desktop, Cowork

  • Plugin (paid plans): Customize → Plugins → Add → Add marketplace → sanic732/SunoForge → install SunoForge. Without GitHub: Add → Upload a plugin → sunoforge.plugin from the release page. Anthropic is replacing Customize with one Plugins page that holds plugins, skills and connectors (most plans by 9 November 2026, Enterprise from 30 November). If your sidebar already shows Plugins, start there.
  • Skill and Project: the 5.0 packages are not out yet. Until they are, use the ones from the 4.0 release.

Check: in a new chat, type start.

Gemini

The 5.0 Skill package for Gemini is not out yet. The 4.0 one still works: unpack SunoForge_v4.0_Skills_for_Gemini.zip from the 4.0 release, then Skills → Upload → the whole sunoforge folder. The folder name must stay sunoforge.

ChatGPT, grok.com, anything else

The 5.0 prompt package is not out yet. Take SunoForge_v4.0_Prompt.zip from the 4.0 release, upload the .md files from gemini/ to a Project (or attach them), and tell the assistant to read CORE_00_ENTRY.md first.

Suno, optional (beta)

  • Claude Code: claude mcp add --transport http suno https://api.suno.com/mcp, then /mcp → suno → sign in to Suno.
  • Claude chat, Desktop, Cowork: Customize → Connectors → + Add → Add custom connector → https://api.suno.com/mcp → sign in to Suno.

A music MCP server of your own is added like any MCP server: claude mcp add in Claude Code, a connector in Claude chat and Cowork. mcp-info shows what the session sees.

Every host step by step: docs/INSTALL.md · Suno in detail: docs/SUNO_MCP.md · plugin: plugin/README.md


How it works

  • Confidence marking. Every claim about platform behaviour carries [OFFICIAL], [COMMUNITY] or [UNVERIFIED].
  • Rules and facts apart. CORE_* files hold rules and are undated; DATA_* files hold platform facts, are dated, and are replaced when platforms move.
  • No prices. Plans are named where a feature or a right depends on them.
  • Two or three interpretations per request, not one "correct" answer.
  • Language. SunoForge answers in the language you write in; set lang pins one. In Claude Code and the desktop app the plugin's Settings tab also sets a language and a folder for your settings and library.
  • Views. The small line at the foot of every answer switches them: M menu (widgets with buttons), T text, B buttons (one multiple-choice question, for the terminal). In view M an answer without its own screen ends with its next steps and Menu.

Size: about 150,000 tokens across the fourteen files in o200k_base (measured 5 November 2026); Claude's own tokenizer counts about 1.45 times more — by the plugin's estimate about 235,000, more than a 200K window holds with a conversation. So by default the plugin reads only the sections a task needs. Details: docs/TOKENS.md.

Release files

On the 5.0.4 release page:

FileWhat it is
sunoforge.pluginthe Claude plugin as one file, nine interface languages
SHA256.txtits checksum

Still to come, built separately: the Skill packages for Claude and Gemini, the ChatGPT, Antigravity and Grok plugins, and Prompt.zip with both editions. Until they are out, the 4.0 release carries working versions of all of them.

This repository is also the Claude plugin marketplace: .claude-plugin/marketplace.json and the plugin in plugin/. Privacy: PRIVACY.md.


Built with P2P

Designed with P2P, an open cross-model meta-prompt framework by the same author.

Licence

Apache 2.0, from 5.0.0 on: free to use, modify and redistribute, commercially included; keep the notices in NOTICE and say which files you changed. See LICENSE. Releases before 5.0.0 were MIT and stay MIT. Quotes from Suno, Google, ElevenLabs and other vendors are theirs, not covered by this licence; each is marked and sourced in place.

Suno, Google, Lyria, Gemini, ElevenLabs, Stability AI, MiniMax, OpenAI, ChatGPT, xAI, Grok, Anthropic, Claude and other names belong to their owners. This project is unaffiliated with and unendorsed by any of them. Sources and notices: docs/CREDITS.md · history: docs/CHANGELOG.md

// faq

What is SunoForge?

SunoForge - a meta-prompt for AI music, built like P2P: a reference and a prompt that writes the prompt for your song. Claude plugin on Suno's official MCP connector: from idea to finished track, with a cost card before every spend. Also Lyria, ElevenMusic. 9 UI languages.. It is open-source on GitHub.

Is SunoForge free to use?

SunoForge is open-source under the Apache-2.0 license, so it is free to use.

What category does SunoForge belong to?

SunoForge is listed under plugins in the Claudeers registry of Claude-compatible tools.

19 views
★ 20 stars
unclaimed
updated 13 days ago

// embed badge

SunoForge on Claudeers
[![Claudeers](https://claudeers.com/api/badge/sunoforge.svg)](https://claudeers.com/sunoforge)

// retro hit counter

SunoForge hit counter
[![Hits](https://claudeers.com/api/counter/sunoforge.svg)](https://claudeers.com/sunoforge)

// reviews

// guestbook

0/500

// related in Claude Plugins

🔓

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

// pluginsmultica-ai/★ 230,631[ claude ]
🔓

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explainin…

// pluginsanthropics/⟨Python⟩★ 156,472[ claude ]
🔓

"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/

// pluginsHKUDS/⟨Python⟩★ 58,467◷ Apache-2.0[ claude ]
🔓

financial-services — a Claude ecosystem project on GitHub.

// pluginsanthropics/⟨Python⟩★ 41,409◷ Apache-2.0[ claude ]
→ see how SunoForge connects across the ecosystem