vibo-mcp 1.7.0 → 1.8.0

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "MCP server for Vibo (vibodj.com) — plan & manage event music, song requests, ideas, guests, and playlists via natural language",
-    "version": "1.7.0"
+    "version": "1.8.0"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "Vibo",
       "source": "./",
       "description": "MCP server for Vibo — browse & manage events, timeline, songs, the DJ song ideas/questions, guests, and exports to Spotify/Apple Music",
-      "version": "1.7.0",
+      "version": "1.8.0",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "vibo-mcp",
   "displayName": "Vibo",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "MCP server for Vibo (vibodj.com) — plan & manage event music, song requests, ideas, guests, and playlists via natural language",
   "author": {
     "name": "Chris Hall",

package/dist/bundle.js

@@ -35790,7 +35790,7 @@ function toolAnnotations(opts = {}) {
 }
 
 // src/version.ts
-var VERSION = "1.7.0";
+var VERSION = "1.8.0";
 
 // src/client.ts
 import { dirname as dirname2, join as join3 } from "path";
@@ -36569,17 +36569,27 @@ var UPLOAD_USER_PHOTO = `
   }
 `;
 
+// src/view.ts
+var VIBO_VIEWS = ["compact", "full"];
+var NOTE = `compact strips image/avatar URLs from the response; "full" returns Vibo's payload untouched. No field projection: this server has no verified record of which Vibo fields matter, and inventing one would risk dropping a field a caller needs.`;
+var viewArg = () => viewParam(VIBO_VIEWS, { note: NOTE });
+function viewResponse(view, data) {
+  const rung = resolveView(view, VIBO_VIEWS);
+  return minifiedResult(rung === "compact" ? stripMediaUrls(data) : data);
+}
+
 // src/tools/profile.ts
 function registerProfileTools(server, client2) {
   server.registerTool(
     "vibo_get_me",
     {
       description: "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.",
-      annotations: toolAnnotations({ title: "Get my Vibo profile", readOnly: true })
+      annotations: toolAnnotations({ title: "Get my Vibo profile", readOnly: true }),
+      inputSchema: { view: viewArg() }
     },
-    async () => {
+    async ({ view }) => {
       const data = await client2.gql(GET_ME);
-      return minifiedResult(data.me);
+      return viewResponse(view, data.me);
     }
   );
   server.registerTool(
@@ -36745,15 +36755,6 @@ function registerSectionTools(server, client2) {
   );
 }
 
-// src/view.ts
-var VIBO_VIEWS = ["compact", "full"];
-var NOTE = `compact strips image/avatar URLs from the response; "full" returns Vibo's payload untouched. No field projection: this server has no verified record of which Vibo fields matter, and inventing one would risk dropping a field a caller needs.`;
-var viewArg = () => viewParam(VIBO_VIEWS, { note: NOTE });
-function viewResponse(view, data) {
-  const rung = resolveView(view, VIBO_VIEWS);
-  return minifiedResult(rung === "compact" ? stripMediaUrls(data) : data);
-}
-
 // src/song-search.ts
 var NON_ORIGINAL_MARKERS = [
   "karaoke",
@@ -36896,11 +36897,12 @@ function registerSongTools(server, client2) {
         isFlagged: external_exports.boolean().optional().describe("Filter to do-not-play / flagged songs."),
         sortField: external_exports.enum(["likesCount", "createdAt", "title"]).optional(),
         sortDirection: external_exports.enum(["asc", "desc"]).optional(),
+        view: viewArg(),
         limit: limitSchema,
         skip: skipSchema
       }
     },
-    async ({ eventId, sectionId, q, isMustPlay, isFlagged, sortField, sortDirection, limit, skip }) => {
+    async ({ eventId, sectionId, q, isMustPlay, isFlagged, sortField, sortDirection, limit, skip, view }) => {
       const filter = {};
       if (q !== void 0) filter.q = q;
       if (isMustPlay !== void 0) filter.isMustPlay = isMustPlay;
@@ -36913,7 +36915,7 @@ function registerSongTools(server, client2) {
         ...sortField ? { sort: { field: sortField, direction: sortDirection ?? "desc" } } : {}
       };
       const data = await client2.gql(GET_SECTION_SONGS, variables);
-      return minifiedResult(data.getSectionSongs);
+      return viewResponse(view, data.getSectionSongs);
     }
   );
   server.registerTool(
@@ -37100,15 +37102,16 @@ function registerNotificationTools(server, client2) {
       description: "List your Vibo notifications (song additions, comments, DJ updates, etc.) with read state and linked event/section ids.",
       annotations: toolAnnotations({ title: "List Vibo notifications", readOnly: true }),
       inputSchema: {
+        view: viewArg(),
         limit: limitSchema,
         skip: skipSchema
       }
     },
-    async ({ limit, skip }) => {
+    async ({ limit, skip, view }) => {
       const data = await client2.gql(GET_NOTIFICATIONS, {
         pagination: pagination(limit, skip)
       });
-      return minifiedResult(data.getNotifications);
+      return viewResponse(view, data.getNotifications);
     }
   );
   server.registerTool(
@@ -37497,18 +37500,19 @@ function registerIdeasTools(server, client2) {
         eventId: external_exports.string().describe("Event id."),
         sectionId: external_exports.string().describe("Section id (from vibo_list_sections)."),
         songIdeasId: external_exports.string().describe("The _id from vibo_list_section_song_ideas."),
+        view: viewArg(),
         limit: limitSchema,
         skip: skipSchema
       }
     },
-    async ({ eventId, sectionId, songIdeasId, limit, skip }) => {
+    async ({ eventId, sectionId, songIdeasId, limit, skip, view }) => {
       const data = await client2.gql(LIST_SONG_IDEAS_SONGS, {
         eventId,
         sectionId,
         songIdeasId,
         pagination: pagination(limit, skip)
       });
-      return minifiedResult(data.getEventSectionSongIdeasSongs);
+      return viewResponse(view, data.getEventSectionSongIdeasSongs);
     }
   );
 }
@@ -37559,11 +37563,12 @@ function registerCollaborationTools(server, client2) {
       inputSchema: {
         eventId: external_exports.string().describe("Event id."),
         usersType: external_exports.enum(["host", "guest"]).optional().describe("Filter to only hosts or only guests."),
+        view: viewArg(),
         limit: limitSchema.describe("Max items to return (default 20). Applies per group when usersType is omitted."),
         skip: skipSchema
       }
     },
-    async ({ eventId, usersType, limit, skip }) => {
+    async ({ eventId, usersType, limit, skip, view }) => {
       const page = pagination(limit, skip);
       if (usersType) {
         const data = await client2.gql(LIST_EVENT_USERS, {
@@ -37571,13 +37576,13 @@ function registerCollaborationTools(server, client2) {
           usersType,
           pagination: page
         });
-        return minifiedResult({ ...data.eventUsers, usersType });
+        return viewResponse(view, { ...data.eventUsers, usersType });
       }
       const [hosts, guests] = await Promise.all([
         client2.gql(LIST_EVENT_USERS, { eventId, usersType: "host", pagination: page }),
         client2.gql(LIST_EVENT_USERS, { eventId, usersType: "guest", pagination: page })
       ]);
-      return minifiedResult({
+      return viewResponse(view, {
         hosts: hosts.eventUsers.users,
         guests: guests.eventUsers.users,
         hostsCount: hosts.eventUsers.totalCount,

package/dist/tools/collaboration.js

@@ -2,6 +2,7 @@ import { z } from 'zod';
 import { minifiedResult, schemaConfirm, toolAnnotations } from '@chrischall/mcp-utils';
 import { LIST_EVENT_USERS, INVITE_USERS, CHANGE_USER_ROLE, REMOVE_USER } from '../gql.js';
 import { limitSchema, skipSchema, pagination, previewResult } from './shared.js';
+import { viewArg, viewResponse } from '../view.js';
 export function registerCollaborationTools(server, client) {
     server.registerTool('vibo_list_event_users', {
         description: "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.",
@@ -9,10 +10,11 @@ export function registerCollaborationTools(server, client) {
         inputSchema: {
             eventId: z.string().describe('Event id.'),
             usersType: z.enum(['host', 'guest']).optional().describe('Filter to only hosts or only guests.'),
+            view: viewArg(),
             limit: limitSchema.describe('Max items to return (default 20). Applies per group when usersType is omitted.'),
             skip: skipSchema,
         },
-    }, async ({ eventId, usersType, limit, skip }) => {
+    }, async ({ eventId, usersType, limit, skip, view }) => {
         const page = pagination(limit, skip);
         if (usersType) {
             const data = await client.gql(LIST_EVENT_USERS, {
@@ -20,7 +22,7 @@ export function registerCollaborationTools(server, client) {
                 usersType,
                 pagination: page,
             });
-            return minifiedResult({ ...data.eventUsers, usersType });
+            return viewResponse(view, { ...data.eventUsers, usersType });
         }
         // The API returns nothing unless usersType is set, so fetch both groups
         // and merge for the intuitive "everyone on the event" listing.
@@ -28,7 +30,10 @@ export function registerCollaborationTools(server, client) {
             client.gql(LIST_EVENT_USERS, { eventId, usersType: 'host', pagination: page }),
             client.gql(LIST_EVENT_USERS, { eventId, usersType: 'guest', pagination: page }),
         ]);
-        return minifiedResult({
+        // BOTH exits go through the rung. The merged branch is the one that runs
+        // when `usersType` is omitted — the default call — so honouring `view` on
+        // only the filtered branch would leave the common path paying full price.
+        return viewResponse(view, {
             hosts: hosts.eventUsers.users,
             guests: guests.eventUsers.users,
             hostsCount: hosts.eventUsers.totalCount,

package/dist/tools/ideas.js

@@ -2,6 +2,7 @@ import { z } from 'zod';
 import { minifiedResult, toolAnnotations } from '@chrischall/mcp-utils';
 import { LIST_SECTION_SONG_IDEAS, LIST_SONG_IDEAS_SONGS } from '../gql.js';
 import { limitSchema, skipSchema, pagination } from './shared.js';
+import { viewArg, viewResponse } from '../view.js';
 export function registerIdeasTools(server, client) {
     server.registerTool('vibo_list_section_song_ideas', {
         description: "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.",
@@ -27,16 +28,17 @@ export function registerIdeasTools(server, client) {
             eventId: z.string().describe('Event id.'),
             sectionId: z.string().describe('Section id (from vibo_list_sections).'),
             songIdeasId: z.string().describe('The _id from vibo_list_section_song_ideas.'),
+            view: viewArg(),
             limit: limitSchema,
             skip: skipSchema,
         },
-    }, async ({ eventId, sectionId, songIdeasId, limit, skip }) => {
+    }, async ({ eventId, sectionId, songIdeasId, limit, skip, view }) => {
         const data = await client.gql(LIST_SONG_IDEAS_SONGS, {
             eventId,
             sectionId,
             songIdeasId,
             pagination: pagination(limit, skip),
         });
-        return minifiedResult(data.getEventSectionSongIdeasSongs);
+        return viewResponse(view, data.getEventSectionSongIdeasSongs);
     });
 }

package/dist/tools/notifications.js

@@ -2,19 +2,21 @@ import { z } from 'zod';
 import { McpToolError, minifiedResult, schemaConfirm, toolAnnotations } from '@chrischall/mcp-utils';
 import { GET_NOTIFICATIONS, GET_NOTIFICATIONS_COUNT, MARK_AS_READ } from '../gql.js';
 import { limitSchema, skipSchema, pagination, previewResult } from './shared.js';
+import { viewArg, viewResponse } from '../view.js';
 export function registerNotificationTools(server, client) {
     server.registerTool('vibo_list_notifications', {
         description: 'List your Vibo notifications (song additions, comments, DJ updates, etc.) with read state and linked event/section ids.',
         annotations: toolAnnotations({ title: 'List Vibo notifications', readOnly: true }),
         inputSchema: {
+            view: viewArg(),
             limit: limitSchema,
             skip: skipSchema,
         },
-    }, async ({ limit, skip }) => {
+    }, async ({ limit, skip, view }) => {
         const data = await client.gql(GET_NOTIFICATIONS, {
             pagination: pagination(limit, skip),
         });
-        return minifiedResult(data.getNotifications);
+        return viewResponse(view, data.getNotifications);
     });
     server.registerTool('vibo_get_notifications_count', {
         description: 'Get the count of unread Vibo notifications.',

package/dist/tools/profile.js

@@ -1,12 +1,14 @@
 import { minifiedResult, toolAnnotations } from '@chrischall/mcp-utils';
 import { GET_ME } from '../gql.js';
+import { viewArg, viewResponse } from '../view.js';
 export function registerProfileTools(server, client) {
     server.registerTool('vibo_get_me', {
         description: "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.",
         annotations: toolAnnotations({ title: 'Get my Vibo profile', readOnly: true }),
-    }, async () => {
+        inputSchema: { view: viewArg() },
+    }, async ({ view }) => {
         const data = await client.gql(GET_ME);
-        return minifiedResult(data.me);
+        return viewResponse(view, data.me);
     });
     server.registerTool('vibo_healthcheck', {
         description: 'Verify connectivity and authentication to the Vibo API by fetching the current user. Returns ok:true with your account id when credentials work.',

package/dist/tools/songs.js

@@ -16,10 +16,11 @@ export function registerSongTools(server, client) {
             isFlagged: z.boolean().optional().describe('Filter to do-not-play / flagged songs.'),
             sortField: z.enum(['likesCount', 'createdAt', 'title']).optional(),
             sortDirection: z.enum(['asc', 'desc']).optional(),
+            view: viewArg(),
             limit: limitSchema,
             skip: skipSchema,
         },
-    }, async ({ eventId, sectionId, q, isMustPlay, isFlagged, sortField, sortDirection, limit, skip }) => {
+    }, async ({ eventId, sectionId, q, isMustPlay, isFlagged, sortField, sortDirection, limit, skip, view }) => {
         const filter = {};
         if (q !== undefined)
             filter.q = q;
@@ -35,7 +36,7 @@ export function registerSongTools(server, client) {
             ...(sortField ? { sort: { field: sortField, direction: sortDirection ?? 'desc' } } : {}),
         };
         const data = await client.gql(GET_SECTION_SONGS, variables);
-        return minifiedResult(data.getSectionSongs);
+        return viewResponse(view, data.getSectionSongs);
     });
     server.registerTool('vibo_search_songs', {
         description: 'Search for songs to add to a section. ALWAYS query as "<Artist> - <Title>" with a ' +

package/dist/version.js

@@ -2,4 +2,4 @@
 // literal on the line carrying the release marker; every manifest and the MCP
 // server banner import VERSION from here, so there is exactly one place to keep
 // in sync (and one release-please extra-files entry).
-export const VERSION = '1.7.0'; // x-release-please-version
+export const VERSION = '1.8.0'; // x-release-please-version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibo-mcp",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "mcpName": "io.github.chrischall/vibo-mcp",
   "description": "Vibo (vibodj.com) MCP server for Claude — host/couple event music planning & management. Developed and maintained by AI (Claude Code).",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/chrischall/vibo-mcp",
     "source": "github"
   },
-  "version": "1.7.0",
+  "version": "1.8.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "vibo-mcp",
-      "version": "1.7.0",
+      "version": "1.8.0",
       "transport": {
         "type": "stdio"
       },

package/skills/vibo-mcp/SKILL.md

@@ -85,6 +85,61 @@ you get a dry-run preview of exactly what would be sent.
 - `vibo_mark_notifications_read`.
 - `vibo_export_event_to_spotify` / `vibo_export_event_to_apple_music`.
 
+## Response shape (`view`)
+
+**Six of this server's 39 tools take `view: "compact" | "full"`**, and on every
+one of them **`compact` is the DEFAULT**. You get the slim rung without asking.
+
+They are exactly the six reads whose GraphQL document asks Vibo for media:
+
+| Tool | What compact drops |
+| --- | --- |
+| `vibo_search_songs` | `thumbnails { s180x180 original }` per track |
+| `vibo_get_section_songs` | `thumbnails { s180x180 original }` per song |
+| `vibo_list_song_ideas_songs` | `thumbnails { s180x180 original }` per song |
+| `vibo_list_event_users` | `imageUrl` per person (both exits — merged and filtered) |
+| `vibo_list_notifications` | `imageUrl` per notification |
+| `vibo_get_me` | `imageUrl` |
+
+That correspondence is not a coincidence to be maintained by hand: a test in
+`tests/view.test.ts` counts the media selections in `src/gql.ts` and asserts
+the roster of `view`-taking tools matches. Add a seventh selection and it fails.
+
+**Compact here is media stripping, not a field projection.** `src/view.ts`
+writes no field list, because this repo holds no captured Vibo payload to
+derive one from honestly; instead it removes keys whose value is a picture,
+which is subtractive and so cannot drop a field nobody knew about.
+
+What compact does **not** touch is the point of these tools: `songUrl`, the
+`links` block (`spotify` / `youtube` / `appleMusic`) and the `quality` verdict
+all survive. A streaming link is this server's product, not decoration —
+`vibo_add_song_to_section` cannot add anything without `songUrl`, and the
+quality verdict is computed from how many services carry a track. A `null` link
+survives too: an absent key and a null one are the same to `JSON.parse` but not
+to a reader deciding whether a service was checked.
+
+`view: "full"` returns Vibo's payload untouched, cover art included. There is
+deliberately **no `raw` rung**: nothing here re-serialises or normalises the
+GraphQL response, so `full` already IS the upstream payload and a third value
+would silently alias one that exists.
+
+### The other 33 tools have no `view`
+
+- **The 24 mutating tools** (every confirm-gated write, plus
+  `vibo_capture_session`) answer with a dry-run preview or a receipt — an id,
+  a count, a status. Nothing in a receipt is decoration, and slimming one is
+  how you lose the field that says what actually happened.
+- **`vibo_healthcheck`** answers with a connectivity/auth diagnostic. It runs
+  the same `GET_ME` document as `vibo_get_me` and still takes no rung, because
+  it never returns Vibo's user object — it builds `{ok, userId, email}` here.
+  A `view` on it would be a parameter that changes nothing.
+- **The 8 remaining reads hand back Vibo's GraphQL payload as it arrived**, and
+  their documents select no media, so there is nothing for a rung to remove.
+
+A `view` passed to a tool that does not declare one is dropped by zod without a
+warning, so a successful call is never evidence the rung was honoured. Check
+the table above rather than assuming.
+
 ## Typical flow
 
 1. `vibo_list_events` → pick an event id.