@talkspresso/mcp-server 1.4.2 → 1.5.0

package/dist/index.js

@@ -14,7 +14,7 @@ else if (args.includes('--help')) {
     process.exit(0);
 }
 else if (args.includes('--version')) {
-    console.log('1.4.2');
+    console.log('1.5.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.4.2',
+        version: '1.5.0',
     });
     const apiClient = new TalkspressoClient();
     registerAppointmentTools(server, apiClient);

package/dist/setup-api.d.ts

@@ -18,6 +18,7 @@ export declare class SetupApiClient {
         about?: string;
         bio?: string;
         categories?: string[];
+        profile_handle?: string;
     }): Promise<any>;
     createService(data: {
         title: string;
@@ -26,6 +27,7 @@ export declare class SetupApiClient {
         duration: number;
         type: string;
     }): Promise<any>;
+    checkHandleAvailability(handle: string): Promise<boolean>;
     updateCalendar(data: {
         timezone?: string;
         availability?: Record<string, any>;

package/dist/setup-api.js

@@ -73,6 +73,19 @@ export class SetupApiClient {
             throw this.formatError(err);
         }
     }
+    async checkHandleAvailability(handle) {
+        try {
+            await this.http.get('/profile/check_handle_availability', {
+                params: { profile_handle: handle },
+            });
+            return true; // 200 = available
+        }
+        catch (err) {
+            if (err.response?.status === 409)
+                return false; // taken
+            return false; // assume taken on error
+        }
+    }
     async updateCalendar(data) {
         try {
             const response = await this.http.put('/calendar', data);

package/dist/setup.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { confirm, input, password as passwordPrompt, select } from '@inquirer/prompts';
+import { confirm, input, password as passwordPrompt } from '@inquirer/prompts';
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
 import { join } from 'path';
 import { homedir } from 'os';
@@ -49,40 +49,6 @@ function mcpEntry(apiKey) {
         env: { TALKSPRESSO_API_KEY: apiKey },
     };
 }
-const SERVICE_PRESETS = [
-    { name: '1:1 Video Call (30 min, $100)', value: { title: '1:1 Video Call', description: 'A private 30-minute video session.', price: 100, duration: 30, type: 'video_call' } },
-    { name: '1:1 Video Call (60 min, $200)', value: { title: '1:1 Video Call', description: 'A private 60-minute video session.', price: 200, duration: 60, type: 'video_call' } },
-    { name: 'Group Workshop (60 min, $50)', value: { title: 'Group Workshop', description: 'A 60-minute interactive group session.', price: 50, duration: 60, type: 'workshop' } },
-    { name: 'Custom (I\'ll set it up)', value: 'custom' },
-    { name: 'Skip for now', value: 'skip' },
-];
-const AVAILABILITY_PRESETS = [
-    { name: 'Weekdays 9 AM - 5 PM', value: 'weekdays-9-5' },
-    { name: 'Weekdays 10 AM - 6 PM', value: 'weekdays-10-6' },
-    { name: 'Every day 9 AM - 9 PM', value: 'everyday-9-9' },
-    { name: 'Skip for now', value: 'skip' },
-];
-function buildAvailability(preset) {
-    const days = ['Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday'];
-    const weekdays = ['Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday'];
-    const make = (selectedDays, start, end) => {
-        const result = {};
-        for (const day of days) {
-            result[day] = {
-                is_selected: selectedDays.includes(day),
-                start_time: start,
-                end_time: end,
-            };
-        }
-        return result;
-    };
-    switch (preset) {
-        case 'weekdays-9-5': return make(weekdays, '09:00', '17:00');
-        case 'weekdays-10-6': return make(weekdays, '10:00', '18:00');
-        case 'everyday-9-9': return make(days, '09:00', '21:00');
-        default: return null;
-    }
-}
 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`);
@@ -92,7 +58,7 @@ export async function runSetup() {
     // ── Welcome ──────────────────────────────────────────
     console.log(LOGO);
     console.log(`  ${chalk.white.bold('Manage your business with AI.')}`);
-    console.log(`  ${chalk.dim("Let's get you set up in a few minutes.")}\n`);
+    console.log(`  ${chalk.dim("Let's connect your account. Takes about 60 seconds.")}\n`);
     // ── Account ──────────────────────────────────────────
     let accessToken;
     let userName;
@@ -170,89 +136,40 @@ export async function runSetup() {
         console.log(`  ${chalk.dim('Create one manually at')} ${chalk.cyan('app.talkspresso.com/settings/api-keys')}\n`);
         process.exit(1);
     }
-    // ── Profile Setup ────────────────────────────────────
-    console.log(chalk.white.bold('  Set up your profile\n'));
-    const expertTitle = await input({
-        message: 'Your professional title (e.g., "Executive Coach", "Fitness Creator"):',
-    });
-    const about = await input({
-        message: 'One line about what you offer:',
-    });
-    if (expertTitle || about) {
-        try {
-            await api.updateProfile({
-                expert_title: expertTitle || undefined,
-                about: about || undefined,
-            });
-            console.log(`  ${chalk.green('✓')} Profile updated\n`);
-        }
-        catch {
-            console.log(`  ${chalk.yellow('!')} Could not update profile. You can update it later.\n`);
-        }
-    }
-    // ── First Service ────────────────────────────────────
-    console.log(chalk.white.bold('  Create your first offering\n'));
-    console.log(`  ${chalk.dim('This is what people will book with you.')}\n`);
-    const serviceChoice = await select({
-        message: 'Pick a starting template:',
-        choices: SERVICE_PRESETS,
-    });
-    if (serviceChoice === 'custom') {
-        const title = await input({ message: 'Service title:' });
-        const description = await input({ message: 'Short description:' });
-        const priceStr = await input({ message: 'Price in dollars (0 for free):' });
-        const durationStr = await input({ message: 'Duration in minutes:' });
-        const type = await select({
-            message: 'Service type:',
-            choices: [
-                { name: '1:1 Video Call', value: 'video_call' },
-                { name: 'Group Session', value: 'group_session' },
-                { name: 'Workshop', value: 'workshop' },
-                { name: 'Webinar', value: 'webinar' },
-            ],
+    // ── Handle / Vanity URL ────────────────────────────
+    let profileHandle = '';
+    const defaultHandle = userName.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/(^-|-$)/g, '');
+    console.log(`  ${chalk.dim('Your booking page will be:')} ${chalk.cyan(`app.talkspresso.com/`)}${chalk.cyan.bold('<your-handle>')}\n`);
+    let handleAttempts = 0;
+    while (handleAttempts < 5) {
+        const handle = await input({
+            message: 'Choose your handle:',
+            default: handleAttempts === 0 ? defaultHandle : undefined,
         });
-        try {
-            await api.createService({
-                title,
-                description: description || `A ${durationStr}-minute ${type.replace('_', ' ')} session.`,
-                price: parseInt(priceStr) || 0,
-                duration: parseInt(durationStr) || 30,
-                type,
-            });
-            console.log(`  ${chalk.green('✓')} Service "${title}" created\n`);
+        const cleaned = handle.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/(^-|-$)/g, '');
+        if (!cleaned || cleaned.length < 3) {
+            console.log(`  ${chalk.red('✗')} Handle must be at least 3 characters.\n`);
+            handleAttempts++;
+            continue;
         }
-        catch (err) {
-            console.log(`  ${chalk.yellow('!')} Could not create service: ${err.message}. You can create one later.\n`);
+        const available = await api.checkHandleAvailability(cleaned);
+        if (available) {
+            profileHandle = cleaned;
+            console.log(`  ${chalk.green('✓')} ${chalk.cyan(`app.talkspresso.com/${cleaned}`)} is yours!\n`);
+            break;
+        }
+        else {
+            console.log(`  ${chalk.red('✗')} "${cleaned}" is taken. Try another.\n`);
+            handleAttempts++;
         }
     }
-    else if (serviceChoice !== 'skip') {
+    // Save handle to profile
+    if (profileHandle) {
         try {
-            const preset = serviceChoice;
-            await api.createService(preset);
-            console.log(`  ${chalk.green('✓')} Service "${preset.title}" created ($${preset.price}, ${preset.duration} min)\n`);
-        }
-        catch (err) {
-            console.log(`  ${chalk.yellow('!')} Could not create service: ${err.message}. You can create one later.\n`);
+            await api.updateProfile({ profile_handle: profileHandle });
         }
-    }
-    // ── Availability ─────────────────────────────────────
-    console.log(chalk.white.bold('  Set your availability\n'));
-    const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
-    console.log(`  ${chalk.dim(`Detected timezone: ${timezone}`)}\n`);
-    const availPreset = await select({
-        message: 'When are you available for sessions?',
-        choices: AVAILABILITY_PRESETS,
-    });
-    if (availPreset !== 'skip') {
-        const availability = buildAvailability(availPreset);
-        if (availability) {
-            try {
-                await api.updateCalendar({ timezone, availability });
-                console.log(`  ${chalk.green('✓')} Availability set\n`);
-            }
-            catch {
-                console.log(`  ${chalk.yellow('!')} Could not set availability. You can update it later.\n`);
-            }
+        catch {
+            // Non-fatal, handle might already be set
         }
     }
     // ── Configure Claude Desktop ─────────────────────────
@@ -295,16 +212,12 @@ export async function runSetup() {
         }
     }
     // ── Success ──────────────────────────────────────────
-    console.log(chalk.green.bold('\n  You\'re all set!\n'));
+    console.log(chalk.green.bold('\n  You\'re connected!\n'));
     const done = [];
     done.push(`Account: ${userEmail}`);
     done.push(`API key saved`);
-    if (expertTitle)
-        done.push(`Profile: ${expertTitle}`);
-    if (serviceChoice !== 'skip')
-        done.push('First service created');
-    if (availPreset !== 'skip')
-        done.push('Availability configured');
+    if (profileHandle)
+        done.push(`Handle: app.talkspresso.com/${profileHandle}`);
     if (configuredDesktop)
         done.push('Claude Desktop configured');
     if (configuredCode)
@@ -312,15 +225,19 @@ export async function runSetup() {
     for (const item of done) {
         console.log(`  ${chalk.green('✓')} ${item}`);
     }
-    console.log(`\n  ${chalk.bold('What to do next:')}\n`);
+    console.log(`\n  ${chalk.bold('Now the fun part:')}\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(`  3. ${chalk.white('Try:')} "Connect my Stripe account so I can get paid"`);
-        console.log(`  4. ${chalk.white('Try:')} "Get my booking link so I can share it"`);
+        console.log(`  1. ${chalk.white('Restart Claude')} (quit and reopen)`);
+        console.log(`  2. ${chalk.white('Say:')} ${chalk.cyan('"Help me set up my Talkspresso business"')}`);
+        console.log();
+        console.log(`  ${chalk.dim('Brew, your AI business advisor, will:')}`);
+        console.log(`  ${chalk.dim('  - Ask about what you do')}`);
+        console.log(`  ${chalk.dim('  - Suggest sessions and pricing for your niche')}`);
+        console.log(`  ${chalk.dim('  - Create your services and set up your availability')}`);
+        console.log(`  ${chalk.dim('  - Get your booking page ready to share')}`);
     }
     else {
-        console.log(`  1. ${chalk.white('Run')} ${chalk.cyan('npx @talkspresso/mcp-server --setup')} ${chalk.white('to connect to Claude')}`);
+        console.log(`  Run ${chalk.cyan('npx @talkspresso/mcp-server --setup')} to connect to Claude.`);
     }
-    console.log(`\n  ${chalk.dim('Need help? Ask Claude: "What can I do with Talkspresso?"')}\n`);
+    console.log(`\n  ${chalk.dim('Your entire business, built through conversation.')}\n`);
 }

package/dist/tools/brew.js

@@ -5,11 +5,24 @@ export function registerBrewTools(server, client) {
         const data = await client.get('/guide/status');
         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 () => {
+    server.tool('start-brew-conversation', `Start a new conversation with Brew or resume your existing one. Brew is your AI business mentor on Talkspresso.
+
+IMPORTANT FOR NEW USERS: If the user just set up their account or says "help me set up my business", start a Brew conversation first. Brew will detect they are new and guide them through:
+1. Understanding what they do and who they serve
+2. Suggesting personalized session types and pricing for their niche
+3. Creating their first services (use confirm-brew-action to execute proposals)
+4. Setting up availability and profile
+5. Getting their booking page ready to share
+
+Brew knows the user's full context (profile, services, bookings, stage) and gives niche-specific advice.`, {}, async () => {
         const data = await client.post('/guide/start');
         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.', {
+    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.
+
+When Brew proposes an action (like creating a service or updating availability), the response will include a write_proposal with actionData and a messageId. To execute the proposed action, call confirm-brew-action with the conversationId, actionType, and messageId.
+
+Brew can propose these actions: create_service, update_service, convert_service_type, add_package_session, update_service_capacity, update_availability, update_profile, connect_stripe, create_appointment, cancel_appointment.`, {
         conversationId: z.string().describe('The Brew conversation ID (get from start-brew-conversation)'),
         message: z.string().describe('Your message to Brew'),
     }, async (params) => {
@@ -18,6 +31,21 @@ export function registerBrewTools(server, client) {
         });
         return formatMcpResponse(data);
     });
+    server.tool('confirm-brew-action', `Execute a proposed action from Brew. When Brew suggests creating a service, updating availability, or making other changes, it returns a write_proposal with a messageId. Call this tool to confirm and execute that action.
+
+Supported action types: create_service, update_service, convert_service_type, add_package_session, update_service_capacity, update_availability, update_profile, connect_stripe, create_appointment, cancel_appointment.
+
+Always confirm with the user before executing Brew's proposals.`, {
+        conversationId: z.string().describe('The Brew conversation ID'),
+        actionType: z.string().describe('The action type from the write_proposal (e.g., "create_service", "update_availability")'),
+        messageId: z.string().describe('The message ID from the write_proposal response'),
+    }, async (params) => {
+        const data = await client.post(`/guide/${params.conversationId}/confirm-action`, {
+            actionType: params.actionType,
+            messageId: params.messageId,
+        });
+        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) => {

package/package.json

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