Shawarma
Compose and revise instrumental music from an agent, with versions and MP3/WAV export
- Pricing
- Freemium
- Platforms
- API, Web
- Runs
- Remotely
- Version
- 1.26.1
- Listing updated
- 2 days ago
About Shawarma
Shawarma is a freemium MCP server for design and media. It runs as a hosted remote server, so there is nothing to install locally.
A track here is stored as music code, so a request like busier drums rewrites the drum part and leaves the strings alone, and each change is saved as a new version you can roll back to. The site gives an example prompt for a boss-fight loop and a calm podcast intro.
Tools include make_song, change_song, get_song and list_songs, restore_version, share_song for a public link, export_audio in MP3 or WAV, list_sounds (which includes many Arabic instruments such as darbuka, riq, oud and ney with maqam scales), write_song, check_code, guide and get_job. There are two modes: Shawarma composes from words and counts toward monthly chat use, or your agent writes the music code itself and Shawarma checks, saves and plays it, up to 30 tracks a day in 3 projects on the free plan.
Claude.ai and ChatGPT sign in with OAuth; Claude Code, Codex and Cursor use an API key. The same tools are available as a web API.
Install
Run in a terminal
claude mcp add --transport http music https://shawarma.studio/mcpAdd to Settings → Connectors → Add custom connector
https://shawarma.studio/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"music": {
"url": "https://shawarma.studio/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"music": {
"type": "http",
"url": "https://shawarma.studio/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"music": {
"serverUrl": "https://shawarma.studio/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"music": {
"type": "http",
"url": "https://shawarma.studio/mcp"
}
}
}Tools this server provides (12)
Taken from the project documentation; the running server may differ.
- make_song
- Creates a new track from a text description.
- change_song
- Changes only the requested part and saves a new version.
- get_song
- Returns a track's title, code, versions and links.
- list_songs
- Lists saved tracks.
- restore_version
- Returns to an earlier version.
- share_song
- Creates a public link that plays without signing in.
- export_audio
- Exports a track as MP3 or WAV.
- list_sounds
- Lists available sounds, kits and instruments.
- write_song
- Saves music code written by the agent after checking.
- check_code
- Finds mistakes in music code.
- guide
- Returns a short guide for the agent.
- get_job
- Follows a long request until it is ready.
What it does
- Editable tracks
- Tracks are stored as code, so changes touch only the requested part.
- Version history
- Every change is kept and earlier versions can be restored.
- Audio export
- Download as MP3 or WAV on Pro.
- Arabic sound library
- Instruments like darbuka, oud and ney with maqam scales.
- Two compose modes
- Shawarma writes the track, or your agent writes the code.
Good for
- Create background music for a game level
- Make a short podcast intro and tweak it
- Share a track as a public link
- Revert a change that made a track worse
Pricing
Freemium, from $12 a month
Free; Pro $12/month; Studio $29/month
Prices change. Check shawarma.studio before you buy.
Shawarma FAQ
Do I need Pro?
No. On Free the agent writes the code itself, up to 30 tracks a day.
Who owns the tracks?
The page says you own what you make, with some built-in sounds requiring a credit.
How is the API key protected?
Only a fingerprint is stored and the key is shown once; keys can be revoked and cannot change billing.
Which clients are supported?
Claude, ChatGPT, Codex and Cursor, plus a plain web API.
Is Shawarma free?
Shawarma has a free plan, with paid plans for more usage or features. Paid plans start at $12 a month.
How do I add Shawarma to Claude Code?
Run this command in your terminal: claude mcp add --transport http music https://shawarma.studio/mcp
What are the best alternatives to Shawarma?
The closest alternatives to Shawarma are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.
Alternatives to Shawarma

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media