@talkspresso/mcp-server 1.0.0 → 1.2.0

package/dist/index.js

@@ -1,21 +1,70 @@
 #!/usr/bin/env node
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { TalkspressoClient } from './client.js';
-import { registerAppointmentTools } from './tools/appointments.js';
-import { registerClientTools } from './tools/clients.js';
-import { registerServiceTools } from './tools/services.js';
-import { registerEarningsTools } from './tools/earnings.js';
-import { registerProfileTools } from './tools/profile.js';
-const server = new McpServer({
-    name: 'talkspresso',
-    version: '1.0.0',
-});
-const apiClient = new TalkspressoClient();
-registerAppointmentTools(server, apiClient);
-registerClientTools(server, apiClient);
-registerServiceTools(server, apiClient);
-registerEarningsTools(server, apiClient);
-registerProfileTools(server, apiClient);
-const transport = new StdioServerTransport();
-await server.connect(transport);
+const args = process.argv.slice(2);
+if (args.includes('--setup')) {
+    const { runSetup } = await import('./setup.js');
+    await runSetup();
+}
+else if (args.includes('--help')) {
+    console.log('Usage: talkspresso-mcp [options]\n');
+    console.log('Options:');
+    console.log('  --setup    Interactive setup wizard');
+    console.log('  --help     Show this help message');
+    console.log('  --version  Show version number');
+    console.log('\nWith no options, starts the MCP server (stdio transport).');
+    process.exit(0);
+}
+else if (args.includes('--version')) {
+    console.log('1.1.0');
+    process.exit(0);
+}
+else {
+    const { McpServer } = await import('@modelcontextprotocol/sdk/server/mcp.js');
+    const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
+    const { TalkspressoClient } = await import('./client.js');
+    const { registerAppointmentTools } = await import('./tools/appointments.js');
+    const { registerClientTools } = await import('./tools/clients.js');
+    const { registerServiceTools } = await import('./tools/services.js');
+    const { registerEarningsTools } = await import('./tools/earnings.js');
+    const { registerProfileTools } = await import('./tools/profile.js');
+    const { registerCalendarTools } = await import('./tools/calendar.js');
+    const { registerNotificationTools } = await import('./tools/notifications.js');
+    const { registerTestimonialTools } = await import('./tools/testimonials.js');
+    const { registerRecordingTools } = await import('./tools/recordings.js');
+    const { registerOrganizationTools } = await import('./tools/organization.js');
+    const { registerProductTools } = await import('./tools/products.js');
+    const { registerPromoCodeTools } = await import('./tools/promoCodes.js');
+    const { registerFileLibraryTools } = await import('./tools/fileLibrary.js');
+    const { registerPrequalificationTools } = await import('./tools/prequalification.js');
+    const { registerMessagingTools } = await import('./tools/messaging.js');
+    const { registerLiveTools } = await import('./tools/live.js');
+    const { registerGoogleCalendarTools } = await import('./tools/googleCalendar.js');
+    const { registerBrewTools } = await import('./tools/brew.js');
+    const { registerSubscriptionTools } = await import('./tools/subscription.js');
+    const server = new McpServer({
+        name: 'talkspresso',
+        version: '1.2.0',
+    });
+    const apiClient = new TalkspressoClient();
+    registerAppointmentTools(server, apiClient);
+    registerClientTools(server, apiClient);
+    registerServiceTools(server, apiClient);
+    registerEarningsTools(server, apiClient);
+    registerProfileTools(server, apiClient);
+    registerCalendarTools(server, apiClient);
+    registerNotificationTools(server, apiClient);
+    registerTestimonialTools(server, apiClient);
+    registerRecordingTools(server, apiClient);
+    registerOrganizationTools(server, apiClient);
+    registerProductTools(server, apiClient);
+    registerPromoCodeTools(server, apiClient);
+    registerFileLibraryTools(server, apiClient);
+    registerPrequalificationTools(server, apiClient);
+    registerMessagingTools(server, apiClient);
+    registerLiveTools(server, apiClient);
+    registerGoogleCalendarTools(server, apiClient);
+    registerBrewTools(server, apiClient);
+    registerSubscriptionTools(server, apiClient);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+export {};

package/dist/setup-api.d.ts

@@ -0,0 +1,18 @@
+export declare class SetupApiClient {
+    private http;
+    constructor();
+    setAccessToken(token: string): void;
+    register(data: {
+        name: string;
+        email: string;
+        password: string;
+        timezone: string;
+    }): Promise<any>;
+    login(data: {
+        email: string;
+        password: string;
+    }): Promise<any>;
+    createApiKey(name: string): Promise<any>;
+    getStatus(err: unknown): number | undefined;
+    private formatError;
+}

package/dist/setup-api.js

@@ -0,0 +1,55 @@
+import axios from 'axios';
+export class SetupApiClient {
+    http;
+    constructor() {
+        const baseURL = process.env.TALKSPRESSO_API_URL || 'https://api.talkspresso.com';
+        this.http = axios.create({
+            baseURL,
+            headers: { 'Content-Type': 'application/json' },
+            timeout: 30000,
+        });
+    }
+    setAccessToken(token) {
+        this.http.defaults.headers['Authorization'] = `Bearer ${token}`;
+    }
+    async register(data) {
+        try {
+            const response = await this.http.post('/user/register', data);
+            return response.data?.data;
+        }
+        catch (err) {
+            throw this.formatError(err);
+        }
+    }
+    async login(data) {
+        try {
+            const response = await this.http.post('/user/login', data);
+            return response.data?.data;
+        }
+        catch (err) {
+            throw this.formatError(err);
+        }
+    }
+    async createApiKey(name) {
+        try {
+            const response = await this.http.post('/api-keys', { name });
+            return response.data?.data;
+        }
+        catch (err) {
+            throw this.formatError(err);
+        }
+    }
+    getStatus(err) {
+        if (err instanceof Error && 'status' in err)
+            return err.status;
+        return undefined;
+    }
+    formatError(err) {
+        const data = err.response?.data;
+        const status = err.response?.status;
+        const message = data?.error || err.message || 'API request failed';
+        const error = new Error(message);
+        error.status = status;
+        return error;
+    }
+}

package/dist/setup.d.ts

@@ -0,0 +1 @@
+export declare function runSetup(): Promise<void>;

package/dist/setup.js

@@ -0,0 +1,199 @@
+import chalk from 'chalk';
+import { confirm, input, password as passwordPrompt } from '@inquirer/prompts';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { SetupApiClient } from './setup-api.js';
+const LOGO = `
+  ${chalk.hex('#032B43').bold('╔╦╗')}${chalk.hex('#0A4B6E')('┌─┐┬  ┬┌─┌─┐┌─┐┬─┐┌─┐┌─┐┌─┐┌─┐')}
+  ${chalk.hex('#032B43').bold(' ║ ')}${chalk.hex('#0A4B6E')('├─┤│  ├┴┐└─┐├─┘├┬┘├┤ └─┐└─┐│ │')}
+  ${chalk.hex('#032B43').bold(' ╩ ')}${chalk.hex('#0A4B6E')('┴ ┴┴─┘┴ ┴└─┘┴  ┴└─└─┘└─┘└─┘└─┘')}
+`;
+function getClaudeDesktopConfigPath() {
+    const home = homedir();
+    if (process.platform === 'darwin') {
+        return join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+    }
+    else if (process.platform === 'win32') {
+        return join(process.env.APPDATA || join(home, 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json');
+    }
+    return join(home, '.config', 'Claude', 'claude_desktop_config.json');
+}
+function getClaudeCodeConfigPath() {
+    return join(homedir(), '.claude', 'mcp_servers.json');
+}
+function readJsonSafe(path) {
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function writeJsonSafe(path, data) {
+    try {
+        const dir = join(path, '..');
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        writeFileSync(path, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function mcpEntry(apiKey) {
+    return {
+        command: 'npx',
+        args: ['-y', '@talkspresso/mcp-server'],
+        env: { TALKSPRESSO_API_KEY: apiKey },
+    };
+}
+export async function runSetup() {
+    process.on('SIGINT', () => {
+        console.log(`\n\n  ${chalk.dim('Setup cancelled. Run')} npx @talkspresso/mcp-server --setup ${chalk.dim('anytime.')}\n`);
+        process.exit(0);
+    });
+    const api = new SetupApiClient();
+    // Welcome
+    console.log(LOGO);
+    console.log(`  ${chalk.white.bold('Manage your business with AI.')}`);
+    console.log(`  ${chalk.dim("Let's get you connected in about 30 seconds.")}\n`);
+    // Account
+    let accessToken;
+    let userName;
+    let userEmail;
+    const hasAccount = await confirm({ message: 'Do you already have a Talkspresso account?' });
+    if (hasAccount) {
+        // Login flow
+        let attempts = 0;
+        while (true) {
+            const email = await input({ message: 'Email:' });
+            const pw = await passwordPrompt({ message: 'Password:' });
+            try {
+                const user = await api.login({ email, password: pw });
+                accessToken = user.access_token;
+                userName = user.name || email.split('@')[0];
+                userEmail = email;
+                console.log(`  ${chalk.green('✓')} Logged in as ${chalk.bold(email)}\n`);
+                break;
+            }
+            catch (err) {
+                attempts++;
+                if (attempts >= 3) {
+                    console.log(`\n  ${chalk.red('Too many failed attempts.')} Create an account at ${chalk.cyan('app.talkspresso.com')}\n`);
+                    process.exit(1);
+                }
+                console.log(`  ${chalk.red('✗')} Invalid email or password. Try again.\n`);
+            }
+        }
+    }
+    else {
+        // Registration flow
+        const name = await input({ message: 'Your name:' });
+        const email = await input({ message: 'Email:' });
+        const pw = await passwordPrompt({ message: 'Password (min 8 characters):' });
+        const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+        try {
+            const user = await api.register({ name, email, password: pw, timezone });
+            accessToken = user.access_token;
+            userName = name;
+            userEmail = email;
+            console.log(`  ${chalk.green('✓')} Account created for ${chalk.bold(email)}`);
+            console.log(`  ${chalk.dim(`Timezone: ${timezone}`)}\n`);
+        }
+        catch (err) {
+            const status = api.getStatus(err);
+            if (status === 409) {
+                console.log(`\n  ${chalk.yellow('Account already exists.')} Let's log you in instead.\n`);
+                const pw2 = await passwordPrompt({ message: 'Password:' });
+                try {
+                    const user = await api.login({ email, password: pw2 });
+                    accessToken = user.access_token;
+                    userName = user.name || name;
+                    userEmail = email;
+                    console.log(`  ${chalk.green('✓')} Logged in as ${chalk.bold(email)}\n`);
+                }
+                catch {
+                    console.log(`\n  ${chalk.red('Could not log in.')} Try again at ${chalk.cyan('app.talkspresso.com')}\n`);
+                    process.exit(1);
+                }
+            }
+            else {
+                console.log(`\n  ${chalk.red('Could not create account:')} ${err.message}\n`);
+                process.exit(1);
+            }
+        }
+    }
+    // Generate API key
+    api.setAccessToken(accessToken);
+    let apiKey;
+    try {
+        const keyData = await api.createApiKey('Claude AI Assistant');
+        apiKey = keyData.key;
+        console.log(`  ${chalk.green('✓')} API key created: ${chalk.dim(apiKey.substring(0, 12) + '...')}\n`);
+    }
+    catch (err) {
+        console.log(`  ${chalk.red('Could not create API key:')} ${err.message}`);
+        console.log(`  ${chalk.dim('Create one manually at')} ${chalk.cyan('app.talkspresso.com/settings/api-keys')}\n`);
+        process.exit(1);
+    }
+    // Configure Claude Desktop
+    const desktopPath = getClaudeDesktopConfigPath();
+    const desktopDir = join(desktopPath, '..');
+    let configuredDesktop = false;
+    if (existsSync(desktopDir)) {
+        const addDesktop = await confirm({ message: 'Add Talkspresso to Claude Desktop?' });
+        if (addDesktop) {
+            const existing = readJsonSafe(desktopPath) || {};
+            if (!existing.mcpServers)
+                existing.mcpServers = {};
+            existing.mcpServers.talkspresso = mcpEntry(apiKey);
+            configuredDesktop = writeJsonSafe(desktopPath, existing);
+            if (configuredDesktop) {
+                console.log(`  ${chalk.green('✓')} Claude Desktop configured\n`);
+            }
+            else {
+                console.log(`  ${chalk.red('✗')} Could not write config. Add manually:\n`);
+                console.log(chalk.dim(JSON.stringify({ mcpServers: { talkspresso: mcpEntry(apiKey) } }, null, 2)));
+                console.log();
+            }
+        }
+    }
+    // Configure Claude Code
+    const codePath = getClaudeCodeConfigPath();
+    let configuredCode = false;
+    const addCode = await confirm({ message: 'Add Talkspresso to Claude Code?' });
+    if (addCode) {
+        const existing = readJsonSafe(codePath) || {};
+        existing.talkspresso = mcpEntry(apiKey);
+        configuredCode = writeJsonSafe(codePath, existing);
+        if (configuredCode) {
+            console.log(`  ${chalk.green('✓')} Claude Code configured\n`);
+        }
+        else {
+            console.log(`  ${chalk.red('✗')} Could not write config. Add manually:\n`);
+            console.log(chalk.dim(JSON.stringify({ talkspresso: mcpEntry(apiKey) }, null, 2)));
+            console.log();
+        }
+    }
+    // Success
+    console.log(chalk.green.bold('\n  You\'re all set!\n'));
+    const done = [];
+    done.push(`Account: ${userEmail}`);
+    done.push(`API key generated and saved`);
+    if (configuredDesktop)
+        done.push('Claude Desktop configured');
+    if (configuredCode)
+        done.push('Claude Code configured');
+    for (const item of done) {
+        console.log(`  ${chalk.green('✓')} ${item}`);
+    }
+    console.log(`\n  ${chalk.bold('Next steps:')}\n`);
+    if (configuredDesktop || configuredCode) {
+        console.log(`  1. ${chalk.white('Restart Claude')} (if it\'s open)`);
+        console.log(`  2. ${chalk.white('Try:')} "Show me my Talkspresso schedule"`);
+    }
+    console.log(`  ${configuredDesktop || configuredCode ? '3' : '1'}. ${chalk.white('Open your dashboard:')} ${chalk.cyan('https://app.talkspresso.com/dashboard')}`);
+    console.log(`     ${chalk.dim('Brew will help you set up your first session.')}\n`);
+}

package/dist/tools/appointments.js

@@ -92,4 +92,42 @@ export function registerAppointmentTools(server, client) {
             content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
         };
     });
+    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'),
+        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 data = await client.post('/appointments/slots', {
+            date: params.date,
+            service_id: params.service_id,
+            duration: params.duration || 30,
+        });
+        return {
+            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+        };
+    });
+    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'),
+        name: z.string().optional().describe('Name for the test client (default "Test Client")'),
+        service_id: z.string().optional().describe('Service ID to use for the test invite. Use list-services to find this.'),
+        scheduled_date: z.string().optional().describe('Date in YYYY-MM-DD format (defaults to tomorrow)'),
+        scheduled_time: z.string().optional().describe('Time in HH:mm format, 24-hour (defaults to 10:00)'),
+    }, async (params) => {
+        // Build a test invite using the standard invite endpoint
+        const tomorrow = new Date();
+        tomorrow.setDate(tomorrow.getDate() + 1);
+        const defaultDate = tomorrow.toISOString().split('T')[0];
+        const data = await client.post('/appointments/invite', {
+            client_name: params.name || 'Test Client',
+            client_email: params.email,
+            service_id: params.service_id,
+            scheduled_date: params.scheduled_date || defaultDate,
+            scheduled_time: params.scheduled_time || '10:00',
+            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) }],
+        };
+    });
 }

