npm package: @liveprompt/mcp-server
Description: Model Context Protocol server for liveprompt.ai - Enable external applications to connect and access meeting data
Author: liveprompt.ai
Latest version: 2.0.13

# @liveprompt/mcp-server

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

## 🔒 Security & Privacy

- **Your data stays private** - Only accessible with your personal API key
- **Secure authentication** - All API keys are hashed with bcrypt
- **Rate limited** - Built-in protection against abuse
- **No embedded secrets** - This package contains no sensitive data

## Quick Start

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

### Step 1: Generate an API Key

1. Log in to [liveprompt.ai](https://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

```bash
npm install -g @liveprompt/mcp-server
```

### Step 3: Configure Claude Desktop

Add to your Claude Desktop configuration:

```json
{
  "mcpServers": {
    "liveprompt": {
      "command": "npx",
      "args": ["@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"


## 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](https://docs.liveprompt.ai/mcp)
- **GitHub Issues**: [github.com/liveprompt/mcp-server](https://github.com/liveprompt/mcp-server)
- **Email**: support@liveprompt.ai

## 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](https://liveprompt.ai) to get started.