io.github.chrischall/vibo-mcp

List your Vibo notifications (song additions, comments, DJ updates, etc.) with read state and linked event/section ids.

Get the count of unread Vibo notifications.

Mark notifications as read — pass specific notificationIds, or readAll:true to clear everything. Confirm-gated.

Edit a timeline section's name, time, note, or description. Subject to the section's host-edit permissions. Confirm-gated.

List the events you're part of (as host or guest). Defaults to upcoming events; pass past:true for events that have already happened. Optionally filter by a search query.

Get full details for one event: title, date/timezone, location, your role, lock status, playlist size, and section/question progress. Use vibo_list_sections for the timeline.

Join an event you were invited to, via its share link or hash (e.g. a vibodj.app.link/... URL someone sent you). Returns the joined event's id. Confirm-gated.

Leave an event you previously joined. Confirm-gated.

Add a contact (host or guest) to an event with their name/email/phone. Confirm-gated.

Capture your Vibo login from a signed-in web.vibodj.com browser tab via the fetchproxy bridge — for accounts that sign in with Apple/Google/Facebook (no password). Requires the fetchproxy browser extension installed and you signed into https://web.vibodj.com; approve the pair code shown on first use. The token is saved locally and reused on future calls.

List the hosts and guests on an event. With no usersType, returns both groups merged ({hosts, guests, hostsCount, guestsCount}) and `limit`/`skip` apply per group; with usersType, returns that one group's page.

Invite people to an event by email (as host or guest). Confirm-gated.

Change an event member's role between host and guest. Confirm-gated.

Remove a member from an event. Confirm-gated.

Set your Vibo profile photo from an image. Pass a local file `path` if the server shares your filesystem; otherwise pass the image bytes as base64 `fileData`. Returns the uploaded image URL. Confirm-gated.

List your playlists from a connected streaming service (Spotify or Apple Music) so you can import songs from them. Requires that source to be connected (see vibo_get_me).

List the tracks in one of your connected-service playlists.

Export an event's song selections to a new Spotify playlist (Spotify must be connected). Returns the playlist URL plus how many tracks exported / failed. Confirm-gated.

Export an event's song selections to a new Apple Music playlist (Apple Music must be connected). Returns the playlist URL plus how many tracks exported / failed. Confirm-gated.

Leave a comment / note for the DJ on a specific song. Confirm-gated.

Delete a comment on a song. Confirm-gated.

Leave a comment on a timeline section. Confirm-gated.

Delete a comment on a timeline section. Confirm-gated.

Get the signed-in Vibo user's profile (id, name, email, phone, locale, and whether Spotify/Apple Music are connected). Use the returned _id to recognize your own songs/contacts.

Verify connectivity and authentication to the Vibo API by fetching the current user. Returns ok:true with your account id when credentials work.

List the DJ's planning questions for a section, with each question's type (text/radio/checkbox/select/link/header), available options, whether it's answered, the current answer, and overall progress. Use the question _id (and option _ids) with vibo_answer_question.

Answer a section planning question. Provide the field matching the question's type: `text` for a text question, `selectedOptions` (array of option _ids from vibo_list_section_questions) for radio/checkbox/select, or `link` (array of URLs) for a link question. Use `otherOptionTitle` with the question's \"other\" option. For photo/file questions, pass local paths (`imagePaths`/`filePaths`) when the server can read your disk, or inline base64 bytes (`images`/`files`) otherwise. Confirm-gated.

Import selected tracks from a connected Spotify/Apple Music playlist into a section. Returns counts of added/existing/ignored. Confirm-gated.

List the songs requested in a section, with who added each, like counts, must-play / do-not-play flags, comments, and streaming links. Sort by likesCount, createdAt, or title.

Search for songs to add to a section. ALWAYS query as "<Artist> - <Title>" with a

Add a song to a section. Pass a song from vibo_search_songs (songUrl is required;

Like or unlike a song in a section. Confirm-gated.

Remove one or more songs from a section. Confirm-gated.

Update songs in a section: mark must-play, flag as do-not-play, and/or set a comment. Provide at least one field. Confirm-gated.

Move songs from one section to another. Confirm-gated.

Reorder songs within a section. Confirm-gated.

List an event's timeline sections (e.g. Ceremony, First Dance, Dinner, Dancing) with each section's id, name, scheduled time, note, song count and progress. Use a section _id with vibo_get_section_songs / vibo_add_song_to_section.

List the DJ's suggested song-idea collections for a section (each with a title, songsCount and _id). Use a song-ideas _id with vibo_list_song_ideas_songs to see the suggested songs, then add the ones you like with vibo_add_song_to_section.

List the suggested songs inside a song-idea collection (returns songUrl/viboSongId/title/artist to pass to vibo_add_song_to_section).