@chrischall/eventbrite-mcp 0.2.0 → 0.3.0

package/dist/tools/account.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { textResult } from '@chrischall/mcp-utils';
+import { viewArg, viewResponse } from '../view.js';
 import { enc, qs, schemaContinuation } from './params.js';
 /**
  * Account-side tools on the documented API (`eventbriteapi.com/v3`, bearer
@@ -10,45 +10,52 @@ export function registerAccountTools(server, deps) {
     const { client } = deps;
     server.registerTool('eb_me', {
         description: "Get the authenticated Eventbrite user's profile (id, name, primary email).",
+        inputSchema: {
+            view: viewArg(),
+        },
         annotations: { readOnlyHint: true },
-    }, async () => {
+    }, async ({ view }) => {
         const data = await client.request('GET', '/users/me/');
-        return textResult(data);
+        return viewResponse(view, data);
     });
     server.registerTool('eb_my_orders', {
         description: "List the authenticated user's ticket orders (attendee side), with the event expanded. time_filter narrows to upcoming or past events.",
         annotations: { readOnlyHint: true },
         inputSchema: {
+            view: viewArg(),
             time_filter: z
                 .enum(['all', 'current_future', 'past'])
                 .optional()
                 .describe('Filter orders by event time (default all)'),
             continuation: schemaContinuation,
         },
-    }, async ({ time_filter, continuation }) => {
+    }, async ({ time_filter, continuation, view }) => {
         const params = new URLSearchParams({ expand: 'event' });
         if (time_filter)
             params.set('time_filter', time_filter);
         if (continuation)
             params.set('continuation', continuation);
         const data = await client.request('GET', `/users/me/orders/?${params}`);
-        return textResult(data);
+        return viewResponse(view, data);
     });
     server.registerTool('eb_my_organizations', {
         description: 'List the organizations the authenticated user belongs to (organizer side). Use the returned org id with eb_org_events / eb_org_attendees / eb_org_orders.',
         annotations: { readOnlyHint: true },
-        inputSchema: { continuation: schemaContinuation },
-    }, async ({ continuation }) => {
+        inputSchema: {
+            view: viewArg(), continuation: schemaContinuation
+        },
+    }, async ({ continuation, view }) => {
         const params = new URLSearchParams();
         if (continuation)
             params.set('continuation', continuation);
         const data = await client.request('GET', `/users/me/organizations/${qs(params)}`);
-        return textResult(data);
+        return viewResponse(view, data);
     });
     server.registerTool('eb_org_events', {
         description: "List an organization's events (as organizer), optionally filtered by status.",
         annotations: { readOnlyHint: true },
         inputSchema: {
+            view: viewArg(),
             org_id: z.string().describe('Organization id (from eb_my_organizations)'),
             status: z
                 .enum(['all', 'live', 'draft', 'started', 'ended', 'completed', 'canceled'])
@@ -59,7 +66,7 @@ export function registerAccountTools(server, deps) {
                 .optional(),
             continuation: schemaContinuation,
         },
-    }, async ({ org_id, status, order_by, continuation }) => {
+    }, async ({ org_id, status, order_by, continuation, view }) => {
         const params = new URLSearchParams();
         if (status)
             params.set('status', status);
@@ -68,12 +75,13 @@ export function registerAccountTools(server, deps) {
         if (continuation)
             params.set('continuation', continuation);
         const data = await client.request('GET', `/organizations/${enc(org_id)}/events/${qs(params)}`);
-        return textResult(data);
+        return viewResponse(view, data);
     });
     server.registerTool('eb_org_attendees', {
         description: "List attendees across an organization's events (organizer side).",
         annotations: { readOnlyHint: true },
         inputSchema: {
+            view: viewArg(),
             org_id: z.string().describe('Organization id (from eb_my_organizations)'),
             status: z
                 .enum(['attending', 'not_attending', 'unpaid'])
@@ -81,28 +89,29 @@ export function registerAccountTools(server, deps) {
                 .describe('Attendee status filter'),
             continuation: schemaContinuation,
         },
-    }, async ({ org_id, status, continuation }) => {
+    }, async ({ org_id, status, continuation, view }) => {
         const params = new URLSearchParams();
         if (status)
             params.set('status', status);
         if (continuation)
             params.set('continuation', continuation);
         const data = await client.request('GET', `/organizations/${enc(org_id)}/attendees/${qs(params)}`);
-        return textResult(data);
+        return viewResponse(view, data);
     });
     server.registerTool('eb_org_orders', {
         description: "List orders across an organization's events (organizer side).",
         annotations: { readOnlyHint: true },
         inputSchema: {
+            view: viewArg(),
             org_id: z.string().describe('Organization id (from eb_my_organizations)'),
             continuation: schemaContinuation,
         },
-    }, async ({ org_id, continuation }) => {
+    }, async ({ org_id, continuation, view }) => {
         const params = new URLSearchParams();
         if (continuation)
             params.set('continuation', continuation);
         const data = await client.request('GET', `/organizations/${enc(org_id)}/orders/${qs(params)}`);
-        return textResult(data);
+        return viewResponse(view, data);
     });
     // Simple org-scoped collections: same shape, same pagination, different noun.
     const orgCollections = [
@@ -130,12 +139,13 @@ export function registerAccountTools(server, deps) {
             inputSchema: {
                 org_id: z.string().describe('Organization id (from eb_my_organizations)'),
                 continuation: schemaContinuation,
+                view: viewArg(),
             },
-        }, async ({ org_id, continuation }) => {
+        }, async ({ org_id, continuation, view }) => {
             const params = new URLSearchParams();
             if (continuation)
                 params.set('continuation', continuation);
-            return textResult(await client.request('GET', `/organizations/${enc(org_id)}/${noun}/${qs(params)}`));
+            return viewResponse(view, await client.request('GET', `/organizations/${enc(org_id)}/${noun}/${qs(params)}`));
         });
     }
     server.registerTool('eb_org_report', {
@@ -152,8 +162,9 @@ export function registerAccountTools(server, deps) {
                 .optional()
                 .describe("Grouping dimension, e.g. 'event', 'day', 'ticket_class'"),
             continuation: schemaContinuation,
+            view: viewArg(),
         },
-    }, async ({ org_id, kind, start_date, end_date, event_status, group_by, continuation }) => {
+    }, async ({ org_id, kind, start_date, end_date, event_status, group_by, continuation, view }) => {
         const params = new URLSearchParams();
         if (start_date)
             params.set('start_date', start_date);
@@ -165,6 +176,6 @@ export function registerAccountTools(server, deps) {
             params.set('group_by', group_by);
         if (continuation)
             params.set('continuation', continuation);
-        return textResult(await client.request('GET', `/organizations/${enc(org_id)}/reports/${kind}/${qs(params)}`));
+        return viewResponse(view, await client.request('GET', `/organizations/${enc(org_id)}/reports/${kind}/${qs(params)}`));
     });
 }

package/dist/tools/discovery.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
-import { textResult } from '@chrischall/mcp-utils';
+import { resolveView } from '@chrischall/mcp-utils';
+import { EB_VIEWS, viewArg, viewResponse } from '../view.js';
 import { toCompactEvent } from '../discovery.js';
 /**
  * Public event discovery. Verified live 2026-07-30: the documented host serves
@@ -8,23 +9,31 @@ import { toCompactEvent } from '../discovery.js';
  * ARE registered without a bridge. The fetchproxy bridge remains a
  * fallback on the stdio path.
  */
