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

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

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