@talkspresso/mcp-server 1.3.3 → 1.4.0

package/README.md

@@ -1,6 +1,6 @@
 # @talkspresso/mcp-server
 
-Manage your Talkspresso business through Claude, ChatGPT, or any MCP-compatible AI assistant.
+Manage your Talkspresso business through Claude Code or any MCP-compatible AI assistant.
 
 ## What it does
 
@@ -10,50 +10,50 @@ Perfect for creators, coaches, and consultants who want to manage their Talkspre
 
 ## Quick setup
 
-### 1. Get your API key
-
-Go to [app.talkspresso.com/settings/api-keys](https://app.talkspresso.com/settings/api-keys) and generate a new API key.
-
-### 2. Install the package
+The fastest way to get started is the interactive setup wizard:
 
 ```bash
-npm install -g @talkspresso/mcp-server
+npx @talkspresso/mcp-server --setup
 ```
 
-Or use it directly with npx (no install needed):
+This will:
+1. Create your account (or log in)
+2. Generate an API key
+3. Set up your profile
+4. Create your first service
+5. Configure your availability
+6. Connect to Claude Desktop and/or Claude Code
 
-```bash
-npx @talkspresso/mcp-server
-```
+No need to visit talkspresso.com. Everything happens in your terminal.
 
-### 3. Configure your AI assistant
+### Manual setup
 
-#### For Claude Desktop
+If you prefer to configure manually:
 
-Add this to your Claude Desktop config file:
+#### 1. Get your API key
 
-**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
-**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+Go to [app.talkspresso.com/settings/api-keys](https://app.talkspresso.com/settings/api-keys) and generate a new API key.
+
+#### 2. Configure your AI assistant
+
+**For Claude Code** - Add to `~/.claude/mcp.json`:
 
 ```json
 {
-  "mcpServers": {
-    "talkspresso": {
-      "command": "npx",
-      "args": ["-y", "@talkspresso/mcp-server"],
-      "env": {
-        "TALKSPRESSO_API_KEY": "tsp_your_key_here"
-      }
+  "talkspresso": {
+    "command": "npx",
+    "args": ["-y", "@talkspresso/mcp-server"],
+    "env": {
+      "TALKSPRESSO_API_KEY": "tsp_your_key_here"
     }
   }
 }
 ```
 
-Then restart Claude Desktop.
-
-#### For Claude Code
+**For Claude Desktop** - Add to your config file:
 
-Add this to your Claude Code settings (`.claude/settings.json` in your project):
+macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 
 ```json
 {
@@ -69,61 +69,148 @@ Add this to your Claude Code settings (`.claude/settings.json` in your project):
 }
 ```
 
+Then restart Claude.
+
 ## Available tools
 
-### Appointments
-- **list-appointments** - View your upcoming or completed appointments with filters
+### Appointments & Scheduling
+- **list-appointments** - View upcoming or completed appointments
 - **get-appointment** - Get details about a specific appointment
-- **get-pending-bookings** - See all bookings waiting for your approval
+- **get-pending-bookings** - See bookings waiting for approval
 - **approve-appointment** - Approve a pending booking
 - **decline-appointment** - Decline a booking with optional reason
+- **create-appointment** - Create and send a session invite
+- **send-appointment-invite** - Send invite for a created appointment
+- **cancel-appointment** - Cancel an appointment
+- **reschedule-appointment** - Reschedule to a new date/time
+- **check-availability** - Check open time slots for a date
+- **get-schedule** - Quick view of your next 50 appointments
 
 ### Clients
-- **list-clients** - View all your clients with search
-- **get-client** - Get client details and booking history
+- **list-clients** - View all clients with search
+- **get-client** - Client details and booking history
+- **get-session-history** - Rich session history with summaries
+- **get-client-activity** - Emails, testimonials, engagement stats
 
 ### Services
-- **list-services** - View all your service offerings
-- **create-service** - Create a new service (video call, workshop, webinar, etc.)
-- **update-service** - Update pricing, description, or status
-
-### Earnings
-- **get-earnings** - View your transaction history and earnings
-
-### Profile
-- **get-profile** - View your profile information
-- **update-profile** - Update your title, bio, categories, etc.
-- **get-schedule** - Quick view of your next 50 appointments
+- **list-services** - View all service offerings
+- **create-service** - Create a new service
+- **get-service** - Service details
+- **update-service** - Update pricing, description, status
+- **delete-service** - Remove a service
+- **duplicate-service** - Copy an existing service
+- **get-service-bookings** - See who booked a service
+
+### Profile & Calendar
+- **get-profile** - View your profile
+- **update-profile** - Update title, bio, categories
+- **get-calendar** - View availability settings
+- **update-calendar** - Update timezone, hours, buffer time
+- **get-booking-link** - Get a shareable booking link
+
+### Earnings & Payments
+- **get-earnings** - Transaction history
+- **get-revenue-summary** - Monthly revenue snapshot
+- **get-my-subscription** - Subscription plan details
+- **get-payment-methods** - Saved payment methods
+- **get-stripe-account-link** - Connect/manage Stripe
+- **create-billing-portal-session** - Manage billing
+
+### Recordings
+- **list-recordings** - Browse past session recordings
+- **get-recording** - Recording details with transcript
+- **update-recording** - Update title, visibility
+- **delete-recording** - Remove a recording
+- **get-client-recordings** - Recordings with a specific client
+- **get-recording-files** - Download individual recording files
+- **create-product-from-recording** - Turn a recording into a product
+
+### Products
+- **list-products** - View digital products
+- **create-product** - Create a new product
+- **get-product** - Product details
+- **update-product** - Update product info
+- **delete-product** - Remove a product
+- **get-product-analytics** - Product performance stats
+- **list-product-purchases** - See all purchases
+- **generate-product-details** - AI-generate product listing
+
+### Testimonials
+- **list-testimonials** - View client testimonials
+- **create-testimonial** - Add a testimonial manually
+- **request-testimonial** - Email a client for a testimonial
+- **approve-testimonial** / **reject-testimonial** - Moderate testimonials
+- **toggle-featured-testimonial** - Feature/unfeature
+
+### Promo Codes
+- **list-promo-codes** - View all promo codes
+- **create-promo-code** - Create a discount code
+- **update-promo-code** / **delete-promo-code** - Manage codes
+- **toggle-promo-code-active** - Enable/disable
+- **get-promo-code-analytics** - Promo performance
+
+### Messaging
+- **list-conversations** - View all client conversations
+- **get-conversation-messages** - Read messages
+- **send-message** - Reply to a client
+- **get-unread-message-count** - Check unread count
+
+### Notifications
+- **list-notifications** - View all notifications
+- **mark-notification-read** / **mark-all-notifications-read**
+
+### Live Sessions
+- **start-live-session** - Go live with a shareable link
+- **get-active-live-session** - Check if you're live
+- **end-live-session** - End your live session
+- **get-live-session-history** - Past live sessions
+- **send-live-session-invite** - Invite someone to your live
+
+### Organizations
+- **list-my-organizations** - Your org memberships
+- **get-organization** / **get-organization-members** / **get-organization-stats**
+- **update-organization** - Update org settings
+- **add-organization-member** / **send-organization-invitation**
+
+### Brew AI Mentor
+- **get-brew-status** - Check Brew status
+- **start-brew-conversation** - Start chatting with Brew
+- **send-brew-message** - Get business advice
+- **get-brew-insights** - Proactive coaching
+- **set-brew-goal** - Set a business goal
 
 ## Environment variables
 
 | Variable | Required | Default | Description |
 |----------|----------|---------|-------------|
-| `TALKSPRESSO_API_KEY` | Yes | - | Your API key from app.talkspresso.com |
-| `TALKSPRESSO_API_URL` | No | `https://api.talkspresso.com` | API base URL (use for staging/testing) |
+| `TALKSPRESSO_API_KEY` | Yes | - | Your API key |
+| `TALKSPRESSO_API_URL` | No | `https://api.talkspresso.com` | API base URL |
 
 ## Example conversations
 
-"Show me my appointments for today"
-"Who are my top clients?"
-"Create a new 30-minute coaching call for $100"
-"What are my total earnings this month?"
-"Approve all pending bookings"
+- "Show me my appointments for today"
+- "Who are my top clients?"
+- "Create a new 30-minute coaching call for $100"
+- "What are my total earnings this month?"
+- "Approve all pending bookings"
+- "Connect my Stripe account"
+- "Get my booking link so I can share it"
+- "Set my availability to weekdays 9-5"
 
 ## Troubleshooting
 
 **"TALKSPRESSO_API_KEY environment variable is required"**
-You need to add your API key to the config file. Get one at [app.talkspresso.com/settings/api-keys](https://app.talkspresso.com/settings/api-keys).
+Run `npx @talkspresso/mcp-server --setup` to set up your API key, or add it manually to your config.
 
 **"API request failed"**
-Check that your API key is valid and hasn't been revoked. You can generate a new one in your settings.
+Check that your API key is valid. You can generate a new one at [app.talkspresso.com/settings/api-keys](https://app.talkspresso.com/settings/api-keys).
 
-**Tools not showing up in Claude**
-Restart Claude Desktop after adding the config. Make sure the JSON is valid (no trailing commas).
+**Tools not showing up**
+Restart Claude after adding the config. Make sure the JSON is valid (no trailing commas).
 
 ## Support
 
-Questions? Email [support@talkspresso.com](mailto:support@talkspresso.com) or visit [help.talkspresso.com](https://help.talkspresso.com).
+Questions? Email [support@talkspresso.com](mailto:support@talkspresso.com)
 
 ## License
 

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.3');
+    console.log('1.4.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.3.3',
+        version: '1.4.0',
     });
     const apiClient = new TalkspressoClient();
     registerAppointmentTools(server, apiClient);

package/dist/setup.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { confirm, input, password as passwordPrompt } from '@inquirer/prompts';
+import { confirm, input, password as passwordPrompt, select } from '@inquirer/prompts';
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
 import { join } from 'path';
 import { homedir } from 'os';
@@ -49,23 +49,56 @@ 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`);
         process.exit(0);
     });
     const api = new SetupApiClient();
-    // Welcome
+    // ── 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
+    console.log(`  ${chalk.dim("Let's get you set up in a few minutes.")}\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:' });
@@ -81,7 +114,7 @@ export async function runSetup() {
             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`);
+                    console.log(`\n  ${chalk.red('Too many failed attempts.')} Reset your password at ${chalk.cyan('app.talkspresso.com')}\n`);
                     process.exit(1);
                 }
                 console.log(`  ${chalk.red('✗')} Invalid email or password. Try again.\n`);
@@ -89,10 +122,9 @@ export async function runSetup() {
         }
     }
     else {
-        // Registration flow
-        const name = await input({ message: 'Your name:' });
+        const name = await input({ message: 'Your full name:' });
         const email = await input({ message: 'Email:' });
-        const pw = await passwordPrompt({ message: 'Password (min 8 characters):' });
+        const pw = await passwordPrompt({ message: 'Create a password (min 8 characters):' });
         const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
         try {
             const user = await api.register({ name, email, password: pw, timezone });
@@ -125,20 +157,105 @@ export async function runSetup() {
             }
         }
     }
-    // Generate API key
+    // ── 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`);
+        console.log(`  ${chalk.green('✓')} API key created\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
+    // ── 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' },
+            ],
+        });
+        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`);
+        }
+        catch (err) {
+            console.log(`  ${chalk.yellow('!')} Could not create service: ${err.message}. You can create one later.\n`);
+        }
+    }
+    else if (serviceChoice !== 'skip') {
+        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`);
+        }
+    }
+    // ── 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`);
+            }
+        }
+    }
+    // ── Configure Claude Desktop ─────────────────────────
     const desktopPath = getClaudeDesktopConfigPath();
     const desktopDir = join(desktopPath, '..');
     let configuredDesktop = false;
