Shawarma

npx add-mcp 'https://shawarma.studio/mcp'

Tracks your agent can keep changing

Your agent gets a track it can keep changing, not one finished file. A Shawarma track is written as code, so “busier drums” changes the drums and nothing else. Your agent can open the track next week and pick up where it stopped.

1. Get a key

   Sign in, open Development from your account menu, and make a key. Claude.ai and ChatGPT need no key: you sign in from the app.

2. Paste one line

   Add Shawarma to your agent with the setup below. It takes a minute.

3. Ask for music

   “A calm 20-second intro for my podcast.” Then ask for changes until it is right.

The tools your agent gets

The same tools are a plain web API at https://shawarma.studio/v1 for your own code. Every argument and route is in the API reference.

Tool	What it does	Plan
make_song	A new track from words: style, mood, length.	Pro, from your monthly chat use
change_song	Changes only what was asked and saves a new version.	Pro, from your monthly chat use
get_song / list_songs	Title, code, versions and links.	Free
restore_version	Goes back to an earlier version.	Free
share_song	A public link that plays without signing in.	Free
export_audio	An MP3 or WAV file of the track.	Pro
list_sounds	Many Arabic sounds (darbuka, riq, oud, ney, maqam scales), drum kits and instruments.	Free
write_song	Your agent writes the music code; Shawarma checks it and saves it.	Free
check_code / guide	Finds mistakes in music code, and a short guide for the agent.	Free
get_job	Follows a long request (composing, audio) until it is ready.	Free

Two ways to compose

Pro

Shawarma composes

Your agent sends words and Shawarma writes the track, the same way as in the app. It counts toward your monthly chat use. You can download MP3 and WAV files too.

Free

Your agent composes

Your agent reads the short guide, writes the music code itself, and Shawarma checks, saves, plays and shares it. Up to 30 tracks a day, kept in your 3 projects.

See pricing

Set it up

The address for every agent is https://shawarma.studio/mcp. Replace shk_… with a key from Development, in your account menu.

Claude Code

Run this once in your terminal.

claude mcp add --transport http shawarma https://shawarma.studio/mcp \
  --header "Authorization: Bearer shk_…"

Codex

Add this to ~/.codex/config.toml, then put the key in your shell profile.

[mcp_servers.shawarma]
url = "https://shawarma.studio/mcp"
bearer_token_env_var = "SHAWARMA_API_KEY"

# in ~/.zshrc or ~/.bashrc
export SHAWARMA_API_KEY="shk_…"

Cursor

Add this to ~/.cursor/mcp.json (or.cursor/mcp.json in a project). Cursor uses a key: it has no sign-in to Shawarma.

{
  "mcpServers": {
    "shawarma": {
      "url": "https://shawarma.studio/mcp",
      "headers": { "Authorization": "Bearer shk_…" }
    }
  }
}

Claude.ai

No key to copy: you sign in to Shawarma.

1. Open Settings, then Connectors.
2. Choose Add custom connector and paste the address above.
3. Choose Connect, sign in to Shawarma and choose Allow.

ChatGPT

No key to copy: you sign in to Shawarma.

1. Open Settings, then Apps and connectors. Under Advanced settings, turn on developer mode (custom connectors need it).
2. Choose Create, paste the address above and choose OAuth.
3. Sign in to Shawarma and choose Allow.

Your own code

Call the AI music API over HTTPS with the same key.

curl https://shawarma.studio/v1/songs \
  -H "Authorization: Bearer shk_…" \
  -H "Content-Type: application/json" \
  -d '{"description": "calm 20-second intro for a podcast"}'

Questions

What is an MCP server?

MCP is the way AI agents such as Claude, ChatGPT, Codex and Cursor use outside tools. Add Shawarma once and your agent can make tracks, change them and download audio when you ask.

Do I need Pro?

No. On Free, your agent writes the music code itself, and Shawarma checks, saves, plays and shares it. Up to 30 tracks a day, and they count toward your 3 projects. With Pro, Shawarma composes from your words and your agent can download MP3 and WAV files.

Does it use my agent’s tokens or my Shawarma chat use?

When Shawarma composes, it counts toward your monthly chat use, the same as the chat in the app. When your agent writes the music code itself, your agent does the thinking and Shawarma uses none of it.

Can my agent change a track it made earlier?

Yes. Every track keeps its versions. Ask for busier drums or a longer ending and only that part changes; ask to go back and the earlier version returns.

Is my API key safe?

Shawarma keeps only a fingerprint of each key and shows the key once. Each key has its own limits, and you can revoke it at any time. No key can change billing or delete your account.

Who owns the tracks?

You own what you make and can use it in your videos and games. Some built-in sounds ask for a credit; the list is on the Terms page. Sound credits