+/**
+ * `eb_search_events` is the ONE tool here whose compact rung is a real field
+ * projection (`toCompactEvent`) rather than the server-wide media strip, so it
+ * names what it keeps instead of borrowing the generic note.
+ */
+const SEARCH_NOTE = 'compact returns { id, name, start date/time, timezone, venue, city, online flag, free/sold-out flags, organizer, summary, url } per event; ' +
+    '"full" returns Eventbrite\'s whole search envelope, every field included.';
 export async function registerDiscoveryTools(server, deps) {
     const { discovery, transport } = deps;
     server.registerTool('eb_resolve_place', {
         description: "Resolve a location to Eventbrite's internal place id for eb_search_events. Accepts a plain location ('Charlotte, NC', 'Berlin, Germany') or a browse slug ('nc--charlotte'). A city on its own is rejected — include the state or country. Returns {placeId, name, slug, region, country} plus `shelves` — curated browse shelves (Popular, This Weekend, Online) harvested free from the same fetch.",
         annotations: { readOnlyHint: true, openWorldHint: true },
         inputSchema: {
+            view: viewArg(),
             location: z
                 .string()
                 .min(2)
                 .describe("Location, e.g. 'Charlotte, NC', 'Berlin, Germany', or the slug 'nc--charlotte'"),
         },
-    }, async ({ location }) => {
+    }, async ({ location, view }) => {
         const place = await discovery.resolveLocation(location);
-        return textResult(place);
+        return viewResponse(view, place);
     });
     server.registerTool('eb_search_events', {
-        description: 'Search public Eventbrite events (the consumer search absent from the documented API). Resolve the location to a place id first with eb_resolve_place. Filters: keyword, dates, category/subcategory/format ids (see eb_reference), free/paid, online-only. Set compact=true for slim results suited to browsing/ranking.',
+        description: 'Search public Eventbrite events (the consumer search absent from the documented API). Resolve the location to a place id first with eb_resolve_place. Filters: keyword, dates, category/subcategory/format ids (see eb_reference), free/paid, online-only. Answers with the slim per-event projection by default; pass view:"full" for Eventbrite\'s whole search envelope.',
         annotations: { readOnlyHint: true, openWorldHint: true },
         inputSchema: {
             q: z.string().optional().describe('Keyword query'),
@@ -49,10 +58,7 @@ export async function registerDiscoveryTools(server, deps) {
                 .array(z.enum(['places_borough', 'places_neighborhood']))
                 .optional()
                 .describe('Facet buckets to aggregate alongside results'),
-            compact: z
-                .boolean()
-                .optional()
-                .describe('Return slim event summaries instead of full records (default false)'),
+            view: viewArg(SEARCH_NOTE),
         },
     }, async (args) => {
         const data = await discovery.search({
@@ -70,34 +76,36 @@ export async function registerDiscoveryTools(server, deps) {
             pageSize: args.page_size,
             aggs: args.aggs,
         });
-        if (args.compact) {
-            const results = data.events?.results;
-            // Drift fallback: if the envelope isn't the shape we know, return the
-            // raw response rather than an empty/wrong projection.
-            if (!Array.isArray(results)) {
-                console.error('[eventbrite-mcp] destination search response missing events.results — returning raw response');
-                return textResult(data);
-            }
-            return textResult({
-                pagination: data.events?.pagination,
-                results: results.map(toCompactEvent),
-            });
+        if (resolveView(args.view, EB_VIEWS) === 'full')
+            return viewResponse('full', data);
+        const results = data.events?.results;
+        // Drift fallback: if the envelope isn't the shape we know, hand back the
+        // raw response rather than an empty or half-filled projection — the same
+        // rule `projectOrRaw` applies, because a record with holes in it is
+        // indistinguishable from "there was nothing there".
+        if (!Array.isArray(results)) {
+            console.error('[eventbrite-mcp] destination search response missing events.results — returning raw response');
+            return viewResponse('full', data);
         }
-        return textResult(data);
+        return viewResponse('full', {
+            pagination: data.events?.pagination,
+            results: results.map(toCompactEvent),
+        });
     });
     server.registerTool('eb_event_details', {
         description: "Batch-fetch public event details by id. Uses your bearer token by default, falling back to the browser bridge when no token is configured. For ticket-class detail prefer eb_ticket_classes.",
         annotations: { readOnlyHint: true, openWorldHint: true },
         inputSchema: {
+            view: viewArg(),
             event_ids: z.array(z.string()).min(1).max(20).describe('Numeric event ids'),
             expand: z
                 .string()
                 .optional()
                 .describe('Comma-separated expansions (default primary_venue,image,ticket_availability,event_sales_status,primary_organizer)'),
         },
-    }, async ({ event_ids, expand }) => {
+    }, async ({ event_ids, expand, view }) => {
         const data = await discovery.eventsByIds(event_ids, expand ? expand.split(',').map((s) => s.trim()) : undefined);
-        return textResult(data);
+        return viewResponse(view, data);
     });
     // eb_healthcheck diagnoses the BRIDGE. With no bridge
     // there is nothing for it to report on, so it is not registered at all —

package/dist/tools/events.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { textResult } from '@chrischall/mcp-utils';
+import { viewArg, viewResponse } from '../view.js';
 import { enc, qs, schemaContinuation } from './params.js';
 /** Reference lists served under /system/ rather than the API root. */
 const SYSTEM_LISTS = new Set(['timezones', 'countries', 'regions']);
@@ -14,48 +14,54 @@ export function registerEventTools(server, deps) {
         description: 'Get an Eventbrite event by id (works for any public event, not just yours). Event ids are the trailing digits in an event URL (…-tickets-<id>).',
         annotations: { readOnlyHint: true },
         inputSchema: {
+            view: viewArg(),
             event_id: z.string().describe('Numeric event id'),
             expand: z
                 .string()
                 .optional()
                 .describe('Comma-separated expansions (default venue,organizer,ticket_availability)'),
         },
-    }, async ({ event_id, expand }) => {
+    }, async ({ event_id, expand, view }) => {
         const exp = expand ?? 'venue,organizer,ticket_availability';
         const data = await client.request('GET', `/events/${encodeURIComponent(event_id)}/?expand=${encodeURIComponent(exp)}`);
-        return textResult(data);
+        return viewResponse(view, data);
     });
     server.registerTool('eb_ticket_classes', {
         description: "List an event's ticket classes (name, cost, free/paid, on-sale status).",
         annotations: { readOnlyHint: true },
-        inputSchema: { event_id: z.string().describe('Numeric event id') },
-    }, async ({ event_id }) => {
+        inputSchema: {
+            view: viewArg(), event_id: z.string().describe('Numeric event id')
+        },
+    }, async ({ event_id, view }) => {
         const data = await client.request('GET', `/events/${encodeURIComponent(event_id)}/ticket_classes/`);
-        return textResult(data);
+        return viewResponse(view, data);
     });
     server.registerTool('eb_event_description', {
         description: "Get an event's full HTML description.",
         annotations: { readOnlyHint: true },
-        inputSchema: { event_id: z.string().describe('Numeric event id') },
-    }, async ({ event_id }) => {
+        inputSchema: {
+            view: viewArg(), event_id: z.string().describe('Numeric event id')
+        },
+    }, async ({ event_id, view }) => {
         const data = await client.request('GET', `/events/${encodeURIComponent(event_id)}/description/`);
-        return textResult(data);
+        return viewResponse(view, data);
     });
     server.registerTool('eb_reference', {
         description: 'List Eventbrite reference data: categories (103=Music, 101=Business, 110=Food & Drink, …), subcategories, formats, timezones, countries or regions. Category/subcategory/format ids feed eb_search_events filters.',
         annotations: { readOnlyHint: true },
         inputSchema: {
+            view: viewArg(),
             kind: z
                 .enum(['categories', 'subcategories', 'formats', 'timezones', 'countries', 'regions'])
                 .describe('Which list to fetch'),
         },
-    }, async ({ kind }) => {
+    }, async ({ kind, view }) => {
         // timezones/countries/regions hang off /system/; the bare /countries/ and
         // /regions/ paths 404 (verified live 2026-07-30). The taxonomy lists
         // (categories, subcategories, formats) sit at the root.
         const path = SYSTEM_LISTS.has(kind) ? `/system/${kind}/` : `/${kind}/`;
         const data = await client.request('GET', path);
-        return textResult(data);
+        return viewResponse(view, data);
     });
     server.registerTool('eb_event_attendees', {
         description: "List a single event's attendees (organizer-side; requires access to that event). Use changed_since to poll incrementally instead of re-reading the whole list.",
@@ -68,8 +74,9 @@ export function registerEventTools(server, deps) {
                 .optional()
                 .describe('ISO 8601 UTC timestamp — only attendees changed since then'),
             continuation: schemaContinuation,
+            view: viewArg(),
         },
-    }, async ({ event_id, status, changed_since, continuation }) => {
+    }, async ({ event_id, status, changed_since, continuation, view }) => {
         const params = new URLSearchParams();
         if (status)
             params.set('status', status);
@@ -77,7 +84,7 @@ export function registerEventTools(server, deps) {
             params.set('changed_since', changed_since);
         if (continuation)
             params.set('continuation', continuation);
-        return textResult(await client.request('GET', `/events/${enc(event_id)}/attendees/${qs(params)}`));
+        return viewResponse(view, await client.request('GET', `/events/${enc(event_id)}/attendees/${qs(params)}`));
     });
     server.registerTool('eb_event_attendee', {
         description: "Get one attendee of an event by id (barcode, profile answers, check-in state).",
@@ -85,8 +92,9 @@ export function registerEventTools(server, deps) {
         inputSchema: {
             event_id: z.string().describe('Numeric event id'),
             attendee_id: z.string().describe('Numeric attendee id'),
+            view: viewArg(),
         },
-    }, async ({ event_id, attendee_id }) => textResult(await client.request('GET', `/events/${enc(event_id)}/attendees/${enc(attendee_id)}/`)));
+    }, async ({ event_id, attendee_id, view }) => viewResponse(view, await client.request('GET', `/events/${enc(event_id)}/attendees/${enc(attendee_id)}/`)));
     server.registerTool('eb_event_orders', {
         description: "List a single event's orders (organizer-side; requires access to that event).",
         annotations: { readOnlyHint: true },
@@ -98,8 +106,9 @@ export function registerEventTools(server, deps) {
                 .optional()
                 .describe('ISO 8601 UTC timestamp — only orders changed since then'),
             continuation: schemaContinuation,
+            view: viewArg(),
         },
-    }, async ({ event_id, status, changed_since, continuation }) => {
+    }, async ({ event_id, status, changed_since, continuation, view }) => {
         const params = new URLSearchParams();
         if (status)
             params.set('status', status);
@@ -107,7 +116,7 @@ export function registerEventTools(server, deps) {
             params.set('changed_since', changed_since);
         if (continuation)
             params.set('continuation', continuation);
-        return textResult(await client.request('GET', `/events/${enc(event_id)}/orders/${qs(params)}`));
+        return viewResponse(view, await client.request('GET', `/events/${enc(event_id)}/orders/${qs(params)}`));
     });
     server.registerTool('eb_ticket_class', {
         description: 'Get one ticket class of an event by id. Use eb_ticket_classes to list them first.',
@@ -115,8 +124,9 @@ export function registerEventTools(server, deps) {
         inputSchema: {
             event_id: z.string().describe('Numeric event id'),
             ticket_class_id: z.string().describe('Numeric ticket class id'),
+            view: viewArg(),
         },
-    }, async ({ event_id, ticket_class_id }) => textResult(await client.request('GET', `/events/${enc(event_id)}/ticket_classes/${enc(ticket_class_id)}/`)));
+    }, async ({ event_id, ticket_class_id, view }) => viewResponse(view, await client.request('GET', `/events/${enc(event_id)}/ticket_classes/${enc(ticket_class_id)}/`)));
     server.registerTool('eb_event_questions', {
         description: "List the registration questions an event asks its buyers. Set canned=true for Eventbrite's standard question bank instead of the event's custom ones.",
         annotations: { readOnlyHint: true },
@@ -126,6 +136,7 @@ export function registerEventTools(server, deps) {
                 .boolean()
                 .optional()
                 .describe("Fetch the standard question bank instead of the event's custom questions"),
+            view: viewArg(),
         },
-    }, async ({ event_id, canned }) => textResult(await client.request('GET', `/events/${enc(event_id)}/${canned ? 'canned_questions' : 'questions'}/`)));
+    }, async ({ event_id, canned, view }) => viewResponse(view, await client.request('GET', `/events/${enc(event_id)}/${canned ? 'canned_questions' : 'questions'}/`)));
 }

