liveprompt-mcp-server

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

Features

• 🔐 Secure API Key Authentication
• 📊 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 - Built-in usage controls

Installation

npm install
npm run build

Configuration

1. Copy .env.example to .env
2. Add your Supabase credentials:

SUPABASE_URL=https://your-project.supabase.co
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key

Getting an API Key

1. Log in to liveprompt.ai
2. Navigate to Settings > Developer
3. Click "Generate API Key"
4. Save the key securely (it won't be shown again)

Usage

Running the Server

# Development mode
npm run dev

# Production mode
npm start

Connecting with MCP Client

Configure your MCP client (e.g., Claude Desktop) with:

{
  "mcpServers": {
    "liveprompt": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/server.js"],
      "env": {
        "SUPABASE_URL": "your-url",
        "SUPABASE_SERVICE_ROLE_KEY": "your-key"
      }
    }
  }
}

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

API keys can have the following permissions:

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

Rate Limits

Default rate limits:

• 60 requests per minute
• 1000 requests per hour

Custom limits can be configured per API key.

Example Client Usage

Python

from mcp import Client
import asyncio

async def main():
    client = Client()
    await client.connect_stdio("/path/to/mcp-server")
    
    # Initialize with API key
    await client.initialize(clientInfo={"apiKey": "lp_live_..."})
    
    # List sessions
    result = await client.call_tool("list_sessions", {
        "status": "completed",
        "limit": 10
    })
    print(result)

asyncio.run(main())

TypeScript

import { Client } from '@modelcontextprotocol/sdk/client';

const client = new Client();
await client.connectStdio('/path/to/mcp-server');

// Initialize with API key
await client.initialize({ 
  clientInfo: { apiKey: 'lp_live_...' } 
});

// List sessions
const result = await client.callTool('list_sessions', {
  status: 'completed',
  limit: 10
});

Security

• API keys are hashed using bcrypt
• All requests are authenticated and rate-limited
• RLS policies enforce data isolation
• Optional IP allowlisting available

Development

# Run tests
npm test

# Type checking
npm run typecheck

# Linting
npm run lint

Support

For issues or questions:

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

License

MIT