package/dist/tools/brew.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { TalkspressoClient } from '../client.js';
+export declare function registerBrewTools(server: McpServer, client: TalkspressoClient): void;

package/dist/tools/brew.js

@@ -0,0 +1,85 @@
+import { z } from 'zod';
+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) }],
+        };
+    });
+    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) }],
+        };
+    });
+    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)'),
+        message: z.string().describe('Your message to Brew'),
+    }, async (params) => {
+        const data = await client.post(`/guide/${params.conversationId}/message`, {
+            message: params.message,
+        });
+        return {
+            content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+        };
+    });
+    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) }],
+        };
+    });
+    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) }],
+        };
+    });
+    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) }],
+        };
+    });
+    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) }],
+        };
+    });
+    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'),
+        channelPreference: z.enum(['email', 'in_app', 'both']).optional().describe('How to receive notifications'),
+        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) }],
+        };
+    });
+    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) }],
+        };
+    });
+    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) }],
+        };
+    });
+    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) }],
+        };
+    });
+}

package/dist/tools/calendar.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { TalkspressoClient } from '../client.js';
+export declare function registerCalendarTools(server: McpServer, client: TalkspressoClient): void;

package/dist/tools/calendar.js

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+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) }],
+        };
+    });
+    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")'),
+        availability: z.record(z.any()).optional().describe('Weekly availability object. Keys are day names (Monday-Sunday), values have is_selected, start_time, end_time.'),
+        booking_interval_days: z.number().optional().describe('How far in advance clients can book (in days)'),
+        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) }],
+        };
+    });
+}