@@ -160,7 +277,7 @@ export async function runSetup() {
             }
         }
     }
-    // Configure Claude Code
+    // ── Configure Claude Code ────────────────────────────
     const codePath = getClaudeCodeConfigPath();
     let configuredCode = false;
     const addCode = await confirm({ message: 'Add Talkspresso to Claude Code?' });
@@ -177,11 +294,17 @@ export async function runSetup() {
             console.log();
         }
     }
-    // Success
+    // ── 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`);
+    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 (configuredDesktop)
         done.push('Claude Desktop configured');
     if (configuredCode)
@@ -189,11 +312,15 @@ export async function runSetup() {
     for (const item of done) {
         console.log(`  ${chalk.green('✓')} ${item}`);
     }
-    console.log(`\n  ${chalk.bold('Next steps:')}\n`);
+    console.log(`\n  ${chalk.bold('What to do next:')}\n`);
     if (configuredDesktop || configuredCode) {
-        console.log(`  1. ${chalk.white('Restart Claude')} (if it\'s open)`);
+        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"`);
+    }
+    else {
+        console.log(`  1. ${chalk.white('Run')} ${chalk.cyan('npx @talkspresso/mcp-server --setup')} ${chalk.white('to connect to Claude')}`);
     }
-    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`);
+    console.log(`\n  ${chalk.dim('Need help? Ask Claude: "What can I do with Talkspresso?"')}\n`);
 }

package/package.json

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