vibo-mcp 1.0.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "vibo-mcp",
+  "owner": {
+    "name": "Chris Hall",
+    "email": "chris.c.hall@gmail.com"
+  },
+  "metadata": {
+    "description": "MCP server for Vibo (vibodj.com) — plan event music, song requests, and playlists via natural language",
+    "version": "1.0.0"
+  },
+  "plugins": [
+    {
+      "name": "vibo-mcp",
+      "displayName": "Vibo",
+      "source": "./",
+      "description": "MCP server for Vibo — browse events and timelines, add/like song requests, and export to Spotify/Apple Music",
+      "version": "1.0.0",
+      "author": {
+        "name": "Chris Hall"
+      },
+      "homepage": "https://github.com/chrischall/vibo-mcp",
+      "repository": "https://github.com/chrischall/vibo-mcp",
+      "license": "MIT",
+      "keywords": ["vibo", "vibodj", "wedding", "dj", "music", "mcp"],
+      "category": "productivity"
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,16 @@
+{
+  "name": "vibo-mcp",
+  "displayName": "Vibo",
+  "version": "1.0.0",
+  "description": "MCP server for Vibo (vibodj.com) — plan event music, song requests, and playlists via natural language",
+  "author": {
+    "name": "Chris Hall",
+    "email": "chris.c.hall@gmail.com"
+  },
+  "homepage": "https://github.com/chrischall/vibo-mcp",
+  "repository": "https://github.com/chrischall/vibo-mcp",
+  "license": "MIT",
+  "keywords": ["vibo", "vibodj", "wedding", "dj", "music", "mcp"],
+  "skills": "./SKILL.md",
+  "mcp": "./.mcp.json"
+}

package/.mcp.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "vibo": {
+      "command": "node",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/dist/index.js"],
+      "env": {
+        "VIBO_EMAIL": "${VIBO_EMAIL}",
+        "VIBO_PASSWORD": "${VIBO_PASSWORD}",
+        "VIBO_ACCESS_TOKEN": "${VIBO_ACCESS_TOKEN}",
+        "VIBO_REFRESH_TOKEN": "${VIBO_REFRESH_TOKEN}"
+      }
+    }
+  }
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chris Hall
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,62 @@
+# vibo-mcp
+
+MCP server for [Vibo](https://vibodj.com) (vibodj.com) — plan your event music
+as a host/couple. Browse your events and timeline, see and add song requests,
+like songs, manage notifications, and export selections to Spotify/Apple Music,
+all via natural language.
+
+> Developed and maintained by AI (Claude Code). Use at your own discretion.
+> Unofficial — not affiliated with Vibo. Works only with your own account/data.
+
+## Install
+
+```json
+{
+  "mcpServers": {
+    "vibo": {
+      "command": "npx",
+      "args": ["-y", "vibo-mcp"],
+      "env": {
+        "VIBO_EMAIL": "you@example.com",
+        "VIBO_PASSWORD": "your_password"
+      }
+    }
+  }
+}
+```
+
+### Authentication
+
+Choose one method:
+
+| Method | Env vars | When |
+|--------|----------|------|
+| Email + password (recommended) | `VIBO_EMAIL`, `VIBO_PASSWORD` | You sign in to Vibo with an email/password. |
+| Captured token | `VIBO_ACCESS_TOKEN` (+ `VIBO_REFRESH_TOKEN`) | Your account uses Apple/Google/Facebook sign-in (no password). Capture `x-token`/`x-refresh-token` from a signed-in `web.vibodj.com` session. |
+
+The server boots without credentials; the config error only surfaces on the
+first tool call.
+
+## How it works
+
+Vibo's app talks to a GraphQL API at `https://api.vibodj.com/v2/graphql`,
+authenticating with an `x-token` header obtained from an email/password
+`signIn`. This server reuses that same flow server-side (no browser needed) and
+wraps the host/couple operations as MCP tools. Every mutating tool is
+confirm-gated: without `confirm: true` it returns a dry-run preview and makes no
+network call.
+
+See [docs/VIBO-API.md](docs/VIBO-API.md) for the reverse-engineered API notes
+and [SKILL.md](SKILL.md) for the full tool list.
+
+## Development
+
+```bash
+npm install
+npm run build   # tsc + esbuild bundle → dist/
+npm test        # vitest
+```
+
+## License
+
+MIT

package/SKILL.md

@@ -0,0 +1,79 @@
+---
+name: vibo-mcp
+description: Access your Vibo (vibodj.com) event music planning via MCP. Use when the user asks about their Vibo events, wedding/event timeline, song requests, playlists, or "do not play" list, or wants to add or like songs, join an event from a share link, or export songs to Spotify/Apple Music. Triggers on phrases like "what's on my Vibo timeline", "add this song to the first dance", "what songs did guests request", "join this Vibo event", or "export our playlist to Spotify". Requires vibo-mcp installed and the vibo server registered (see Setup below).
+---
+
+# vibo-mcp
+
+MCP server for [Vibo](https://vibodj.com) — plan your event music as a host/couple: events, timeline sections, song requests, playlists, and exports, via natural language.
+
+- **npm:** [npmjs.com/package/vibo-mcp](https://www.npmjs.com/package/vibo-mcp)
+- **Source:** [github.com/chrischall/vibo-mcp](https://github.com/chrischall/vibo-mcp)
+
+## Setup
+
+### Option A — npx (recommended)
+
+Add to `.mcp.json` in your project or `~/.claude/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "vibo": {
+      "command": "npx",
+      "args": ["-y", "vibo-mcp"],
+      "env": {
+        "VIBO_EMAIL": "you@example.com",
+        "VIBO_PASSWORD": "your_password"
+      }
+    }
+  }
+}
+```
+
+### Authentication
+
+Pick one:
+
+- **Email + password (recommended):** set `VIBO_EMAIL` and `VIBO_PASSWORD`. The
+  server signs in server-side and manages the token (refreshing as needed).
+- **Captured token (for Apple/Google/Facebook accounts):** set
+  `VIBO_ACCESS_TOKEN` (and `VIBO_REFRESH_TOKEN`) with values captured from a
+  signed-in `web.vibodj.com` session — no password needed.
+
+The server boots without credentials (so it can be installed and probed); the
+config error only appears on the first tool call.
+
+## Tools
+
+### Reads
+- `vibo_get_me` — your profile (and whether Spotify/Apple Music are connected).
+- `vibo_list_events` — your upcoming (or `past:true`) events.
+- `vibo_get_event` — full details for one event.
+- `vibo_list_sections` — an event's timeline (Ceremony, First Dance, Dinner, …).
+- `vibo_get_section_songs` — songs requested in a section, with likes/flags/comments.
+- `vibo_list_section_questions` — the DJ's planning questions for a section (type, options, current answer).
+- `vibo_search_songs` — find songs to add (Vibo catalog or connected Spotify).
+- `vibo_get_playlists` / `vibo_get_playlist_songs` — your connected-service playlists.
+- `vibo_list_notifications` / `vibo_get_notifications_count`.
+- `vibo_healthcheck` — confirm connectivity + auth.
+
+### Writes (confirm-gated)
+Each mutating tool makes **no** network call unless `confirm: true`; without it
+you get a dry-run preview of exactly what would be sent.
+
+- `vibo_add_song_to_section` — add a searched song to a section.
+- `vibo_toggle_song_like` — like/unlike a song.
+- `vibo_join_event` — join via a share link/hash (e.g. a `vibodj.app.link/...` URL).
+- `vibo_leave_event`.
+- `vibo_create_event_contact` — add a host/guest contact.
+- `vibo_answer_question` — answer a section planning question (text / option ids / link).
+- `vibo_mark_notifications_read`.
+- `vibo_export_event_to_spotify` / `vibo_export_event_to_apple_music`.
+
+## Typical flow
+
+1. `vibo_list_events` → pick an event id.
+2. `vibo_list_sections` → pick a section id.
+3. `vibo_search_songs` → get a song's `songUrl`/`viboSongId`.
+4. `vibo_add_song_to_section` (with `confirm: true`).