PlayVideo MCP

Use MCP to automate video workflows and integrate PlayVideo into agents and tools.

Source: https://github.com/vascogaspar/blockbuster/tree/master/mcp

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.

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

Install the MCP server globally:

npm install -g @playvideo/playvideo-mcp

Or run without installing:

npx @playvideo/playvideo-mcp

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"
      }
    }
  }
}

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

Tool	Description
`list_collections`	List all video collections
`create_collection`	Create a new collection
`delete_collection`	Delete a collection and its videos
`list_videos`	List videos (filter by collection/status)
`get_video`	Get video details and URLs
`delete_video`	Delete a video
`get_upload_instructions`	Get upload commands
`list_webhooks`	List webhooks and available events
`get_webhook`	Get webhook details and deliveries
`create_webhook`	Create a webhook (returns secret once)
`update_webhook`	Update a webhook
`test_webhook`	Send test webhook event
`delete_webhook`	Delete a webhook
`get_embed_settings`	Get embed player settings
`update_embed_settings`	Update embed player settings
`sign_embed`	Generate signed embed URL/code
`list_api_keys`	List API keys
`create_api_key`	Create API key (returns key once)
`delete_api_key`	Delete API key
`get_account`	Get account settings
`update_account`	Update account settings
`get_usage`	Get usage stats and limits

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

Variable	Required	Description
`PLAYVIDEO_API_KEY`	Yes	Your PlayVideo API key
`PLAYVIDEO_URL`	No	API URL (default: https://api.playvideo.dev)

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