AI-powered music library organization for DJs — safe, smart, and reversible.

Dry Mode by Default

All changes staged in a safe overlay. Review before you commit.

Plans & Workflows

Export, share, and resume operation plans for any library task.

BPM & Key Analysis

Detect BPM and musical key from audio. Camelot wheel compatibility for harmonic mixing.

Rekordbox & Engine DJ

Search, sync, and manage playlists, cues, and crates.

$ bangersss-mcp ingest ~/Downloads/Music → ~/Music/DJ Library

Plan: Organize Summer Set

Dry Mode
Pending Changes (47)
move track01.mp3 → House/DJ Snake/Turn Down for What.mp3
move track02.flac → Techno/Charlotte de Witte/Overdrive.flac
rename AUDIO_003.wav → Acid Jazz/Artist - Track 03.wav
tags song.mp3 → Add BPM: 128, Key: 8B, Genre: House
Commit Changes
Discard All
BPM
128.4
Key
8B 9B 10B 7A 3A 6B 8B Camelot
▶ Library
All Tracks 12,543
▶ Playlists
Sets
Warmup
Peak Time
▶ Crates
House
Techno
Acid Jazz
Track Title Artist BPM Key Genre
Turn Down for What DJ Snake 128 8B House
Overdrive Charlotte de Witte 140 3A Techno
Track 03 Unknown Artist 126 10A Acid Jazz
Midnight Groove Disclosure 124 5B House
Warehouse Green Velvet 132 7A Techno
How it works

Natural language, real results

Bangersss is an MCP server — it connects to AI assistants like Claude, Copilot, Cursor, and Windsurf, giving them 60+ tools to manage your music library.

1

Connect

Add Bangersss to your MCP config for Claude Code, Claude Desktop, Copilot, Cursor, or Windsurf. One line of JSON.

2

Describe

Tell Claude what you want in plain English. "Organize my downloads by genre" or "Find all 128 BPM house tracks."

3

Preview

Every change goes to dry mode first. Review proposed moves, renames, and tag edits before anything happens.

4

Commit

Approve the changes. Files get moved, tags written, playlists updated — all at once, or selectively.

60+ tools

Batteries included

Comprehensive tooling for every part of the DJ library workflow.

Ingest & Scanning 7

  • quick_ingest
  • scan_incoming
  • analyze_incoming
  • check_duplicates
  • stage_ingest
  • scan_directory
  • list_audio_files

Tags & Analysis 8

  • read_tags
  • batch_read_tags
  • write_tags
  • suggest_tags
  • analyze_bpm
  • batch_analyze_bpm
  • analyze_key
  • batch_analyze_key

Key & Harmony 5

  • get_key_info
  • convert_key
  • get_compatible_keys
  • check_key_compatibility
  • list_all_keys

File Operations 4

  • rename_file
  • move_file
  • batch_rename
  • organize_files

Playlists 6

  • create_playlist
  • add_to_playlist
  • remove_from_playlist
  • read_playlist
  • list_playlists
  • export_playlist

Plans 8

  • create_plan
  • add_to_plan
  • view_plan
  • execute_plan
  • export_plan
  • import_plan
  • resume_plan
  • list_plans

Dry Mode 5

  • get_pending_changes
  • preview_change
  • commit_changes
  • discard_changes
  • commit_selective

Rekordbox 8

  • rb_connect
  • rb_search_tracks
  • rb_list_playlists
  • rb_get_playlist_tracks
  • rb_add_to_playlist
  • rb_create_playlist
  • rb_get_cue_points
  • rb_library_stats

Engine DJ 7

  • edj_connect
  • edj_search_tracks
  • edj_list_crates
  • edj_get_crate_tracks
  • edj_add_to_crate
  • edj_create_crate
  • edj_library_stats
Get started

Up and running in minutes

One command to install. One line of JSON to connect. 

# Add to Claude Code MCP settings
# ~/.claude/settings.json or .claude/settings.json
{
  "mcpServers": {
    "bangersss-mcp": {
      "command": "npx",
      "args": ["-y", "bangersss-mcp"]
    }
  }
}
# Add to Claude Desktop config
# ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "bangersss-mcp": {
      "command": "npx",
      "args": ["-y", "bangersss-mcp"]
    }
  }
}
# Add to .vscode/mcp.json in your project
# Requires VS Code 1.99+
{
  "servers": {
    "bangersss-mcp": {
      "command": "npx",
      "args": ["-y", "bangersss-mcp"]
    }
  }
}
# Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global)
{
  "mcpServers": {
    "bangersss-mcp": {
      "command": "npx",
      "args": ["-y", "bangersss-mcp"]
    }
  }
}
# Add to ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "bangersss-mcp": {
      "command": "npx",
      "args": ["-y", "bangersss-mcp"]
    }
  }
}

Supported formats

MP3 FLAC WAV AIFF M4A OGG WMA AAC ALAC

Prerequisites

Node.js ≥ 20 · ffmpeg (for BPM analysis) · keyfinder-cli (for key detection) · Rekordbox or Engine DJ (optional)