PlayVideo MCP Server

Model Context Protocol (MCP) server for PlayVideo API. Enables AI assistants like Claude to manage your videos directly.

What is MCP?

Model Context Protocol is an open protocol that allows AI assistants to interact with external tools and data sources. This MCP server lets Claude (and other MCP-compatible assistants) manage your PlayVideo videos.

Related MCP server: HeyGen MCP Server

Features

• Collections - List/create/delete collections

• Videos - List videos, get details, delete

• Webhooks - Create, test, update, and manage webhooks

• Embed settings - Read/update player settings and sign embeds

• API keys - List/create/delete API keys

• Account - Read/update account settings

• Usage - Monitor plan limits and quotas

• Upload instructions - Get curl/SDK commands for uploading

Installation

For Claude Desktop

1. Install the MCP server globally:

npm install -g @playvideo/playvideo-mcp

Or run without installing:

npx @playvideo/playvideo-mcp

2. Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "playvideo": {
      "command": "playvideo-mcp",
      "env": {
        "PLAYVIDEO_API_KEY": "play_live_your_api_key"
      }
    }
  }
}

3. Restart Claude Desktop

For Development

cd mcp
npm install
npm run build

Run locally:

PLAYVIDEO_API_KEY=play_live_xxx npm start

Usage Examples

Once configured, you can ask Claude things like:

• "List my video collections"

• "Create a new collection called 'Tutorials'"

• "Show me all completed videos"

• "Create a webhook for video.completed"

• "Update embed settings to autoplay and muted"

• "Generate a signed embed for video xyz123"

• "Create a new API key for production"

• "What's my current usage?"

• "Delete the video with ID xyz123"

• "How do I upload a video to the 'demos' collection?"

Available Tools

Resources

The server also provides documentation resources:

• playvideo://docs/quickstart - Quick start guide

• playvideo://docs/api - API reference

• playvideo://docs/sdks - SDK installation and examples

• playvideo://docs/webhooks - Webhook setup and verification

Environment Variables

Self-Hosted PlayVideo

If you're running a self-hosted PlayVideo instance:

{
  "mcpServers": {
    "playvideo": {
      "command": "playvideo-mcp",
      "env": {
        "PLAYVIDEO_API_KEY": "your-key",
        "PLAYVIDEO_URL": "https://video.yourdomain.com"
      }
    }
  }
}

Security

• API keys are never logged or exposed in responses

• All API calls go directly to PlayVideo servers

• No data is stored locally

License

MIT