liveprompt-mcp-server

Official Model Context Protocol (MCP) server for liveprompt.ai - Enable AI assistants to securely connect and access your meeting data, transcripts, and summaries.

🔒 Security Architecture

This MCP server uses a secure API key system:

• Users generate their own API keys from the liveprompt.ai dashboard
• Keys have specific permissions (read/write) and rate limits
• All keys are hashed with bcrypt - never stored in plain text
• No sensitive keys are embedded in this package

For Server Operators

If you're running your own liveprompt.ai instance, you'll need:

1. Your Supabase service role key
2. Your Supabase project URL

For End Users

To use this MCP server with your liveprompt.ai account:

Step 1: Generate an API Key

1. Log in to liveprompt.ai
2. Navigate to Settings → Developer
3. Click "Generate API Key"
4. Choose permissions (read/write)
5. Copy your key immediately (it won't be shown again!)

Step 2: Install the MCP Server

npm install -g @bharatgolchha/liveprompt-mcp-server

Step 3: Configure Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "liveprompt": {
      "command": "npx",
      "args": ["@bharatgolchha/liveprompt-mcp-server"],
      "env": {
        "LIVEPROMPT_API_KEY": "lp_live_YOUR_KEY_HERE"
      }
    }
  }
}

Location of config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Step 4: Restart Claude Desktop

Fully quit and restart Claude Desktop to load the new configuration.

Features

• 🔐 Secure API Key Authentication - User-generated keys with bcrypt hashing
• 📊 Session Management - List, create, and retrieve sessions
• 📝 Transcript Access - Get real-time transcripts
• 🤖 AI Integration - Access guidance and summaries
• 🔍 Search Capabilities - Find sessions and content
• 📈 Rate Limiting - 60 req/min, 1000 req/hour per key
• 🔒 Data Isolation - RLS policies ensure data privacy

Available Tools

Read Operations

• list_sessions - List conversation sessions with filters
• get_session - Get detailed session information
• get_transcript - Retrieve session transcript
• get_summary - Get AI-generated summary
• search_sessions - Search across sessions
• get_action_items - Extract action items

Write Operations (requires write permission)

• create_session - Create new session
• add_context - Add context to session
• share_meeting - Share meeting access

Available Resources

Resources are exposed as URIs:

• session://[id] - Session data
• transcript://[id] - Transcript content
• recording://[id] - Recording URLs
• summary://[id] - Session summaries

API Key Permissions

When generating an API key, you can choose:

• read - Access session data and transcripts
• write - Create and modify sessions
• admin - Full access including sharing

Rate Limits

Each API key has built-in rate limits:

• 60 requests per minute
• 1000 requests per hour

Example Usage in Claude

Once configured, you can ask Claude:

• "List my recent liveprompt sessions"
• "Search for sessions about 'project planning'"
• "Get the transcript from my last meeting"
• "Show me the action items from today's session"

For Developers

Running Your Own Instance

If you're hosting your own liveprompt.ai instance:

# Clone and install
git clone https://github.com/liveprompt/mcp-server
cd mcp-server
npm install

# Configure environment
cp .env.example .env
# Edit .env with your Supabase credentials

# Build and run
npm run build
npm start

Environment Variables

# Required for server operators
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key

# Optional for users (can use LIVEPROMPT_API_KEY instead)
LIVEPROMPT_API_KEY=lp_live_your_api_key

Testing

# Run tests
npm test

# Type checking
npm run typecheck

# Linting
npm run lint

Security Considerations

• API keys are shown only once - Store them securely
• Never share your API key - Treat it like a password
• Revoke compromised keys - Do this immediately from the dashboard
• Use read-only keys when possible - Minimize permissions
• Monitor usage - Check your dashboard for unusual activity

Troubleshooting

"Failed to connect to liveprompt"

• Verify your API key is correct
• Ensure you've restarted Claude Desktop completely
• Check that the key hasn't been revoked

"Invalid API key"

• Generate a new key from the dashboard
• Make sure you're using the full key (including lp_live_ prefix)

"Rate limit exceeded"

• Wait a minute and try again
• Consider upgrading your account for higher limits

Support

• Documentation: docs.liveprompt.ai/mcp
• GitHub Issues: github.com/liveprompt/mcp-server
• Email: [email protected]

License

MIT - See LICENSE file for details

Privacy & Data Security

• Your API key is never transmitted to our servers except for validation
• All data access is scoped to your account only
• We don't log or store your queries made through MCP
• Data transmission is encrypted with TLS

Note: This package requires a liveprompt.ai account. Sign up at liveprompt.ai to get started.