@talkspresso/mcp-server 1.2.0 → 1.3.0

package/dist/client.d.ts

@@ -1,9 +1,11 @@
 export declare class TalkspressoClient {
     private http;
+    private _providerId;
     constructor();
     get<T = any>(path: string, params?: Record<string, any>): Promise<T>;
     post<T = any>(path: string, data?: any): Promise<T>;
     put<T = any>(path: string, data?: any): Promise<T>;
     delete<T = any>(path: string): Promise<T>;
+    getProviderId(): Promise<string>;
     private formatError;
 }

package/dist/client.js

@@ -1,6 +1,7 @@
 import axios from 'axios';
 export class TalkspressoClient {
     http;
+    _providerId = null;
     constructor() {
         const apiKey = process.env.TALKSPRESSO_API_KEY;
         if (!apiKey) {
@@ -52,6 +53,13 @@ export class TalkspressoClient {
             throw this.formatError(err);
         }
     }
+    async getProviderId() {
+        if (this._providerId)
+            return this._providerId;
+        const profile = await this.get('/profile');
+        this._providerId = profile.id || profile.user_id;
+        return this._providerId;
+    }
     formatError(err) {
         const data = err.response?.data;
         const status = err.response?.status;

package/dist/index.js

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

package/dist/tools/appointments.js

@@ -1,4 +1,19 @@
 import { z } from 'zod';
+function trimAppointment(apt) {
+    return {
+        id: apt.id,
+        status: apt.status,
+        start_time: apt.start_time,
+        end_time: apt.end_time,
+        duration: apt.duration,
+        client_name: apt.client?.name || apt.client_name,
+        client_email: apt.client?.email || apt.client_email,
+        service_title: apt.service?.title || apt.service_title,
+        service_price: apt.service?.price,
+        is_complimentary: apt.is_complimentary,
+        invitation_sent: apt.invitation_sent,
+    };
+}
 export function registerAppointmentTools(server, client) {
     server.tool('list-appointments', 'Get your appointments with optional filters. Returns upcoming appointments by default.', {
         status: z.enum(['upcoming', 'completed', 'all']).optional().describe('Filter by appointment status (default: upcoming)'),
@@ -6,8 +21,11 @@ export function registerAppointmentTools(server, client) {
         limit: z.number().optional().describe('Number of results per page'),
     }, async (params) => {
         const data = await client.get('/appointments/me', params);
+        // 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(data, null, 2) }],
+            content: [{ type: 'text', text: JSON.stringify(trimmed, null, 2) }],
         };
     });
     server.tool('get-appointment', 'Get detailed information about a specific appointment', {
@@ -43,7 +61,7 @@ export function registerAppointmentTools(server, client) {
             content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
         };
     });
-    server.tool('create-appointment', 'Create an appointment and send an invitation to the client. Use list-clients first to find the client by name if needed. Use list-services to find a service_id if linking to a specific service.', {
+    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'),
         client_email: z.string().optional().describe('Client email address (invitation sent here)'),
         scheduled_date: z.string().describe('Date in YYYY-MM-DD format'),
@@ -53,7 +71,7 @@ export function registerAppointmentTools(server, client) {
         custom_title: z.string().optional().describe('Custom session title (overrides service title)'),
         custom_price: z.number().optional().describe('Price in dollars (required if no service_id and not complimentary)'),
         is_complimentary: z.boolean().optional().describe('If true, session is free (default: true)'),
-        invitation_message: z.string().optional().describe('Personal message included in the invitation email'),
+        invitation_message: z.string().optional().describe('Personal message to include when the invitation is sent'),
     }, async (params) => {
         const data = await client.post('/appointments/invite', {
             client_name: params.client_name,
@@ -66,6 +84,21 @@ export function registerAppointmentTools(server, client) {
             custom_price: params.custom_price,
             is_complimentary: params.is_complimentary ?? true,
             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) }],
+        };
+    });
+    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'),
+        invitation_message: z.string().optional().describe('Personal message to include in the invitation email (overrides the one from create-appointment)'),
+    }, async (params) => {
+        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) }],
@@ -97,10 +130,12 @@ export function registerAppointmentTools(server, client) {
         service_id: z.string().optional().describe('Service ID to check availability for (determines duration). Use list-services to find this.'),
         duration: z.number().optional().describe('Duration in minutes if no service_id (default 30)'),
     }, async (params) => {
+        const providerId = await client.getProviderId();
         const data = await client.post('/appointments/slots', {
             date: params.date,
             service_id: params.service_id,
-            duration: params.duration || 30,
+            interval: params.duration || 30,
+            provider_id: providerId,
         });
         return {
             content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],

package/dist/tools/earnings.js

@@ -12,8 +12,8 @@ export function registerEarningsTools(server, client) {
     });
     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([
-            client.get('/appointments/me', { status: 'all', limit: 200 }),
-            client.get('/transaction/my', { limit: 200 }),
+            client.get('/appointments/me', { status: 'all', limit: 100 }),
+            client.get('/transaction/my', { limit: 100 }),
         ]);
         const now = new Date();
         const monthStart = new Date(now.getFullYear(), now.getMonth(), 1).toISOString();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talkspresso/mcp-server",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Manage your Talkspresso business through Claude, ChatGPT, or any MCP-compatible AI",
   "bin": {
     "talkspresso-mcp": "./dist/index.js"