package/dist/tools/clients.js

@@ -18,4 +18,20 @@ export function registerClientTools(server, client) {
             content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
         };
     });
+    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) }],
+        };
+    });
+    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) }],
+        };
+    });
 }

package/dist/tools/earnings.js

@@ -10,4 +10,29 @@ export function registerEarningsTools(server, client) {
             content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
         };
     });
+    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 }),
+        ]);
+        const now = new Date();
+        const monthStart = new Date(now.getFullYear(), now.getMonth(), 1).toISOString();
+        const allAppts = appointments.appointments || appointments || [];
+        const allTxns = Array.isArray(earnings) ? earnings : earnings.transactions || [];
+        const thisMonthTxns = allTxns.filter((t) => t.createdAt >= monthStart || t.created_at >= monthStart);
+        const thisMonthRevenue = thisMonthTxns
+            .filter((t) => t.transaction_type === 'payment' || t.type === 'payment')
+            .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) }],
+        };
+    });
 }

package/dist/tools/fileLibrary.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { TalkspressoClient } from '../client.js';
+export declare function registerFileLibraryTools(server: McpServer, client: TalkspressoClient): void;

package/dist/tools/fileLibrary.js

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+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) }],
+        };
+    });
+    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) }],
+        };
+    });
+    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) }],
+        };
+    });
+    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) }],
+        };
+    });
+    server.tool('update-file', 'Update file metadata like name, description, or folder.', {
+        id: z.string().describe('The file ID to update'),
+        name: z.string().optional().describe('New file name'),
+        description: z.string().optional().describe('File description'),
+        folder: z.string().optional().describe('Folder to move the file into'),
+    }, 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) }],
+        };
+    });
+    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) }],
+        };
+    });
+    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) }],
+        };
+    });
+}

package/dist/tools/googleCalendar.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { TalkspressoClient } from '../client.js';
+export declare function registerGoogleCalendarTools(server: McpServer, client: TalkspressoClient): void;