SonodexChatGPT & MCP at a glance
Use ChatGPT or other AI assistants to search tracks, build sets, check transitions and have changes proposed. Only what you confirm in Sonodex is applied.
On this page
What is MCP?Link to “What is MCP?”
MCP (Model Context Protocol) is an open standard through which AI assistants access tools. Sonodex provides such tools for your library. For example, you ask: “Which tracks between 124 and 128 BPM in 8A do I have?” or “Build me a 60-minute hard trance set from 145 to 160 BPM, harmonic, and save it as a playlist.”
What an assistant can doLink to “What an assistant can do”
| Scope | Examples | Changes anything? |
|---|---|---|
| Read & search | Filter tracks by BPM, key and genre, advanced search with combined filters, read playlists, suggest next tracks | No |
| Set builder & transitions | Build sets by length, tempo progression and energy, analyse sets with their real length, rate transitions, improve the order | Only the “save as playlist” suggestion |
| DJ preparation | Analysis with loudness (LUFS), suggest and change cue points, measure and correct the beatgrid, plan transitions in detail | Cues and beatgrid only after your confirmation |
| Library check | Duplicates, missing metadata, suspicious BPM, missing or broken files | No |
| Statistics & history | Most played tracks, played sets, unused tracks | No |
| Playlists & smartlists | Create, add tracks, remove, reorder, rename, copy, smartlist rules | Only after your confirmation |
| Metadata, covers & tags | Correct fields, set or remove covers, assign tags, for up to 500 tracks | Only after your confirmation |
| Library maintenance & files | Compare and merge duplicates, relink missing files, rename or move files, export playlists and metadata, import playlists | Only after your confirmation |
| Player | Load, play, pause, jump in tracks in the preview player, audition transitions | Nothing saved; only with the switch “Assistants may control the player” |
| Audio editing | Shorten copies, adjust tempo, transpose or normalise | New file and new track only after your confirmation; the original stays |
| Manage suggestions | View and withdraw open suggestions, retrieve the history, undo applied changes | Undo only after your confirmation |
All tools with their permissions are listed under Permissions & tools; workflows are described in Prepare tracks with ChatGPT, Maintain your library with ChatGPT and Player & audio editing. An assistant first calls get_capabilities: what the connection may currently do, which tool families are available (including player and audio editing) and why others are not, which fields can be edited per file format and which limits apply.
The basic rule: the assistant only proposesLink to “The basic rule: the assistant only proposes”
No tool changes your library directly. Every change is a suggestion that waits for you under Tasks → Suggestions; a short notice announces it. With “Review”, Sonodex shows it with old and new values (“Confirm changes · AI assistant: ChatGPT”). Only “Apply changes” writes; a suggestion expires after 15 minutes. The assistant cannot confirm on its own. How this works in detail is described under Confirm changes.
Two waysLink to “Two ways”
| Via your Sonodex account | Local MCP server | |
|---|---|---|
| Who it is for | ChatGPT without the technical setup | Your own tunnels and other MCP programs |
| Port forwarding | Not needed | Tunnel to your computer required |
| Sign-in | OAuth with your Sonodex account; permissions on the sign-in page | Secret key in the address |
| Changes | With the permissions “Create and edit playlists” and “Edit tracks” and the matching switches in Sonodex | With the switches in Sonodex; additionally cue workflows |
| Requirement | Sonodex Pro, Sonodex running | Sonodex Pro, Sonodex running |
Setup is described in Connect to ChatGPT and Local MCP server.
What data the assistant seesLink to “What data the assistant sees”
Per track: artist, title, album, genre, BPM, key, energy, duration, rating, tags, format and the file name, plus your playlists and saved sets. For metadata tools also the tags from the file and, if you wish, a small cover preview; for DJ preparation, analysis values, cues and beatgrids. File tools only name the folder relative to your library or watched folder (for example “Music/House”). Audio, full file paths and credentials are not transferred.
Good to knowLink to “Good to know”
- A built set is created from metadata (BPM, key, energy, genre). Listen to the transitions briefly before the gig.
- Statistics only know what is stored in Sonodex: saved set snapshots, imported Rekordbox histories and play counts from imported libraries. If these are missing, the assistant says so instead of guessing.
- Tag and mood suggestions are based on metadata and stored analysis values, not on listening.
- Cue suggestions and transition planning use the saved beatgrid and the structure model. If both are missing, no timestamps are guessed.
- ChatGPT builds sets and suggests cues and grid corrections; you confirm them in Sonodex and can undo them.
Something missing or wrong? Let us know. The app interface is available in English and German.