Instant DJ

Official MCP server built into Instant DJ for Mac. Your AI assistant composes whole songs in the Studio, writes loops, mixes, masters to a target loudness and exports WAV, stems or MIDI. Local only.

Tài liệu

Connect your AI assistant to Instant DJ

Instant DJ has an MCP server built in. Connect Claude Code, Codex or any MCP client on the same Mac, and it can compose whole songs in the Studio, build loops, mix, master and export, while you listen and steer.

  • Needs: Instant DJ 1.6 or later on a Mac with Apple silicon, macOS 14 or later.
  • Server: http://127.0.0.1:47231/mcp (MCP over streamable HTTP).
  • Local only: apps on your Mac can connect; web pages and other computers can't.
  • Your assistant, not ours: Instant DJ has no AI inside and sends nothing anywhere. The iPad edition has the Studio but no AI tools.

1. Turn the AI tools on

In Instant DJ, open Setup → AI tools (MCP), or the switch in the Studio's Compose with an AI panel. The panel shows the connect command with a Copy button.

2. Connect your assistant

Claude Code, once, in Terminal (--scope user makes it work from any folder):

claude mcp add --scope user --transport http instantdj http://127.0.0.1:47231/mcp

Codex: add this to ~/.codex/config.toml:

[mcp_servers.instantdj]
url = "http://127.0.0.1:47231/mcp"

Other MCP clients that take a server URL in JSON:

{
  "mcpServers": {
    "instantdj": { "url": "http://127.0.0.1:47231/mcp" }
  }
}

3. Ask

The request the app suggests for a first song:

Use the Instant DJ studio tools. Read the studio guide first, then compose a 3-minute song for me: [the style, the mood, the tempo]. Build it section by section, analyse it, fix what the numbers say, master it to −14 LUFS and export it. Tell me what you could not check by ear.

The assistant can't hear. It reads the song in numbers (loudness, peaks, the balance of each band) and fixes what they show; your ears decide whether it's good. That way of working has a name: assistant-composed music.

What the assistant can do

In the Studio

  • studio guide: how the Studio works and how to write a song in it; read first
  • studio new / open / save / list: start a song, or open, keep and list songs
  • studio_track set / patch / mix: write a track's notes or drum pattern, change part of it, set its level, pan and effects
  • studio play / seek / stop: play the song from any point while you listen
  • studio analyse: loudness, peaks, the balance across six bands and each section's level, with notes on what stands out
  • studio master: set the master for a target loudness, such as −14 LUFS
  • studio export / midi: a WAV or M4A, each track as a stem, or the notes as MIDI
  • studio sounds: browse the instruments, kits and samples a track can use

Across the app

  • describe_app: a map of the app: panels, instruments, keys, parameters and recipes
  • get_state: what is playing, tempo and key, and meters in numbers
  • set_track / undo: write the live loop's tracks in one call, and take an edit back
  • set_param: any knob by name, such as the reverb or the bass filter
  • wait_for_bar: time a change to land on the next bar
  • bounce: render the loop or a whole arrangement to a file, faster than real time
  • project: save and load whole sets
  • screenshot: a picture of the window the assistant can look at

The read-only tools are marked as such, so your client can skip asking for approval on them. Errors come back as a plain sentence the assistant can act on.

Questions

Does it work on iPad or Windows?

No. The AI tools are in the Mac app. The iPad edition, Instant DJ Studio, has the Studio without them, and there is no Windows version.

What does it cost?

Instant DJ is free for 7 days with every feature, then one in-app purchase: US$9.99 during the launch sale, with no subscription. Your AI assistant's own plan is separate.

Can I use what it makes?

The music is built from Instant DJ's own instruments and kits, so there's no stock-music licence to buy for them. Samples you add yourself keep their own terms, and copying a known melody can still infringe.

More

Download Instant DJ on the Mac App Store