DJ Claude

     _  _                _                 _

__| |(_) _ | | _ _ _ | | _ / _ || | / __| | | / _ || | | |/ _` | / _ \ | (_| || | _ | (__ | || (_| || |_| | (_| || / \,_|| | (_) \___| |_| \__,_| \__,_|\__,_| \___| _/ | |__/

DJ Claude

The live music engine for AI agents.

---

About

DJ Claude is the only music MCP server with multi-agent collaboration. Multiple AI agents connect over HTTP and jam together in real-time — one adds drums, another layers bass, a third drops a melody — and everything composes automatically. It works in your terminal, browser, or as a Claude Code plugin with slash commands. No browser tab, no API key, no external services required.

Under the hood, DJ Claude uses Strudel — a live coding environment for music — to generate and play patterns in real time. 20 MCP tools, 3 resources, conductor mode, mix snapshots, 22 presets, and 8 vibes. Agents can make music for you, themselves, and each other while they work.

Why DJ Claude?

• Multi-agent jam sessions — the first music MCP where multiple agents connect over HTTP and build music together in real-time, each adding layers that compose automatically
• Zero dependencies — no browser tab, no API key, no external services. Every tool works out of the box
• Claude Code plugin — one-step install from the marketplace with 20 slash commands
• Conductor mode — orchestrate a full band from a single directive, with auto-detected templates (jazz combo, rock band, electronic, ambient, and more)
• Agent-native — 3 MCP resources teach any connected agent the Strudel language so it can compose original music, not just pick from presets

Ways to Play

Terminal audio vs. browser audio: By default, the CLI and MCP server render audio through node-web-audio-api — a Node.js reimplementation of the Web Audio API. It works everywhere with zero setup, but sample playback and effects can sound rougher than a real browser engine. Add --browser (CLI) or set DJ_CLAUDE_BROWSER=1 (MCP) to route audio through your system browser's native Web Audio instead. This opens a background tab and produces noticeably higher quality sound — especially for pads, reverb, and layered patterns.

Quick Start

Prerequisites

• Node.js >= 18
• Anthropic API key — optional. Enables AI-generated music from text prompts. Without it, every tool still works via presets, direct Strudel code, or the code/layers parameters

Install & Run

# Set your API key (or add to a .env file)

export ANTHROPIC_API_KEY=sk-ant-...

Launch the terminal DJ

npx dj-claude

Or install globally:

npm i -g dj-claude

dj-claude

Or go headless for scripting:

npx dj-claude --headless "jazzy lo-fi beats" --duration 30

Claude Code Plugin

The easiest way to use DJ Claude with Claude Code. Installs the MCP server and gives you slash commands.

Install

/plugin marketplace add p-poss/dj-claude

/plugin install dj-claude@dj-claude-marketplace

Slash Commands

Or just ask naturally — Claude will call the right tool:

> play some chill lo-fi while I work on this PR

set the vibe to hype

hush

Auto-Allow Permissions

By default, Claude Code prompts for permission on every MCP tool call. To let DJ Claude play without interruptions, add this to .claude/settings.json:

{

"permissions": { "allow": [ "mcpdj-claudeplay_music", "mcpdj-claudeplay_strudel", "mcpdj-claudeset_vibe", "mcpdj-claudelive_mix", "mcpdj-claudehush", "mcpdj-claudenow_playing", "mcpdj-claudejam", "mcpdj-claudejam_clear", "mcpdj-claudejam_status", "mcpdj-claudeset_context", "mcpdj-claudejam_preview", "mcpdj-claudemix_analysis", "mcpdj-claudeconduct", "mcpdj-claudeconduct_evolve", "mcpdj-claudesnapshot_save", "mcpdj-claudesnapshot_load", "mcpdj-claudesnapshot_list", "mcpdj-claudeexport_code", "mcpdj-claudeplay_preset", "mcpdj-claudeswitch_audio" ] } }

MCP Server (Manual Setup)

For the full MCP tool reference, keyless operation guide, and multi-agent details, see docs/MCP.md.

If you prefer manual configuration, or want to use DJ Claude with other MCP clients (Cursor, Windsurf, Zed, etc.), add this to your .mcp.json:

{

"mcpServers": { "dj-claude": { "command": "npx", "args": ["-y", "dj-claude-mcp"] } } }

For higher quality audio through the browser's Web Audio engine:

{

"mcpServers": { "dj-claude": { "command": "npx", "args": ["-y", "dj-claude-mcp"], "env": { "DJ_CLAUDE_BROWSER": "1" } } } }

MCP Tools

Every tool works without an API key — use the code/layers params to pass Strudel directly, or use play_preset/set_vibe for zero-effort music. Add ANTHROPIC_API_KEY to unlock AI generation from text prompts.

MCP Resources

The server exposes Strudel knowledge as MCP resources so agents can learn the syntax and write their own code:

Agents can read these resources, learn the syntax, and then call play_music(code: ...), jam(code: ...), or conduct(layers: ...) — no API key needed.

Keyless Operation

Every tool works without ANTHROPIC_API_KEY. There are three tiers of keyless usage:

1. Zero effort — presets and vibes

play_preset(name: "jazz")          # 22 curated patterns

set_vibe(mood: "chill") # 8 mood presets

2. Direct code — agent writes Strudel

play_music(code: 'stack(s("bd*4").gain(0.75), note("c2").s("sawtooth").lpf(300))')

jam(role: "drums", code: 's("bd*4").gain(0.75)') conduct(layers: { drums: 's("bd*4")', bass: 'note("c1").s("sine")' })

3. Full power — agent learns Strudel from resources

An agent can read strudel://reference to learn the complete syntax, strudel://roles for layer-building guidance, and strudel://examples for working patterns — then compose its own original Strudel code.

This means any AI agent connected via MCP can make music, regardless of whether ANTHROPIC_API_KEY is set. The calling agent IS the LLM.

Multi-Agent Jam Session

Multiple agents can collaborate on music in real time using the HTTP transport and jam tools. Each connected client gets its own MCP session, but they all share the same audio engine and layer state — one agent adds drums while another adds bass, and the layers compose automatically with stack().

Claude Code

Run /dj-claude:connect to auto-start the HTTP server and configure your project in one step:

/dj-claude:connect

/dj-claude:connect 8080 # custom port

This starts the HTTP MCP server, writes .mcp.json, and all other Claude Code sessions in the same project auto-connect.

Other agents (Cursor, Windsurf, OpenClaw, etc.)

Start the HTTP server manually:

# Default port 4321

npx dj-claude-mcp-http

Or with a custom port

DJ_CLAUDE_PORT=8080