splitwise-mcp 2.3.0 → 2.4.0

package/dist/index.js

@@ -19,7 +19,7 @@ import { registerUtilityTools } from './tools/utilities.js';
 // client into the same registrars instead of this singleton.
 await runMcp({
     name: 'splitwise-mcp',
-    version: '2.3.0', // x-release-please-version
+    version: '2.4.0', // x-release-please-version
     deps: client,
     banner: '[splitwise-mcp] This project was developed and is maintained by AI (Claude Sonnet 4.6). Use at your own discretion.',
     tools: [

package/dist/project.js

@@ -0,0 +1,184 @@
+import { projectOrRaw, pruneUndefined, stripMediaUrls } from '@chrischall/mcp-utils';
+/**
+ * The compact projection (`@chrischall/mcp-utils`' `view` vocabulary;
+ * `chrischall/workflows` `docs/fleet-conventions.md`, "Response shape").
+ *
+ * `sw_list_groups` did not merely return a large response — it returned one
+ * that DOES NOT FIT. A live call on a 51-group account came back as 192,123
+ * characters and was refused by the host before the model saw a byte of it:
+ * the tool was unusable, not merely expensive.
+ *
+ * Where the weight was, measured on that payload:
+ *
+ * - `avatar` + `tall_avatar` + `cover_photo` — 51.7 KB, 27%
+ * - a `picture` object per member, across 51 groups — 37.7 KB, 20%
+ *
+ * 60% of the whole response was image URLs a model cannot see, cannot fetch,
+ * and would not benefit from if it could. `stripMediaUrls` alone takes the
+ * payload to 51.4 KB (−73%); the field projections below take it to 29.3 KB.
+ *
+ * `full` returns Splitwise's records untouched. There is no `raw` rung: `full`
+ * already is the upstream payload.
+ */
+export const SW_VIEWS = ['compact', 'full'];
+const LABEL = 'splitwise-mcp';
+function asDict(v) {
+    return v !== null && typeof v === 'object' && !Array.isArray(v) ? v : undefined;
+}
+function asList(v) {
+    return Array.isArray(v) ? v : [];
+}
+/** "Alison Hall" from the first/last pair Splitwise returns on every user shape. */
+function nameOf(user) {
+    if (!user)
+        return undefined;
+    const parts = [user.first_name, user.last_name].filter((p) => typeof p === 'string' && p !== '');
+    return parts.length > 0 ? parts.join(' ') : undefined;
+}
+/**
+ * What `compact` does to a person, in the words the caller sees.
+ *
+ * It lives here rather than at the three call sites because it is a
+ * description of `compactPerson` below — and the note it replaced described
+ * something else entirely: "compact drops the avatar URLs" is `viewGeneric`'s
+ * behaviour (`sw_get_notifications`, `sw_get_comments`), not this projection's.
+ * This one keeps five fields and MERGES first_name + last_name into `name`,
+ * which is a good deal more than dropping an avatar and is the part a caller
+ * has to know before it goes looking for `last_name`.
+ */
+export const PERSON_VIEW_NOTE = 'compact returns {id, name, email, registration_status, balance} per person — `name` is first_name + last_name joined, so the separate fields are on "full" only; "full" returns Splitwise\'s whole record.';
+/**
+ * One member or friend. `balance` survives — it is the whole reason to look a
+ * person up — and so does `registration_status`, which is how a caller knows
+ * an invite has not been accepted.
+ */
+export function compactPerson(raw) {
+    const u = asDict(raw) ?? {};
+    // `pruneUndefined`, so an optional field is ABSENT rather than
+    // present-and-undefined: "not reported" and "none" have to stay different
+    // facts at every layer, not only after serialisation.
+    return pruneUndefined({
+        id: u.id,
+        name: nameOf(u),
+        email: u.email,
+        registration_status: u.registration_status,
+        balance: asList(u.balance).length > 0 ? u.balance : undefined,
+    });
+}
+/**
+ * One group.
+ *
+ * `whiteboard`, `whiteboard_lock_version`, `whiteboard_updated_at` and
+ * `whiteboard_updated_by` go: the whiteboard is a UI feature with no tool that
+ * reads it. `simplify_by_default`, `custom_avatar` and `group_reminders` go as
+ * settings nothing here acts on. `original_debts` goes because
+ * `simplified_debts` answers "who owes whom" and the pair differ only when
+ * simplification is on — `full` has both.
+ */
+export function compactGroup(raw) {
+    const g = asDict(raw) ?? {};
+    return pruneUndefined({
+        id: g.id,
+        name: g.name,
+        group_type: g.group_type,
+        updated_at: g.updated_at,
+        members: asList(g.members).map(compactPerson),
+        simplified_debts: asList(g.simplified_debts).length > 0 ? g.simplified_debts : undefined,
+        invite_link: g.invite_link,
+    });
+}
+/**
+ * One expense.
+ *
+ * The share breakdown is the point of an expense, so `users` keeps every
+ * share — but as `{id, name, paid_share, owed_share, net_balance}` rather than
+ * Splitwise's nested `user` object, which repeats the name and an avatar the
+ * record already carried under `created_by`.
+ *
+ * `receipt` survives when there IS one: a receipt is evidence, and
+ * `sw_get_receipt` needs the id. The repeat/reminder/transaction block goes —
+ * eleven near-constant fields (`repeats`, `repeat_interval`, `email_reminder`,
+ * `email_reminder_in_advance`, `next_repeat`, `transaction_method`,
+ * `transaction_confirmed`, `transaction_id`, `transaction_status`,
+ * `expense_bundle_id`, `creation_method`) that were `false`/`null`/`"offline"`
+ * on every expense in a live account.
+ */
+export function compactExpense(raw) {
+    const e = asDict(raw) ?? {};
+    const receipt = asDict(e.receipt);
+    const original = receipt?.original;
+    return pruneUndefined({
+        id: e.id,
+        group_id: e.group_id,
+        description: e.description,
+        details: e.details,
+        cost: e.cost,
+        currency_code: e.currency_code,
+        date: e.date,
+        category: asDict(e.category)?.name,
+        payment: e.payment === true ? true : undefined,
+        created_by: nameOf(asDict(e.created_by)),
+        updated_at: e.updated_at,
+        // Kept only when set. A deleted expense still comes back from the list
+        // endpoint, and a caller that cannot see `deleted_at` will count it.
+        deleted_at: e.deleted_at ?? undefined,
+        comments_count: e.comments_count,
+        repayments: e.repayments,
+        users: asList(e.users).map((entry) => {
+            const u = asDict(entry) ?? {};
+            return {
+                id: u.user_id ?? asDict(u.user)?.id,
+                name: nameOf(asDict(u.user)),
+                paid_share: u.paid_share,
+                owed_share: u.owed_share,
+                net_balance: u.net_balance,
+            };
+        }),
+        // A receipt is evidence; `sw_get_receipt` is how a caller fetches it.
+        has_receipt: typeof original === 'string' ? true : undefined,
+    });
+}
+/**
+ * Project a payload's `<key>` array, or hand the whole thing back.
+ *
+ * Whole-array, never per record: one odd record projected to nothing among
+ * fifty good ones is a hole in the middle of an answer, and indistinguishable
+ * from an expense with no content.
+ */
+function projectList(view, payload, key, map, context) {
+    if (view !== 'compact')
+        return payload;
+    return projectOrRaw(payload, (p) => {
+        const box = asDict(p);
+        const items = box?.[key];
+        if (!box || !Array.isArray(items))
+            throw new Error(`expected a ${key}[] array`);
+        return { ...box, [key]: items.map(map) };
+    }, { label: LABEL, context });
+}
+export const viewGroups = (view, p) => projectList(view, p, 'groups', compactGroup, 'GET /get_groups');
+export const viewFriends = (view, p) => projectList(view, p, 'friends', compactPerson, 'GET /get_friends');
+export const viewExpenses = (view, p) => projectList(view, p, 'expenses', compactExpense, 'GET /get_expenses');
+/** One record under `<key>` rather than an array of them. */
+function projectOne(view, payload, key, map, context) {
+    if (view !== 'compact')
+        return payload;
+    return projectOrRaw(payload, (p) => {
+        const box = asDict(p);
+        if (!box || box[key] === undefined)
+            throw new Error(`expected a ${key} object`);
+        return { ...box, [key]: map(box[key]) };
+    }, { label: LABEL, context });
+}
+export const viewGroup = (view, p) => projectOne(view, p, 'group', compactGroup, 'GET /get_group/{id}');
+export const viewExpense = (view, p) => projectOne(view, p, 'expense', compactExpense, 'GET /get_expense/{id}');
+export const viewUser = (view, p) => projectOne(view, p, 'user', compactPerson, 'GET /get_user/{id}');
+/**
+ * The rung for a payload with no hand-written projection: `compact` still
+ * strips the avatars, which is where most of the weight is anyway.
+ *
+ * NEVER used by `sw_get_receipt`, whose product IS the image URL.
+ */
+export function viewGeneric(view, payload) {
+    return view === 'compact' ? stripMediaUrls(payload) : payload;
+}

package/dist/tools/_confirm.js

@@ -1,4 +1,4 @@
-import { schemaConfirm, textResult } from '@chrischall/mcp-utils';
+import { schemaConfirm, minifiedResult } from '@chrischall/mcp-utils';
 export { schemaConfirm };
 /**
  * Confirm-gate for a mutating tool (the fleet convention). When `confirm` is not
@@ -10,7 +10,7 @@ export { schemaConfirm };
 export function previewUnlessConfirmed(confirm, action, method, path, body) {
     if (confirm === true)
         return null;
-    return textResult({
+    return minifiedResult({
         dryRun: true,
         action,
         method,

package/dist/tools/expenses.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
-import { textResult, buildQueryString } from '@chrischall/mcp-utils';
+import { SW_VIEWS, viewExpense, viewExpenses } from '../project.js';
+import { buildQueryString, minifiedResult, resolveView, viewParam } from '@chrischall/mcp-utils';
 import { previewUnlessConfirmed, schemaConfirm } from './_confirm.js';
 /** Flattens a users array into Splitwise's flat-param JSON format. */
 export function flattenUsers(users) {
@@ -36,6 +37,7 @@ export function registerExpenseTools(server, client) {
         description: 'List or search Splitwise expenses. All filters are optional. Use group_id to filter by group, dated_after/dated_before for date ranges.',
         annotations: { readOnlyHint: true },
         inputSchema: {
+            view: viewParam(SW_VIEWS, { note: 'compact keeps the share breakdown, repayments and receipt presence and drops the avatars and the repeat/reminder/transaction block; "full" returns Splitwise\'s whole records.' }),
             group_id: z.number().describe('Only expenses in this group').optional(),
             friend_id: z.number().describe('Only expenses with this friend').optional(),
             dated_after: z.string().describe('ISO 8601 date — only expenses on or after this date').optional(),
@@ -57,17 +59,18 @@ export function registerExpenseTools(server, client) {
             offset: args.offset,
         });
         const data = await client.request('GET', `/get_expenses${qs}`);
-        return textResult(data);
+        return minifiedResult(viewExpenses(resolveView(args.view, SW_VIEWS), data));
     });
     server.registerTool('sw_get_expense', {
         description: 'Get full details of a single Splitwise expense by id.',
         annotations: { readOnlyHint: true },
         inputSchema: {
+            view: viewParam(SW_VIEWS, { note: 'compact keeps the share breakdown, repayments and receipt presence and drops the avatars and the repeat/reminder/transaction block; "full" returns Splitwise\'s whole records.' }),
             id: z.number().describe('Expense ID'),
         },
-    }, async ({ id }) => {
+    }, async ({ id, view }) => {
         const data = await client.request('GET', `/get_expense/${id}`);
-        return textResult(data);
+        return minifiedResult(viewExpense(resolveView(view, SW_VIEWS), data));
     });
     server.registerTool('sw_create_expense', {
         description: 'Create a Splitwise expense. Use split_equally:true to split evenly among group members, or provide a users array for custom per-person splits (paid_share and owed_share as decimal strings like "25.00"). cost must be a decimal string. Without confirm:true this returns a dry-run preview and makes NO network call; with confirm:true it creates the expense.',
@@ -89,7 +92,7 @@ export function registerExpenseTools(server, client) {
         if (gate)
             return gate;
         const data = await client.request('POST', '/create_expense', body);
-        return textResult(data);
+        return minifiedResult(data);
     });
     server.registerTool('sw_update_expense', {
         description: 'Edit an existing Splitwise expense. Provide expense_id and any fields to change. For custom split updates, the full users array must be provided (the API replaces the entire split). Without confirm:true this returns a dry-run preview and makes NO network call; with confirm:true it updates the expense.',
@@ -112,7 +115,7 @@ export function registerExpenseTools(server, client) {
         if (gate)
             return gate;
         const data = await client.request('POST', `/update_expense/${expense_id}`, body);
-        return textResult(data);
+        return minifiedResult(data);
     });
     server.registerTool('sw_delete_expense', {
         description: 'Soft-delete a Splitwise expense by id. Returns {success: true} on success. Use sw_undelete_expense to restore. Without confirm:true this returns a dry-run preview and makes NO network call; with confirm:true it deletes.',
@@ -126,7 +129,7 @@ export function registerExpenseTools(server, client) {
         if (gate)
             return gate;
         const data = await client.request('POST', `/delete_expense/${id}`);
-        return textResult(data);
+        return minifiedResult(data);
     });
     server.registerTool('sw_undelete_expense', {
         description: 'Restore a soft-deleted Splitwise expense.',
@@ -135,6 +138,6 @@ export function registerExpenseTools(server, client) {
         },
     }, async ({ id }) => {
         const data = await client.request('POST', `/undelete_expense/${id}`);
-        return textResult(data);
+        return minifiedResult(data);
     });
 }

package/dist/tools/friends.js

@@ -1,13 +1,17 @@
 import { z } from 'zod';
-import { textResult, pruneUndefined } from '@chrischall/mcp-utils';
+import { PERSON_VIEW_NOTE, SW_VIEWS, viewFriends } from '../project.js';
+import { minifiedResult, pruneUndefined, resolveView, viewParam } from '@chrischall/mcp-utils';
 import { previewUnlessConfirmed, schemaConfirm } from './_confirm.js';
 export function registerFriendTools(server, client) {
     server.registerTool('sw_list_friends', {
-        description: "List all Splitwise friends with their id, first_name, last_name, and email. Use this to resolve a friend's name to a user_id before adding them to a group or building a custom expense split.",
+        description: "List all Splitwise friends. Use this to resolve a friend's name to a user_id before adding them to a group or building a custom expense split. The compact default returns id, name (first_name + last_name joined), email, registration_status and any non-empty balance per friend; pass view:'full' for Splitwise's raw records, which keep first_name and last_name separate.",
         annotations: { readOnlyHint: true },
-    }, async () => {
+        inputSchema: {
+            view: viewParam(SW_VIEWS, { note: PERSON_VIEW_NOTE }),
+        },
+    }, async ({ view }) => {
         const data = await client.request('GET', '/get_friends');
-        return textResult(data);
+        return minifiedResult(viewFriends(resolveView(view, SW_VIEWS), data));
     });
     server.registerTool('sw_create_friend', {
         description: 'Add a Splitwise friend by email (sends them an invite). Without confirm:true this returns a dry-run preview and makes NO network call; with confirm:true it adds the friend.',
@@ -24,7 +28,7 @@ export function registerFriendTools(server, client) {
         if (gate)
             return gate;
         const data = await client.request('POST', '/create_friend', body);
-        return textResult(data);
+        return minifiedResult(data);
     });
     server.registerTool('sw_delete_friend', {
         description: 'Remove a Splitwise friendship by user id. Without confirm:true this returns a dry-run preview and makes NO network call; with confirm:true it removes the friendship.',
@@ -38,6 +42,6 @@ export function registerFriendTools(server, client) {
         if (gate)
             return gate;
         const data = await client.request('POST', `/delete_friend/${id}`);
-        return textResult(data);
+        return minifiedResult(data);
     });
 }

package/dist/tools/groups.js

@@ -1,23 +1,28 @@
 import { z } from 'zod';
-import { textResult, pruneUndefined } from '@chrischall/mcp-utils';
+import { SW_VIEWS, viewGroup, viewGroups } from '../project.js';
+import { minifiedResult, pruneUndefined, resolveView, viewParam } from '@chrischall/mcp-utils';
 import { previewUnlessConfirmed, schemaConfirm } from './_confirm.js';
 export function registerGroupTools(server, client) {
     server.registerTool('sw_list_groups', {
         description: 'List all Splitwise groups the current user belongs to. Returns id, name, and members for each group. Use this to resolve a group name to its id.',
         annotations: { readOnlyHint: true },
-    }, async () => {
+        inputSchema: {
+            view: viewParam(SW_VIEWS, { note: 'compact drops the avatar/cover-photo URLs (60% of a live 51-group response, which does not fit in a tool result at all) and the whiteboard/reminder settings; "full" returns Splitwise\'s whole records.' }),
+        },
+    }, async ({ view }) => {
         const data = await client.request('GET', '/get_groups');
-        return textResult(data);
+        return minifiedResult(viewGroups(resolveView(view, SW_VIEWS), data));
     });
     server.registerTool('sw_get_group', {
         description: 'Get details of a single Splitwise group including all members and balances.',
         annotations: { readOnlyHint: true },
         inputSchema: {
+            view: viewParam(SW_VIEWS, { note: 'compact drops the avatar/cover-photo URLs (60% of a live 51-group response, which does not fit in a tool result at all) and the whiteboard/reminder settings; "full" returns Splitwise\'s whole records.' }),
             id: z.number().describe('Group ID'),
         },
-    }, async ({ id }) => {
+    }, async ({ id, view }) => {
         const data = await client.request('GET', `/get_group/${id}`);
-        return textResult(data);
+        return minifiedResult(viewGroup(resolveView(view, SW_VIEWS), data));
     });
     server.registerTool('sw_create_group', {
         description: 'Create a new Splitwise group.',
@@ -34,7 +39,7 @@ export function registerGroupTools(server, client) {
         if (gate)
             return gate;
         const data = await client.request('POST', '/create_group', body);
-        return textResult(data);
+        return minifiedResult(data);
     });
     server.registerTool('sw_add_user_to_group', {
         description: "Add a user to a Splitwise group. Provide user_id (preferred, use sw_list_friends to resolve a name) or first_name + last_name + email to invite by email.",
@@ -61,7 +66,7 @@ export function registerGroupTools(server, client) {
         if (gate)
             return gate;
         const data = await client.request('POST', '/add_user_to_group', body);
-        return textResult(data);
+        return minifiedResult(data);
     });
     server.registerTool('sw_remove_user_from_group', {
         description: 'Remove a user from a Splitwise group. Without confirm:true this returns a dry-run preview and makes NO network call; with confirm:true it removes the user.',
@@ -76,7 +81,7 @@ export function registerGroupTools(server, client) {
         if (gate)
             return gate;
         const data = await client.request('POST', '/remove_user_from_group', { group_id, user_id });
-        return textResult(data);
+        return minifiedResult(data);
     });
     server.registerTool('sw_delete_group', {
         description: 'Soft-delete a Splitwise group. Without confirm:true this returns a dry-run preview and makes NO network call; with confirm:true it deletes.',
@@ -90,7 +95,7 @@ export function registerGroupTools(server, client) {
         if (gate)
             return gate;
         const data = await client.request('POST', `/delete_group/${id}`);
-        return textResult(data);
+        return minifiedResult(data);
     });
     server.registerTool('sw_undelete_group', {
         description: 'Restore a soft-deleted Splitwise group.',
@@ -99,6 +104,6 @@ export function registerGroupTools(server, client) {
         },
     }, async ({ id }) => {
         const data = await client.request('POST', `/undelete_group/${id}`);
-        return textResult(data);
+        return minifiedResult(data);
     });
 }

package/dist/tools/receipts.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { textResult, imageResult, resolveOutputDir, writeBinaryOutput, sniffMimeBytes, } from '@chrischall/mcp-utils';
+import { minifiedResult, imageResult, resolveOutputDir, writeBinaryOutput, sniffMimeBytes, } from '@chrischall/mcp-utils';
 /** Cap on bytes returned as base64 in the tool result. */
 const MAX_INLINE_BYTES = 4 * 1024 * 1024;
 /** Cap on extracted characters, so a long PDF can't flood the result. */
@@ -210,7 +210,7 @@ export function registerReceiptTools(server, client) {
                 advice,
             ].join(' '));
         }
-        const result = textResult({
+        const result = minifiedResult({
             expense_id: id,
             size: served,
             ...(served !== wanted

package/dist/tools/user.js

@@ -1,23 +1,28 @@
 import { z } from 'zod';
-import { textResult, pruneUndefined } from '@chrischall/mcp-utils';
+import { PERSON_VIEW_NOTE, SW_VIEWS, viewUser } from '../project.js';
+import { minifiedResult, pruneUndefined, resolveView, viewParam } from '@chrischall/mcp-utils';
 import { previewUnlessConfirmed, schemaConfirm } from './_confirm.js';
 export function registerUserTools(server, client) {
     server.registerTool('sw_get_current_user', {
-        description: "Get the authenticated Splitwise user's profile (id, first_name, last_name, email). Use the returned id when building custom expense splits.",
+        description: "Get the authenticated Splitwise user's profile. Use the returned id when building custom expense splits. The compact default returns id, name (first_name + last_name joined), email and registration_status; pass view:'full' for Splitwise's raw record, which keeps first_name and last_name separate — the form sw_update_user takes.",
         annotations: { readOnlyHint: true },
-    }, async () => {
+        inputSchema: {
+            view: viewParam(SW_VIEWS, { note: PERSON_VIEW_NOTE }),
+        },
+    }, async ({ view }) => {
         const data = await client.request('GET', '/get_current_user');
-        return textResult(data);
+        return minifiedResult(viewUser(resolveView(view, SW_VIEWS), data));
     });
     server.registerTool('sw_get_user', {
-        description: "Get another Splitwise user's profile by id.",
+        description: "Get another Splitwise user's profile by id. Same shape as sw_get_current_user: the compact default merges first_name/last_name into name, and view:'full' keeps them separate.",
         annotations: { readOnlyHint: true },
         inputSchema: {
+            view: viewParam(SW_VIEWS, { note: PERSON_VIEW_NOTE }),
             id: z.number().describe('User ID'),
         },
-    }, async ({ id }) => {
+    }, async ({ id, view }) => {
         const data = await client.request('GET', `/get_user/${id}`);
-        return textResult(data);
+        return minifiedResult(viewUser(resolveView(view, SW_VIEWS), data));
     });
     server.registerTool('sw_update_user', {
         description: "Update the current user's profile fields. id must be the current user's id.",
@@ -39,6 +44,6 @@ export function registerUserTools(server, client) {
         if (gate)
             return gate;
         const data = await client.request('POST', `/update_user/${id}`, body);
-        return textResult(data);
+        return minifiedResult(data);
     });
 }

package/dist/tools/utilities.js

@@ -1,39 +1,44 @@
 import { z } from 'zod';
-import { textResult, buildQueryString } from '@chrischall/mcp-utils';
+import { SW_VIEWS, viewGeneric } from '../project.js';
+import { buildQueryString, minifiedResult, resolveView, viewParam } from '@chrischall/mcp-utils';
 import { previewUnlessConfirmed, schemaConfirm } from './_confirm.js';
 export function registerUtilityTools(server, client) {
     server.registerTool('sw_get_notifications', {
         description: 'Get recent Splitwise activity notifications for the current user.',
         annotations: { readOnlyHint: true },
-    }, async () => {
+        inputSchema: {
+            view: viewParam(SW_VIEWS, { note: 'compact drops the avatar URLs; "full" returns Splitwise\'s whole record.' }),
+        },
+    }, async ({ view }) => {
         const data = await client.request('GET', '/get_notifications');
-        return textResult(data);
+        return minifiedResult(viewGeneric(resolveView(view, SW_VIEWS), data));
     });
     server.registerTool('sw_get_categories', {
         description: 'Get the hierarchical list of Splitwise expense categories. Use the returned id as category_id when creating expenses.',
         annotations: { readOnlyHint: true },
     }, async () => {
         const data = await client.request('GET', '/get_categories');
-        return textResult(data);
+        return minifiedResult(data);
     });
     server.registerTool('sw_get_currencies', {
         description: 'Get all Splitwise-supported currency codes and units. Use the currency_code value when creating expenses in non-default currencies.',
         annotations: { readOnlyHint: true },
     }, async () => {
         const data = await client.request('GET', '/get_currencies');
-        return textResult(data);
+        return minifiedResult(data);
     });
     server.registerTool('sw_get_comments', {
         description: 'Get all comments on a Splitwise expense.',
         annotations: { readOnlyHint: true },
         inputSchema: {
+            view: viewParam(SW_VIEWS, { note: 'compact drops the avatar URLs; "full" returns Splitwise\'s whole record.' }),
             expense_id: z.number().describe('Expense ID to get comments for'),
         },
-    }, async ({ expense_id }) => {
+    }, async ({ expense_id, view }) => {
         // buildQueryString percent-encodes the value — defense-in-depth against
         // query-param injection (already constrained to a number by the schema).
         const data = await client.request('GET', `/get_comments${buildQueryString({ expense_id })}`);
-        return textResult(data);
+        return minifiedResult(viewGeneric(resolveView(view, SW_VIEWS), data));
     });
     server.registerTool('sw_create_comment', {
         description: 'Add a comment to a Splitwise expense (visible to other participants). Without confirm:true this returns a dry-run preview and makes NO network call; with confirm:true it posts.',
@@ -48,7 +53,7 @@ export function registerUtilityTools(server, client) {
         if (gate)
             return gate;
         const data = await client.request('POST', '/create_comment', { expense_id, content });
-        return textResult(data);
+        return minifiedResult(data);
     });
     server.registerTool('sw_delete_comment', {
         description: 'Delete a comment by id. Without confirm:true this returns a dry-run preview and makes NO network call; with confirm:true it deletes.',
@@ -62,6 +67,6 @@ export function registerUtilityTools(server, client) {
         if (gate)
             return gate;
         const data = await client.request('POST', `/delete_comment/${id}`);
-        return textResult(data);
+        return minifiedResult(data);
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "splitwise-mcp",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "mcpName": "io.github.chrischall/splitwise-mcp",
   "description": "Splitwise 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.19.2",
+    "@chrischall/mcp-utils": "^0.23.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "dotenv": "^17.4.0",
     "unpdf": "^1.8.1",

package/server.json

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