# Shawarma

> Shawarma is a freemium MCP server for design and media. Compose and revise instrumental music from an agent, with versions and MP3/WAV export. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $12 a month
- **Platforms:** API, Web
- **Website:** https://shawarma.studio/developers
- **MCP Registry name:** studio.shawarma/music
- **Categories:** design and media
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http music https://shawarma.studio/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://shawarma.studio/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "music": {
      "url": "https://shawarma.studio/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "music": {
      "type": "http",
      "url": "https://shawarma.studio/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "music": {
      "serverUrl": "https://shawarma.studio/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "music": {
      "type": "http",
      "url": "https://shawarma.studio/mcp"
    }
  }
}
```

## Tools

- `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.

## 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

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/shawarma
