@talkspresso/mcp-server 1.3.0 → 1.3.2

package/dist/client.d.ts

@@ -1,3 +1,9 @@
+export declare function formatMcpResponse(data: any): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};
 export declare class TalkspressoClient {
     private http;
     private _providerId;

package/dist/client.js

@@ -1,4 +1,36 @@
 import axios from 'axios';
+const MAX_RESPONSE_CHARS = 50000;
+export function formatMcpResponse(data) {
+    const json = JSON.stringify(data, null, 2);
+    if (json.length <= MAX_RESPONSE_CHARS) {
+        return { content: [{ type: 'text', text: json }] };
+    }
+    // Response too large -- if it's an array, trim items and note how many were cut
+    if (Array.isArray(data)) {
+        let trimmed = [...data];
+        let result = JSON.stringify(trimmed, null, 2);
+        while (result.length > MAX_RESPONSE_CHARS && trimmed.length > 1) {
+            trimmed = trimmed.slice(0, Math.ceil(trimmed.length * 0.7));
+            result = JSON.stringify(trimmed, null, 2);
+        }
+        const note = `\n\n--- Showing ${trimmed.length} of ${data.length} results. Use pagination (page/limit) to see more. ---`;
+        return { content: [{ type: 'text', text: result + note }] };
+    }
+    // Object with an array property (e.g. { appointments: [...], totalCount: 50 })
+    for (const key of Object.keys(data)) {
+        if (Array.isArray(data[key]) && data[key].length > 5) {
+            const truncated = { ...data, [key]: data[key].slice(0, 20) };
+            const result = JSON.stringify(truncated, null, 2);
+            if (result.length <= MAX_RESPONSE_CHARS) {
+                const note = `\n\n--- Showing 20 of ${data[key].length} ${key}. Use pagination to see more. ---`;
+                return { content: [{ type: 'text', text: result + note }] };
+            }
+        }
+    }
+    // Last resort: hard truncate
+    const truncated = json.slice(0, MAX_RESPONSE_CHARS);
+    return { content: [{ type: 'text', text: truncated + '\n\n--- Response truncated (exceeded size limit). Try a more specific query. ---' }] };
+}
 export class TalkspressoClient {
     http;
     _providerId = null;
@@ -56,7 +88,7 @@ export class TalkspressoClient {
     async getProviderId() {
         if (this._providerId)
             return this._providerId;
-        const profile = await this.get('/profile');
+        const profile = await this.get('/profile/me');
         this._providerId = profile.id || profile.user_id;
         return this._providerId;
     }

package/dist/index.js

@@ -14,7 +14,7 @@ else if (args.includes('--help')) {
     process.exit(0);
 }
 else if (args.includes('--version')) {
-    console.log('1.3.0');
+    console.log('1.3.2');
     process.exit(0);
 }
 else {
@@ -42,7 +42,7 @@ else {
     const { registerSubscriptionTools } = await import('./tools/subscription.js');
     const server = new McpServer({
         name: 'talkspresso',
-        version: '1.3.0',
+        version: '1.3.2',
     });
     const apiClient = new TalkspressoClient();
     registerAppointmentTools(server, apiClient);

package/dist/tools/appointments.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatMcpResponse } from '../client.js';
 function trimAppointment(apt) {
     return {
         id: apt.id,
@@ -24,31 +25,23 @@ export function registerAppointmentTools(server, client) {
         // Trim response to essential fields to avoid exceeding token limits
         const appointments = Array.isArray(data) ? data : data?.appointments || data?.rows || [];
         const trimmed = appointments.map(trimAppointment);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(trimmed, null, 2) }],
-        };
+        return formatMcpResponse(trimmed);
     });
     server.tool('get-appointment', 'Get detailed information about a specific appointment', {
         id: z.string().describe('The appointment ID'),
     }, async (params) => {
         const data = await client.get(`/appointments/${params.id}`);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('get-pending-bookings', 'Get all pending bookings that need your approval', {}, async () => {
         const data = await client.get('/appointments/pending');
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('approve-appointment', 'Approve a pending booking request', {
         id: z.string().describe('The appointment ID to approve'),
     }, async (params) => {
         const data = await client.post(`/appointments/${params.id}/approve`);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('decline-appointment', 'Decline a pending booking request', {
         id: z.string().describe('The appointment ID to decline'),
@@ -57,9 +50,7 @@ export function registerAppointmentTools(server, client) {
         const data = await client.post(`/appointments/${params.id}/decline`, {
             decline_reason: params.decline_reason,
         });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('create-appointment', 'Create an appointment WITHOUT sending the invitation email. Returns appointment details for review. After reviewing, use send-appointment-invite to send the email to the client.', {
         client_name: z.string().describe('Client full name'),
@@ -86,12 +77,10 @@ export function registerAppointmentTools(server, client) {
             invitation_message: params.invitation_message,
             skip_email: true,
         });
-        return {
-            content: [{ type: 'text', text: JSON.stringify({
-                        ...data,
-                        _note: 'Appointment created. Email NOT sent yet. Use send-appointment-invite to send the invitation email after reviewing.',
-                    }, null, 2) }],
-        };
+        return formatMcpResponse({
+            ...data,
+            _note: 'Appointment created. Email NOT sent yet. Use send-appointment-invite to send the invitation email after reviewing.',
+        });
     });
     server.tool('send-appointment-invite', 'Send the invitation email for an existing appointment. Use this after create-appointment to send the invite once the provider has reviewed the details.', {
         id: z.string().describe('The appointment ID to send the invitation for'),
@@ -100,17 +89,13 @@ export function registerAppointmentTools(server, client) {
         const data = await client.post(`/appointments/${params.id}/resend-invite`, {
             invitation_message: params.invitation_message,
         });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('cancel-appointment', 'Cancel an appointment', {
         id: z.string().describe('The appointment ID to cancel'),
     }, async (params) => {
         const data = await client.post(`/appointments/${params.id}/cancel`);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('reschedule-appointment', 'Reschedule an appointment to a new date and time', {
         id: z.string().describe('The appointment ID to reschedule'),
@@ -121,9 +106,7 @@ export function registerAppointmentTools(server, client) {
             start_time: params.start_time,
             end_time: params.end_time,
         });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('check-availability', 'Check available time slots for a specific date and service. Use this before scheduling to see when you are free.', {
         date: z.string().describe('Date to check in YYYY-MM-DD format'),
@@ -137,9 +120,7 @@ export function registerAppointmentTools(server, client) {
             interval: params.duration || 30,
             provider_id: providerId,
         });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('send-test-invite', 'Send a test appointment invitation to yourself or a specific email. Great for verifying your booking flow works correctly.', {
         email: z.string().describe('Email address to send the test invite to'),
@@ -161,8 +142,6 @@ export function registerAppointmentTools(server, client) {
             is_complimentary: true,
             invitation_message: 'This is a test invitation to verify the booking flow.',
         });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
 }

package/dist/tools/brew.js

@@ -1,16 +1,13 @@
 import { z } from 'zod';
+import { formatMcpResponse } from '../client.js';
 export function registerBrewTools(server, client) {
     server.tool('get-brew-status', 'Check your Brew AI mentor status including Pro tier, question quota, and active conversation.', {}, async () => {
         const data = await client.get('/guide/status');
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('start-brew-conversation', 'Start a new conversation with Brew or resume your existing one. Brew is your AI business mentor.', {}, async () => {
         const data = await client.post('/guide/start');
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('send-brew-message', 'Send a message to Brew and get AI-powered business advice. Brew can help with pricing, services, profile optimization, and growth strategy.', {
         conversationId: z.string().describe('The Brew conversation ID (get from start-brew-conversation)'),
@@ -19,38 +16,28 @@ export function registerBrewTools(server, client) {
         const data = await client.post(`/guide/${params.conversationId}/message`, {
             message: params.message,
         });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('get-brew-conversation-history', 'Get the message history for a Brew conversation.', {
         conversationId: z.string().describe('The Brew conversation ID'),
     }, async (params) => {
         const data = await client.get(`/guide/${params.conversationId}/history`);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('get-brew-insights', 'Get proactive coaching insights and nudges from Brew. Shows opportunities, milestones, and reminders based on your activity.', {}, async () => {
         const data = await client.get('/guide/insights');
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('set-brew-goal', 'Set a business goal for Brew to help you work toward.', {
         goal: z.string().describe('Your business goal (e.g. "Get my first 5 bookings" or "Reach $1000/month")'),
         conversationId: z.string().optional().describe('Brew conversation ID to associate the goal with'),
     }, async (params) => {
         const data = await client.post('/guide/goals', params);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('get-brew-preferences', 'Get your Brew notification preferences including intensity, channel, and sleep status.', {}, async () => {
         const data = await client.get('/guide/preferences');
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('update-brew-preferences', 'Update Brew notification preferences. Control how often and how Brew reaches out.', {
         intensity: z.enum(['high', 'medium', 'low']).optional().describe('Notification intensity'),
@@ -58,28 +45,20 @@ export function registerBrewTools(server, client) {
         topicFilters: z.array(z.string()).optional().describe('Topics to filter for'),
     }, async (params) => {
         const data = await client.put('/guide/preferences', params);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('sleep-brew', 'Put Brew to sleep for a specified number of weeks. Pauses all proactive notifications.', {
         weeks: z.number().describe('Number of weeks to sleep (1, 2, or 4)'),
     }, async (params) => {
         const data = await client.post('/guide/preferences/sleep', { weeks: params.weeks });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('wake-brew', 'Wake Brew from sleep mode and resume proactive notifications.', {}, async () => {
         const data = await client.post('/guide/preferences/wake');
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('get-dashboard-insight', 'Get a single focused coaching insight for your dashboard. Returns stage-appropriate advice and next action.', {}, async () => {
         const data = await client.get('/guide/dashboard-insight');
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
 }

package/dist/tools/calendar.js

@@ -1,10 +1,9 @@
 import { z } from 'zod';
+import { formatMcpResponse } from '../client.js';
 export function registerCalendarTools(server, client) {
     server.tool('get-calendar', 'Get your calendar settings including timezone, availability windows, and booking preferences. Use this to check your current availability schedule.', {}, async () => {
         const data = await client.get('/calendar/me');
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('update-calendar', 'Update your calendar settings like timezone, availability windows, booking interval, and buffer time. Use this when you want to change your availability schedule or timezone.', {
         timezone: z.string().optional().describe('IANA timezone string (e.g., "America/New_York", "Europe/London")'),
@@ -13,8 +12,6 @@ export function registerCalendarTools(server, client) {
         buffer_minutes: z.number().optional().describe('Buffer time between appointments in minutes'),
     }, async (params) => {
         const data = await client.put('/calendar', params);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
 }

package/dist/tools/clients.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatMcpResponse } from '../client.js';
 export function registerClientTools(server, client) {
     server.tool('list-clients', 'Get your list of clients with optional search', {
         search: z.string().optional().describe('Search clients by name or email'),
@@ -6,32 +7,24 @@ export function registerClientTools(server, client) {
         limit: z.number().optional().describe('Number of results per page'),
     }, async (params) => {
         const data = await client.get('/client/my', params);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('get-client', 'Get detailed information about a client including their booking history', {
         id: z.string().describe('The client ID'),
     }, async (params) => {
         const data = await client.get(`/client/${params.id}/appointments`);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('get-session-history', 'Get rich session history with a specific client including session summaries, action items, and topics discussed. Use this to prep for a meeting or remember what you talked about last time.', {
         id: z.string().describe('The client ID'),
     }, async (params) => {
         const data = await client.get(`/client/${params.id}/session-history`);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('get-client-activity', 'Get client activity dashboard including emails sent, testimonials, pre-qualification responses, and engagement stats.', {
         id: z.string().describe('The client ID'),
     }, async (params) => {
         const data = await client.get(`/client/${params.id}/activity`);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
 }

package/dist/tools/earnings.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatMcpResponse } from '../client.js';
 export function registerEarningsTools(server, client) {
     server.tool('get-earnings', 'Get your earnings and transaction history', {
         transaction_type: z.string().optional().describe('Filter by transaction type (e.g., payment, refund)'),
@@ -6,9 +7,7 @@ export function registerEarningsTools(server, client) {
         limit: z.number().optional().describe('Number of results per page'),
     }, async (params) => {
         const data = await client.get('/transaction/my', params);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('get-revenue-summary', 'Get a quick revenue summary: this month earnings, total bookings, new clients, and completed sessions. Use this for a "how is this month going?" check.', {}, async () => {
         const [appointments, earnings] = await Promise.all([
@@ -25,14 +24,12 @@ export function registerEarningsTools(server, client) {
             .reduce((sum, t) => sum + (parseFloat(t.amount) || 0), 0);
         const thisMonthCompleted = allAppts.filter((a) => (a.status === 'completed') && (a.start_time >= monthStart || a.createdAt >= monthStart)).length;
         const upcomingCount = allAppts.filter((a) => a.status === 'active' || a.status === 'scheduled').length;
-        return {
-            content: [{ type: 'text', text: JSON.stringify({
-                        month: `${now.toLocaleString('default', { month: 'long' })} ${now.getFullYear()}`,
-                        revenue_this_month: `$${thisMonthRevenue.toFixed(2)}`,
-                        completed_sessions_this_month: thisMonthCompleted,
-                        upcoming_sessions: upcomingCount,
-                        total_transactions_this_month: thisMonthTxns.length,
-                    }, null, 2) }],
-        };
+        return formatMcpResponse({
+            month: `${now.toLocaleString('default', { month: 'long' })} ${now.getFullYear()}`,
+            revenue_this_month: `$${thisMonthRevenue.toFixed(2)}`,
+            completed_sessions_this_month: thisMonthCompleted,
+            upcoming_sessions: upcomingCount,
+            total_transactions_this_month: thisMonthTxns.length,
+        });
     });
 }

package/dist/tools/fileLibrary.js

@@ -1,30 +1,23 @@
 import { z } from 'zod';
+import { formatMcpResponse } from '../client.js';
 export function registerFileLibraryTools(server, client) {
     server.tool('list-files', 'Get all files in your file library. Files can be attached to products, services, or shared with clients.', {}, async () => {
         const data = await client.get('/file-library');
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('get-file', 'Get detailed information about a specific file in your library.', {
         id: z.string().describe('The file ID'),
     }, async (params) => {
         const data = await client.get(`/file-library/${params.id}`);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('get-file-library-stats', 'Get statistics about your file library including total files, storage used, and file types.', {}, async () => {
         const data = await client.get('/file-library/stats');
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('get-file-library-folders', 'Get all folders in your file library for organization.', {}, async () => {
         const data = await client.get('/file-library/folders');
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('update-file', 'Update file metadata like name, description, or folder.', {
         id: z.string().describe('The file ID to update'),
@@ -34,25 +27,19 @@ export function registerFileLibraryTools(server, client) {
     }, async (params) => {
         const { id, ...updateData } = params;
         const data = await client.put(`/file-library/${id}`, updateData);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('delete-file', 'Delete a file from your library.', {
         id: z.string().describe('The file ID to delete'),
     }, async (params) => {
         const data = await client.delete(`/file-library/${params.id}`);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('add-file-tags', 'Add tags to a file for easier organization and search.', {
         id: z.string().describe('The file ID'),
         tags: z.array(z.string()).describe('Tags to add to the file'),
     }, async (params) => {
         const data = await client.post(`/file-library/${params.id}/tags`, { tags: params.tags });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
 }

package/dist/tools/googleCalendar.js

@@ -1,12 +1,11 @@
 import { z } from 'zod';
+import { formatMcpResponse } from '../client.js';
 export function registerGoogleCalendarTools(server, client) {
     server.tool('get-connected-calendars', 'Get your connected Google Calendar accounts and their calendars. Shows which calendars are selected for conflict checking.', {
         user_id: z.string().describe('Your user ID'),
     }, async (params) => {
         const data = await client.get(`/google-calendar/calendars/${params.user_id}`);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('toggle-calendar-selection', 'Select or deselect a Google Calendar for conflict checking. Selected calendars are checked when clients book.', {
         user_id: z.string().describe('Your user ID'),
@@ -17,9 +16,7 @@ export function registerGoogleCalendarTools(server, client) {
             calendarId: params.calendarId,
             isSelected: params.isSelected,
         });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('check-calendar-conflicts', 'Check if a time range conflicts with your Google Calendar events. Use this before scheduling to avoid double-booking.', {
         user_id: z.string().describe('Your user ID'),
@@ -30,8 +27,6 @@ export function registerGoogleCalendarTools(server, client) {
             startTime: params.startTime,
             endTime: params.endTime,
         });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
 }

package/dist/tools/live.js

@@ -1,32 +1,25 @@
 import { z } from 'zod';
+import { formatMcpResponse } from '../client.js';
 export function registerLiveTools(server, client) {
     server.tool('start-live-session', 'Start a new live video session (Go Live). Requires a Pro subscription. Returns a shareable link for viewers to join.', {
         title: z.string().optional().describe('Title for the live session'),
     }, async (params) => {
         const data = await client.post('/live/start', { title: params.title });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('get-active-live-session', 'Check if you have a currently active live session. Returns session details and share URL if live.', {}, async () => {
         const data = await client.get('/live/active');
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('end-live-session', 'End your active live session.', {
         slug: z.string().describe('The live session slug (short code)'),
     }, async (params) => {
         const data = await client.post(`/live/${params.slug}/end`);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('get-live-session-history', 'Get your past live session history including duration, viewer counts, and status.', {}, async () => {
         const data = await client.get('/live/history/me');
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('send-live-session-invite', 'Send an email invitation to someone to join your active live session.', {
         slug: z.string().describe('The live session slug'),
@@ -37,8 +30,6 @@ export function registerLiveTools(server, client) {
             email: params.email,
             isCohost: params.isCohost || false,
         });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
 }

package/dist/tools/messaging.js

@@ -1,10 +1,9 @@
 import { z } from 'zod';
+import { formatMcpResponse } from '../client.js';
 export function registerMessagingTools(server, client) {
     server.tool('list-conversations', 'Get all your message conversations with clients. Returns conversations sorted by most recent message.', {}, async () => {
         const data = await client.get('/messaging/conversations', { userType: 'provider' });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('get-conversation-messages', 'Get messages from a specific conversation. Returns the most recent messages in chronological order.', {
         conversation_id: z.string().describe('The conversation ID'),
@@ -14,9 +13,7 @@ export function registerMessagingTools(server, client) {
         if (params.limit)
             queryParams.limit = String(params.limit);
         const data = await client.get(`/messaging/conversations/${params.conversation_id}/messages`, queryParams);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('send-message', 'Send a message to a client in an existing conversation. Use list-conversations first to find the conversation ID.', {
         conversation_id: z.string().describe('The conversation ID'),
@@ -29,15 +26,11 @@ export function registerMessagingTools(server, client) {
             senderName: params.sender_name,
             message: params.message,
         });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('get-unread-message-count', 'Get the total number of unread messages across all conversations.', {}, async () => {
         const data = await client.get('/messaging/unread-count', { userType: 'provider' });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('mark-conversation-read', 'Mark all messages in a conversation as read.', {
         conversation_id: z.string().describe('The conversation ID to mark as read'),
@@ -45,8 +38,6 @@ export function registerMessagingTools(server, client) {
         const data = await client.post(`/messaging/conversations/${params.conversation_id}/read`, {
             userType: 'provider',
         });
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
 }

package/dist/tools/notifications.js

@@ -1,25 +1,20 @@
 import { z } from 'zod';
+import { formatMcpResponse } from '../client.js';
 export function registerNotificationTools(server, client) {
     server.tool('list-notifications', 'Get all your notifications including new bookings, messages, and system alerts. Use this to check what needs your attention.', {
         user_id: z.string().describe('Your user ID (get this from get-profile first)'),
     }, async (params) => {
         const data = await client.get(`/notification/${params.user_id}`);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('mark-notification-read', 'Mark a single notification as read.', {
         notification_id: z.string().describe('The notification ID to mark as read'),
     }, async (params) => {
         const data = await client.put(`/notification/${params.notification_id}/read`);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
     server.tool('mark-all-notifications-read', 'Mark all your notifications as read. Use this to clear your notification count.', {}, async () => {
         const data = await client.put('/notification/read-all');
-        return {
-            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        };
+        return formatMcpResponse(data);
     });
 }