package/dist/tools/lookup.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { textResult } from '@chrischall/mcp-utils';
+import { viewArg, viewResponse } from '../view.js';
 import { enc, qs, schemaContinuation, schemaEventStatus } from './params.js';
 /**
  * Single-object lookups on the documented API: resolve an id that appears
@@ -20,18 +20,21 @@ export function registerLookupTools(server, deps) {
                 .string()
                 .optional()
                 .describe("Comma-separated expansions, e.g. 'attendees,event'"),
+            view: viewArg(),
         },
-    }, async ({ order_id, expand }) => {
+    }, async ({ order_id, expand, view }) => {
         const params = new URLSearchParams();
         if (expand)
             params.set('expand', expand);
-        return textResult(await client.request('GET', `/orders/${enc(order_id)}/${qs(params)}`));
+        return viewResponse(view, await client.request('GET', `/orders/${enc(order_id)}/${qs(params)}`));
     });
     server.registerTool('eb_venue', {
         description: 'Get a venue by id (name, address, geo). Venue ids appear on expanded events and in eb_org_venues.',
         annotations: { readOnlyHint: true },
-        inputSchema: { venue_id: z.string().describe('Numeric venue id') },
-    }, async ({ venue_id }) => textResult(await client.request('GET', `/venues/${enc(venue_id)}/`)));
+        inputSchema: { venue_id: z.string().describe('Numeric venue id'),
+            view: viewArg(),
+        },
+    }, async ({ venue_id, view }) => viewResponse(view, await client.request('GET', `/venues/${enc(venue_id)}/`)));
     server.registerTool('eb_venue_events', {
         description: 'List the events held at a venue.',
         annotations: { readOnlyHint: true },
@@ -39,20 +42,23 @@ export function registerLookupTools(server, deps) {
             venue_id: z.string().describe('Numeric venue id'),
             status: schemaEventStatus,
             continuation: schemaContinuation,
+            view: viewArg(),
         },
-    }, async ({ venue_id, status, continuation }) => {
+    }, async ({ venue_id, status, continuation, view }) => {
         const params = new URLSearchParams();
         if (status)
             params.set('status', status);
         if (continuation)
             params.set('continuation', continuation);
-        return textResult(await client.request('GET', `/venues/${enc(venue_id)}/events/${qs(params)}`));
+        return viewResponse(view, await client.request('GET', `/venues/${enc(venue_id)}/events/${qs(params)}`));
     });
     server.registerTool('eb_organizer', {
         description: "Get an organizer's public profile by id (name, description, logo, social links).",
         annotations: { readOnlyHint: true },
-        inputSchema: { organizer_id: z.string().describe('Numeric organizer id') },
-    }, async ({ organizer_id }) => textResult(await client.request('GET', `/organizers/${enc(organizer_id)}/`)));
+        inputSchema: { organizer_id: z.string().describe('Numeric organizer id'),
+            view: viewArg(),
+        },
+    }, async ({ organizer_id, view }) => viewResponse(view, await client.request('GET', `/organizers/${enc(organizer_id)}/`)));
     server.registerTool('eb_organizer_events', {
         description: "List an organizer's events — the public way to see everything one organizer is running.",
         annotations: { readOnlyHint: true },
@@ -61,8 +67,9 @@ export function registerLookupTools(server, deps) {
             status: schemaEventStatus,
             order_by: z.enum(['start_asc', 'start_desc', 'created_asc', 'created_desc']).optional(),
             continuation: schemaContinuation,
+            view: viewArg(),
         },
-    }, async ({ organizer_id, status, order_by, continuation }) => {
+    }, async ({ organizer_id, status, order_by, continuation, view }) => {
         const params = new URLSearchParams();
         if (status)
             params.set('status', status);
@@ -70,7 +77,7 @@ export function registerLookupTools(server, deps) {
             params.set('order_by', order_by);
         if (continuation)
             params.set('continuation', continuation);
-        return textResult(await client.request('GET', `/organizers/${enc(organizer_id)}/events/${qs(params)}`));
+        return viewResponse(view, await client.request('GET', `/organizers/${enc(organizer_id)}/events/${qs(params)}`));
     });
     server.registerTool('eb_series_events', {
         description: 'List the occurrences of a recurring event series. Search results and events carry a series_id when they belong to one.',
@@ -79,18 +86,21 @@ export function registerLookupTools(server, deps) {
             series_id: z.string().describe('Numeric series id (from an event/search result)'),
             status: schemaEventStatus,
             continuation: schemaContinuation,
+            view: viewArg(),
         },
-    }, async ({ series_id, status, continuation }) => {
+    }, async ({ series_id, status, continuation, view }) => {
         const params = new URLSearchParams();
         if (status)
             params.set('status', status);
         if (continuation)
             params.set('continuation', continuation);
-        return textResult(await client.request('GET', `/series/${enc(series_id)}/events/${qs(params)}`));
+        return viewResponse(view, await client.request('GET', `/series/${enc(series_id)}/events/${qs(params)}`));
     });
     server.registerTool('eb_user', {
         description: "Get a public user profile by id. Use eb_me for the authenticated user (that call also returns private fields like emails).",
         annotations: { readOnlyHint: true },
-        inputSchema: { user_id: z.string().describe('Numeric user id') },
-    }, async ({ user_id }) => textResult(await client.request('GET', `/users/${enc(user_id)}/`)));
+        inputSchema: { user_id: z.string().describe('Numeric user id'),
+            view: viewArg(),
+        },
+    }, async ({ user_id, view }) => viewResponse(view, await client.request('GET', `/users/${enc(user_id)}/`)));
 }

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.2.0'; // x-release-please-version
+export const VERSION = '0.3.0'; // x-release-please-version

package/dist/view.js

@@ -0,0 +1,55 @@
+import { minifiedResult, resolveView, stripMediaUrls, viewParam } from '@chrischall/mcp-utils';
+/**
+ * The rungs this server honours (`@chrischall/mcp-utils`' `view` vocabulary;
+ * `chrischall/workflows` `docs/fleet-conventions.md`, "Response shape").
+ *
+ * **This server is in two tiers at once, and the note per tool says which.**
+ *
+ * Most read tools hand back Eventbrite's documented-API payload close to
+ * verbatim, and nothing here has a verified record of which of those fields
+ * matter. For those, compact does the one projection that needs no such
+ * knowledge: it strips image and avatar URLs. That is SUBTRACTIVE, so it
+ * cannot lose a field nobody knew about — the failure an invented field list
+ * would risk, where a record comes back with holes in it and reads like a
+ * verified answer.
+ *
+ * `eb_search_events` is the exception and always was: `toCompactEvent`
+ * (`src/discovery.ts`) is a real, hand-written field projection over the
+ * consumer search payload. The rollout that added this file described the
+ * whole server as un-grounded and did not notice it — the same mistake made in
+ * `viator-mcp` (#69, corrected in #72). A hand-written projection is grounded
+ * knowledge and is NOT then media-stripped: an un-grounded rule must never
+ * overrule a grounded one.
+ *
+ * So `viewArg` takes a per-tool note. A copy-pasted note is worse than a
+ * generic one — it tells a caller to expect a field that was never going to be
+ * there.
+ */
+export const EB_VIEWS = ['compact', 'full'];
+/** The note for the media-strip tier: what compact does when nothing here knows the shape. */
+const MEDIA_STRIP_NOTE = 'compact strips image/avatar URLs from the response; "full" returns Eventbrite\'s payload untouched. ' +
+    'No field projection on this tool: this server has no verified record of which Eventbrite fields matter here, ' +
+    'and inventing one would risk dropping a field a caller needs.';
+/**
+ * The `view` parameter, taken by EVERY read tool in this server.
+ *
+ * Every one, deliberately — 12 of the 26 took it and 14 did not, which makes a
+ * caller memorise a map of which tools accept the vocabulary. An inconsistent
+ * surface is its own defect, and worse than a rung that occasionally has
+ * nothing to strip.
+ */
+export const viewArg = (note = MEDIA_STRIP_NOTE) => viewParam(EB_VIEWS, { note });
+/**
+ * Answer in the requested rung.
+ *
+ * Only ever called from a READ tool. A write's response is a receipt — an id,
+ * a status — with nothing to strip and everything to keep.
+ *
+ * Callers that have ALREADY projected pass `'full'`: the value is theirs to
+ * hand back whole, and media-stripping a hand-written projection on the way
+ * out is exactly the un-grounded-overrules-grounded error.
+ */
+export function viewResponse(view, data) {
+    const rung = resolveView(view, EB_VIEWS);
+    return minifiedResult(rung === 'compact' ? stripMediaUrls(data) : data);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chrischall/eventbrite-mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "mcpName": "io.github.chrischall/eventbrite-mcp",
   "description": "Eventbrite MCP server for Claude — developed and maintained by AI (Claude Code)",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",
@@ -45,7 +45,7 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@chrischall/mcp-utils": "^0.15.0",
+    "@chrischall/mcp-utils": "^0.23.2",
     "@fetchproxy/server": "^2.2.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "dotenv": "^17.4.0",

package/server.json

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