Skip to content
MCP server

Shawarma

Compose and revise instrumental music from an agent, with versions and MP3/WAV export

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://shawarma.studio/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "music": {
      "url": "https://shawarma.studio/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media